Promise.prototype.done方法详解 - 深入理解Promise错误处理机制

2025-06-28 15:10:26作者：平淮齐Percy

什么是Promise.prototype.done？

在Promise的生态系统中，Promise.prototype.done是一个有趣且实用的扩展方法。虽然它不是ES6 Promise标准的一部分，但许多第三方Promise库都实现了这个方法。done方法与标准的then方法类似，但有一个关键区别：它不会返回新的Promise对象，而是直接将异常抛出到Promise链之外。

done方法的核心特点

不返回Promise对象：这意味着在done之后不能再链式调用其他Promise方法
直接抛出异常：在done中发生的错误不会被Promise内部捕获，而是直接抛出到外部

为什么需要done方法？

Promise错误处理的局限性

Promise虽然提供了强大的错误处理机制，但这种机制有时会成为调试的障碍。考虑以下情况：

function JSONPromise(json) {
    return new Promise(function(resolve) {
        resolve(JSON.parse(json));
    });
}

var string = "非合法json字符串";
JSONPromise(string).then(function(object) {
    console.log(object);
}); // 这里忘记了catch处理

在这种情况下，错误会被Promise内部消化，开发者可能很难发现这个未处理的错误。这就是所谓的"unhandled rejection"问题。

done的解决方案

done方法通过以下方式解决了这个问题：

强制要求错误处理：如果链中有错误且未被捕获，done会直接抛出
明确终止Promise链：作为方法链的最后一步，明确表示处理结束

done与then的对比示例

// 使用then的示例
Promise.resolve()
    .then(function() {
        JSON.parse("非JSON字符串");
    })
    .catch(function(error) {
        console.error(error); // 错误被捕获
    });

// 使用done的示例
Promise.resolve()
    .done(function() {
        JSON.parse("非JSON字符串"); // 错误会直接抛出
    });

实现原理剖析

让我们看看如何实现一个简单的Promise.prototype.done：

if (typeof Promise.prototype.done === 'undefined') {
    Promise.prototype.done = function(onFulfilled, onRejected) {
        this.then(onFulfilled, onRejected).catch(function(error) {
            setTimeout(function() {
                throw error;
            }, 0);
        });
    };
}