萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

JavaScript Promise 完整指南:從回調地獄到鏈式非同步控制流

前言:為什麼需要 Promise?

JavaScript 單執行緒、事件循環機制使非同步程式設計成為核心。早期依賴回調函數,導致「回調地獄」(Callback Hell):程式碼橫向無限縮進、錯誤處理分散、難以除錯。Promise(ES2015 標準化)提供統一的非同步抽象,讓非同步代碼像同步代碼一樣線性閱讀、組合、錯誤傳遞。

Promise 核心概念

三種狀態

  • Pending(待定):初始狀態,非同步操作進行中。
  • Fulfilled/Resolved(已完成):操作成功,擁有結果值。
  • Rejected(已拒絕):操作失敗,擁有拒絕原因(通常是 Error 物件)。

狀態只能從 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 組合模式

串行:依序執行

上一個完成才開始下一個(如上例)。

並行:同時執行,等待全部完成

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)。
  • 拋出錯誤或返回 Rejected Promise 會觸發最近的 .catch()。
  • 錯誤會像同步代碼的 try/catch 一樣向上冒泡,直到被捕獲。
  • 若 .catch() 返回正常值(非 Promise),鏈路恢復 Fulfilled 狀態繼續向下。

進階模式

Promise 化現有回調 API

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 實例,利於堆疊追蹤。
  • 未處理的 Rejection:Node.js 會發出警告,生產環境務必全域監聽 process.on('unhandledRejection')。
  • 避免 Promise.resolve().then(...) 當作 setImmediate:微任務隊列優先級高於宏任務,可能導致飢餓。

現代語法糖:async/await

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 語法糖,能讓你寫出可讀、可維護、可擴展的非同步代碼,徹底告別回調地獄。

copyright © 萬盛學電腦網 all rights reserved