Promise A+ 中文翻译-白红宇

Promise A+ 中文翻译

阅读量：6262 次

发布时间：2019-06-22

本文共 4568 字，大约阅读时间需要 15 分钟。

Try to translate Promise A+ into Chinese 欢迎指正！

English version:

图片描述

这是实施者为实施者提供的开源健全可互操作的JavaScript Promise 规范。

Promise代表着异步操作的最终结果。与promise进行交互的主要方式是通过then方法，

该方法通过注册回调以接收promise的最终值或promise未完成的原因。

该规范详细说明了then方法的行为，它可以依赖所有符合Promises / A +的promise实现来提供可互操作的基础库。因此，可以认为规范非常稳定。尽管Promises / A +组织可能偶尔会修

改此规范，并采用较小的向后兼容的更改来解决新发现的极端情况。但只有经过仔细考虑，讨论和测试后，

我们才会集成大型或向后不兼容的更改。

从历史上看，Promises / A +澄清了早期提案的行为条款，

将其扩展到涵盖事实上的行为并省略了未指明或有问题的部分。

最后，核心Promises / A +规范没有涉及如何创建，实现或拒绝（create, fulfill, or reject ） promises，而是选择专注于提供可交互操作的then方法。

配套规范中的未来工作可能涉及这些主题。

1. 术语

1.1 "promise"是具有then方法的对象或函数，其行为符合此规范。

1.2 "thenable"是定义then方法的对象或函数。

1.3 "value"是任意合法的Javascript值，（包括undefined,thenable, promise）

1.4 "exception"是使用throw语句抛出的值

1.5 "reason"是表示promise为什么被rejected的值

2. 要求

2.1 Promise状态

一个promise必须处于三种状态之一：请求态（pending），完成态（fulfilled），拒绝态（rejected）

2.1.1 当promise处于请求状态（pending）时

2.1.1.1 promise可以转为fulfilled或rejected状态

2.1.2 当promise处于完成状态（fulfilled）时

2.1.2.1 promise不能转为任何其他状态

2.1.2.2 必须有一个值，且此值不能改变

2.1.3 当promise处于拒绝状态（rejected）时

2.1.3.1 promise不能转为任何其他状态

2.1.3.2 必须有一个原因（reason），且此原因不能改变

2.2 `then`方法

promise必须提供then方法来存取它当前或最终的值或者原因。

promise的then方法接收两个参数：

promise.then(onFulfilled, onRejected)

2.2.1 `onFulfilled`和`onRejected`都是可选的参数：

2.2.1.1 如果 onFulfilled不是函数，必须忽略

2.2.1.1 如果 onRejected不是函数，必须忽略

2.2.2 如果`onFulfilled`是函数:

2.2.2.1 此函数必须在promise 完成(fulfilled)后被调用,并把promise 的值作为它的第一个参数

2.2.2.2 此函数在promise完成(fulfilled)之前绝对不能被调用

2.2.2.2 此函数绝对不能被调用超过一次

2.2.3 如果`onRejected`是函数:

2.2.2.1 此函数必须在promise rejected后被调用,并把promise 的reason作为它的第一个参数

2.2.2.2 此函数在promise rejected之前绝对不能被调用

2.2.2.2 此函数绝对不能被调用超过一次

2.2.4 在执行上下文堆栈（）仅包含平台代码之前，不得调用 `onFulfilled`和`onRejected`

2.2.5 `onFulfilled`和`onRejected`必须被当做函数调用(i.e. with no this value-->这里不会翻......).

2.2.6 `then`可以在同一个promise里被多次调用

2.2.6.1 如果/当 promise 完成执行（fulfilled）,各个相应的onFulfilled回调

必须根据最原始的then 顺序来调用

2.2.6.2 如果/当 promise 被拒绝（rejected）,各个相应的onRejected回调

必须根据最原始的then 顺序来调用

2.2.7 `then`必须返回一个promise

promise2 = promise1.then(onFulfilled, onRejected);

2.2.7.1 如果onFulfilled或onRejected返回一个值x, 运行
Promise Resolution Procedure [[Resolve]](promise2, x)

2.2.7.2 如果onFulfilled或onRejected抛出一个异常e,promise2

必须被拒绝（rejected）并把e当作原因

2.2.7.3 如果onFulfilled不是一个方法，并且promise1已经完成（fulfilled）,
promise2必须使用与promise1相同的值来完成（fulfiled）

2.2.7.4 如果onRejected不是一个方法，并且promise1已经被拒绝（rejected）,
promise2必须使用与promise1相同的原因来拒绝（rejected）

<h3 id=23> 2.3 Promise解决程序</h3>

promise解析过程 是一个抽象操作，它将promise和value作为输入，我们将其表示为[[Resolve]]（promise，x）。

如果x是thenable的，假设x的行为至少有点像promise，

它会尝试让promise采用x的状态。不然就会用x来完成promise

只要它们公开一个Promises / A +兼容的方法，对thenables的这种处理允许promise实现进行互操作，

它还允许Promises / A +实现使用合理的then方法“同化”不一致的实现。

运行[[Resolve]](promise, x),执行以下步骤：

2.3.1 如果`promise`和`x`引用同一个对象，则用`TypeError`作为原因拒绝（reject）`promise`。

2.3.2 如果`x`是一个promise,采用promise的状态

2.3.2.1 如果x是请求状态(pending),promise必须保持pending直到xfulfilled或rejected

2.3.2.2 如果x是完成态(fulfilled)，用相同的值完成fulfillpromise

2.3.2.2 如果x是拒绝态(rejected)，用相同的原因rejectpromise

2.3.3另外，如果`x`是个对象或者方法

2.3.3.1 让x作为x.then.

2.3.3.2 如果取回的x.then属性的结果为一个异常e,用e作为原因reject promise

2.3.3.3 如果then是一个方法，把x当作this来调用它，

第一个参数为 resolvePromise，第二个参数为rejectPromise,其中:

+ 2.3.3.3.1  如果/当 resolvePromise被一个值y调用，运行 [[Resolve]](promise, y)    + 2.3.3.3.2  如果/当 rejectPromise被一个原因r调用，用r拒绝（reject）promise    + 2.3.3.3.3  如果resolvePromise和 rejectPromise都被调用，或者对同一个参数进行多次调用，第一次调用执行，任何进一步的调用都被忽略    + 2.3.3.3.4  如果调用then抛出一个异常e,        - 2.3.3.3.4.1 如果resolvePromise或 rejectPromise已被调用，忽略。        - 2.3.3.3.4.2 或者， 用e作为reason拒绝（reject）promise