JavaScript 單執行緒、事件循環機制使非同步程式設計成為核心。早期依賴回調函數,導致「回調地獄」(Callback Hell):程式碼橫向無限縮進、錯誤處理分散、難以除錯。Promise(ES2015 標準化)提供統一的非同步抽象,讓非同步代碼像同步代碼一樣線性閱讀、組合、錯誤傳遞。
狀態只能從 Pending → Fulfilled 或 Pending → Rejected,且不可逆。一旦定案,後續 .then() 呼叫會立即獲得結果。
// 建立 Promise
const asyncTask = (arg) => new Promise((resolve, reject) => {
setTimeout(() => {
if (arg === 'fail') reject(new Error('失敗'));
else resolve(`結果: ${arg}`);
}, 1000);
});
// 消費 Promise
asyncTask('first')
.then(result => {
console.log(result); // 結果: first
return asyncTask('second'); // 返回新 Promise,串聯
})
.then(result => {
console.log(result); // 結果: second
return asyncTask('third');
})
.then(result => console.log(result))
.catch(err => console.error('捕獲錯誤:', err.message));
上一個完成才開始下一個(如上例)。
Promise.all([
fetch('/api/users'),
fetch('/api/posts'),
fetch('/api/comments')
]).then(([usersRes, postsRes, commentsRes]) => {
// 三個請求並行發送,總耗時 ≈ 最慢的那個
return Promise.all([
usersRes.json(),
postsRes.json(),
commentsRes.json()
]);
}).then(([users, posts, comments]) => {
console.log('資料整合完成');
});
Promise.race([
fetch('/api/primary'),
new Promise((_, reject) => setTimeout(() => reject(new Error('超時')), 3000))
]).then(res => console.log('主服務回應'))
.catch(err => console.log('降級或超時:', err.message));
Promise.allSettled([
fetch('/api/1'),
fetch('/api/2'),
fetch('/api/3')
]).then(results => {
results.forEach((r, i) => {
if (r.status === 'fulfilled') console.log(`API ${i+1} 成功`);
else console.log(`API ${i+1} 失敗:`, r.reason);
});
});
.catch() 等同 .then(null, onRejected)。.catch()。try/catch 一樣向上冒泡,直到被捕獲。.catch() 返回正常值(非 Promise),鏈路恢復 Fulfilled 狀態繼續向下。const fs = require('fs');
const readFile = (path) => new Promise((resolve, reject) => {
fs.readFile(path, 'utf8', (err, data) => err ? reject(err) : resolve(data));
});
// 使用
readFile('./package.json').then(JSON.parse).then(pkg => console.log(pkg.name));
const tasks = [() => fetch('/1'), () => fetch('/2'), () => fetch('/3')];
tasks.reduce((promise, task) => promise.then(task), Promise.resolve())
.then(lastResult => console.log('全部完成'));
async function limitedConcurrency(tasks, limit) {
const results = [];
const executing = [];
for (const task of tasks) {
const p = task().then(res => {
results.push(res);
return res;
});
executing.push(p);
if (executing.length >= limit) {
await Promise.race(executing);
// 移除已完成的
const idx = executing.findIndex(p => p === Promise.race(executing));
// 實際應用建議使用 p-limit 等成熟庫
}
}
return Promise.all(executing).then(() => results);
}
return:.then() 回調若返回 Promise,必須 return,否則鏈路斷裂。.then() 中拋出非 Error 物件:建議統一拋出 Error 實例,利於堆疊追蹤。process.on('unhandledRejection')。Promise.resolve().then(...) 當作 setImmediate:微任務隊列優先級高於宏任務,可能導致飢餓。ES2017 引入 async/await,讓 Promise 代碼更接近同步寫法:
async function fetchUserData(userId) {
try {
const user = await fetch(`/api/users/${userId}`).then(r => r.json());
const posts = await fetch(`/api/users/${userId}/posts`).then(r => r.json());
return { user, posts };
} catch (err) {
console.error('獲取失敗:', err);
throw err; // 重新拋出,讓調用者決定如何處理
}
}
async 函數永遠返回 Promise,await 只能在 async 函數中使用(頂層 await 需模組環境)。
Promise 是現代 JavaScript 非同步程式設計的基石。掌握狀態機制、鏈式組合、並行控制、錯誤傳遞與 async/await 語法糖,能讓你寫出可讀、可維護、可擴展的非同步代碼,徹底告別回調地獄。