Promiseオブジェクトの定義 | Promiseの基本 | JavaScript 超完全入門 基本から発展までのすべて

スポンサーリンク
スポンサーリンク
amazon
スマイルSALE
--:--:--
~
ad. 価格範囲を指定して商品を探せます

Promiseオブジェクトとは?

Promiseオブジェクトは、JavaScriptで非同期処理の結果を扱うための仕組みです。

非同期処理とは、通信処理やタイマー処理のように、結果が返ってくるまで時間がかかる処理のことです。Promiseを使うと、その処理が成功した場合と失敗した場合を分けて扱えます。

Promiseを利用することで、コールバック関数が深く入れ子になる「コールバック地獄」を避け、非同期処理を読みやすく管理できます。

Promiseオブジェクトの定義

Promiseオブジェクトは、new Promise()を使って作成できます。

Promiseの中では、処理が成功した場合にresolveを呼び出し、失敗した場合にrejectを呼び出します。

Promiseオブジェクトの基本的な構文


const promise = new Promise((resolve, reject) => {
    const success = true;

    if (success) {
        resolve("処理が成功しました");
    } else {
        reject("処理が失敗しました");
    }
});

この例では、successがtrueの場合はresolve()が呼び出され、Promiseは成功した状態になります。

反対に、successがfalseの場合はreject()が呼び出され、Promiseは失敗した状態になります。

Promiseの3つの状態

Promiseオブジェクトには、次の3つの状態があります。

状態 説明
pending 非同期処理がまだ完了していない状態。
fulfilled 非同期処理が成功し、resolve()が呼ばれた状態。
rejected 非同期処理が失敗し、reject()が呼ばれた状態。

Promiseは一度fulfilledまたはrejectedになると、その状態から変わりません。

Promiseの実行フロー

Promiseでは、then()、catch()、finally()を使って処理結果を受け取ります。

  • then():成功時の処理を書く。
  • catch():失敗時の処理を書く。
  • finally():成功・失敗に関係なく最後に実行する処理を書く。

Promiseの実行フローの例


const promise = new Promise((resolve, reject) => {
    setTimeout(() => {
        const success = true;

        if (success) {
            resolve("データ取得成功");
        } else {
            reject("データ取得失敗");
        }
    }, 2000);
});

promise
    .then((result) => {
        console.log(result);
    })
    .catch((error) => {
        console.error(error);
    })
    .finally(() => {
        console.log("処理が完了しました");
    });

この例では、2秒後に非同期処理が完了します。

resolve()が呼ばれた場合はthen()が実行され、reject()が呼ばれた場合はcatch()が実行されます。

finally()は成功・失敗に関係なく最後に実行されます。

Promiseの活用方法

Promiseは、複数の非同期処理を順番に実行したい場合にも利用できます。

then()をつなげることで、前の非同期処理が終わってから次の非同期処理を実行できます。

Promiseチェーンによる連続処理の例


function fetchData1() {
    return new Promise((resolve) => {
        setTimeout(() => {
            console.log("データ1取得完了");
            resolve();
        }, 1000);
    });
}

function fetchData2() {
    return new Promise((resolve) => {
        setTimeout(() => {
            console.log("データ2取得完了");
            resolve();
        }, 1000);
    });
}

fetchData1()
    .then(() => fetchData2())
    .then(() => {
        console.log("すべてのデータ取得完了");
    })
    .catch((error) => {
        console.error("エラーが発生しました:", error);
    });

この例では、fetchData1()が完了した後にfetchData2()が実行されます。

Promiseを返す関数をつなげることで、非同期処理を順番に実行できます。

Promise.allによる並行処理

複数の非同期処理を同時に実行したい場合は、Promise.all()を使います。


const promise1 = Promise.resolve("データ1");
const promise2 = Promise.resolve("データ2");

Promise.all([promise1, promise2])
    .then((results) => {
        console.log(results);
    })
    .catch((error) => {
        console.error(error);
    });

Promise.all()は、すべてのPromiseが成功した場合に結果を配列で返します。

ただし、1つでも失敗すると全体が失敗として扱われる点に注意が必要です。

async/awaitとの関係

現在のJavaScriptでは、Promiseをより読みやすく書くためにasync/awaitがよく使われます。

async/awaitはPromiseを内部的に利用しており、Promiseを理解しておくと非同期処理の仕組みをより深く理解できます。


async function run() {
    try {
        const result = await Promise.resolve("処理成功");
        console.log(result);
    } catch (error) {
        console.error(error);
    }
}

run();

awaitを使うと、Promiseの完了を待ってから次の処理へ進めます。

Promiseの利点と欠点

Promiseは非同期処理を扱いやすくする便利な仕組みですが、特徴を理解して使うことが大切です。

利点 欠点
コールバック地獄を避けやすい Promiseチェーンが長くなると読みにくくなることがある。
成功時と失敗時の処理を分けて書ける 非同期処理に慣れていないと理解に時間がかかる。
catch()でエラー処理をまとめやすい エラー処理を書き忘れると、失敗時の原因が分かりにくくなる。
Promise.all()などで複数処理を扱える 並行処理と順番に実行する処理の違いを意識する必要がある。

初心者が覚えておきたいポイント

  • Promiseは非同期処理の成功・失敗を扱うためのオブジェクトです。
  • resolve()は成功、reject()は失敗を表します。
  • then()で成功時の処理を書きます。
  • catch()で失敗時の処理を書きます。
  • finally()は成功・失敗に関係なく最後に実行されます。
  • 現在はasync/awaitと組み合わせて使うことが多いです。

まとめ

  • Promiseオブジェクトは、JavaScriptの非同期処理を管理するための仕組みである。
  • Promiseにはpending、fulfilled、rejectedの3つの状態がある。
  • resolve()が呼ばれると成功、reject()が呼ばれると失敗として扱われる。
  • then()、catch()、finally()を使って処理結果を扱える。
  • Promise.all()を使うと、複数の非同期処理を並行して実行できる。
  • 現在のJavaScriptでは、Promiseをもとにしたasync/awaitもよく利用される。