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もよく利用される。