diff options
| -rw-r--r-- | files/zh-cn/web/javascript/reference/global_objects/promise/promise/index.html | 52 |
1 files changed, 51 insertions, 1 deletions
diff --git a/files/zh-cn/web/javascript/reference/global_objects/promise/promise/index.html b/files/zh-cn/web/javascript/reference/global_objects/promise/promise/index.html index 1f4a6d5762..a81af18ffe 100644 --- a/files/zh-cn/web/javascript/reference/global_objects/promise/promise/index.html +++ b/files/zh-cn/web/javascript/reference/global_objects/promise/promise/index.html @@ -17,9 +17,59 @@ translation_of: Web/JavaScript/Reference/Global_Objects/Promise/Promise <dl> <dt><code>executor</code></dt> - <dd>这是一个双参函数，参数为<code>resolve和reject</code>。<code>Promise</code>的实现会立即执行<code>executor</code>，并传入<code>resolve和reject</code>函数（<code>Promise</code>构造器将会在返回新对象之前<code>executor</code>）。当<code>resolve</code>和<code>reject</code>函数被调用时，它们分别对promise执行<code>resolve</code>和<code>reject</code>。<code>executor</code>通常会触发一些异步运算，一旦运算成功完成，则<code>resolve</code>掉这个promise，如果出错则<code>reject</code>掉。如果<code>executor</code>函数执行时抛出异常，promise状态会变为<code>rejected</code>。<code>executor</code>的返回值也会被忽略。</dd> + <dd> + <p>该函数将在构造这个新<code>Promise</code>对象过程中，被构造函数执行。该<code>executor</code>是一段将输出与promise联系起来的自定义代码。<code>executor</code>的函数签名应为：</p> + <pre class="brush: js;">function(resolutionFunc, rejectionFunc){ + // 通常是一些异步操作 + } + </pre> + <p> + <code>resolutionFunc</code>与<code>rejectionFunc</code>也是函数，可以使用任何名字。这两个函数的签名很简单：接受任何类型的单个参数。 + </p> + <pre class="brush: js;"> + resolutionFunc(value) // 当被敲定时调用 + rejectionFunc(reason) // 当被拒绝时调用 + </pre> + <p> + 当该promise动态插入<a href="/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Promise#promise%E7%9A%84%E9%93%BE%E5%BC%8F%E8%B0%83%E7%94%A8">promise链</a>的情况下，该<code>resolutionFunc</code>的<code>value</code>参数可能是另一个promise对象。 + </p> + <p> + 关于<code>executor</code>，需理解以下几点： + </p> + <ul> + <li>该<code>executor</code>的返回值将被忽略。</li> + <li>如果在该<code>executor</code>中抛出一个错误，该promise将被拒绝。</li> + </ul> + <p> + 因此，<code>executor</code>的代码生效的原理如下： + </p> + <ul> + <li>在构造函数生成新<code>Promise</code>对象时，构造函数也生成了一对相关的函数<code>resolutionFunc</code>与<code>rejectionFunc</code>。他们被绑定在了<code>Promise</code>对象上。</li> + <li><code>executor</code>内的代码有机会执行一些操作，然后通过分别调用<code>resolutionFunc</code>或者<code>rejectionFunc</code>，反应这些操作的结果（如果这些结果不是另一个<code>Promise</code>对象的话），要么为已敲定（resolved），要么为已拒绝（rejected）。</li> + <li>换句话说，<code>executor</code>中的代码通过<code>resolutionFunc</code>或<code>rejectionFunc</code>产生的副作用进行通信。这里的副作用是指<code>Promise</code>对象变成已敲定（resolved），要么为已拒绝（rejected）。</li> + </ul> + <p> + 综上所述，对典型流程进行总结： + </p> + <ol> + <li><code>executor</code>内的操作是异步的，并且提供一个回调（callback）。</li> + <li>该回调在<code>executor</code>内定义。</li> + <li>该回调通过调用<code>resolutionFunc</code>终止。</li> + <li><code>resolutionFunc</code>的调用包含一个<code>value</code>参数。</li> + <li>该<code>value</code>被返回给绑定的<code>Promise</code>对象上。</li> + <li>该<code>Promise</code>对象（异步地）调用任何相关的<code>.then(handleResolved)</code>。</li> + <li><code>.then(handleResolved)</code>收到的<code>value</code>作为入参被传递给了<code>handleResolved</code>的调用。（参见<a href="/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Promise#promise%E7%9A%84%E9%93%BE%E5%BC%8F%E8%B0%83%E7%94%A8">Promise的链式调用</a>）</li> + </ol> +</dd> </dl> +<h3 id="返回值">返回值</h3> +<div> + <p> + 当通过<code>new</code>调用时，<code>Promise</code>构造函数返回一个promise对象。当<code>resolutionFunc</code>或者<code>rejectionFunc</code>被调用时，该promise对象将会“被敲定”。注意，如果您调用<code>resolutionFunc</code>或者<code>rejectionFunc</code>时将另一个Promise对象作为参数，您可以称其“被敲定（resolved）”，但仍不能称其“被解决（settled）”。 + </p> +</div> + <h2 id="例子">例子</h2> <p>我们通过<code>new</code>关键字和<code>Promise</code>构造器创建它的对象。这个构造器接受一个名为"executor function"的函数。这个函数应当接受两个函数参数。当异步任务成功时，第一个函数（<code>resolve</code>）将被调用，并返回一个值代表成功。当其失败时，第二个函数（<code>reject</code>）将被调用，并返回失败原因（失败原因通常是一个error对象）。</p> |