Show:

Promise Class

Module: promise

简单使用

require(['promise'],function(Promise){
    var d = new Promise.Defer();
    var promise = d.promise;
    promise.then(function (v) {
        return v + 1;
    }).then(function (v) {
            alert(v); // => 2
        });
    d.resolve(1); // 该位置也可以放在 then 前面
});

Constructor

Promise

()

Returns:

promise 实例，外部不允许初始化。要通过Defer()来获取

  • Index
  • Methods

Item Index

Methods

Methods

all

(
  • objects
)
Promise static

返回一个新的 promise.当 objects 全部成功后新的 promise 成功，否以第一个 promise 的失败值为失败

Parameters:

  • objects Promise | Array

    promise或普通对象数组

    Returns:

    Promise:

    done

    (
    • fulfilled
    • [rejected]
    )

    当前 promise 实例已完成时注册一个 callback, 如果 promise fail, 则这下一个事件循环中抛出错误。

    Parameters:

    • fulfilled Function

      该 promise 成功时的回调，参数为 defer resolve 时的 value

    • [rejected] Function optional

      该 promise 失败时的回调，参数为 defer reject 时的 reason

    fail

    (
    • rejected
    )
    Promise

    监听当前实例的失败并返回新的 promise 实例.相当于调用 this.then(null,rejected)

    Parameters:

    • rejected Function

      该 promise 失败时的回调，参数为 defer reject 时的 reason

    Returns:

    Promise:

    一个新的 promise. 当前 promise 成功时新的 promise 也成功. 当前 promise 失败时新的 promise 也失败

    fin

    (
    • callback
    )
    Promise

    监听当前实例的成功和失败并返回新的 promise 实例

    Parameters:

    • callback Function

      该 promise 成功或失败时的回调， 成功时参数为 defer resolve 时的 value 和 true. 失败时参数为 defer reject 时的 reason 和 false

    Returns:

    Promise:

    一个新的 promise. 当前 promise 成功时新的 promise 也成功. 当前 promise 失败时新的 promise 也失败

    isPromise

    (
    • promise
    )
    Boolean static

    返回参数 promise 是否是 promise

    Parameters:

    • promise Object

      需要查询的对象

    Returns:

    Boolean:

    isRejected

    (
    • promise
    )
    Boolean static

    返回参数 promise 是否失败了

    Parameters:

    • promise Promise

      需要查询的promise实例

    Returns:

    Boolean:

    isRejected

    () Boolean

    返回当前 promise 是否失败了

    Returns:

    Boolean:

    isResolved

    () Boolean

    返回当前 promise 是否成功了

    Returns:

    Boolean:

    isResolved

    (
    • promise
    )
    Boolean static

    返回参数 promise 是否成功了

    Parameters:

    • promise Promise

      需要查询的promise实例

    Returns:

    Boolean:

    then

    (
    • fulfilled
    • [rejected]
    )
    Promise

    监听当前实例的成功和失败并返回新的 promise 实例

    Parameters:

    • fulfilled Function

      该 promise 成功时的回调，参数为 defer resolve 时的 value

    • [rejected] Function optional

      该 promise 失败时的回调，参数为 defer reject 时的 reason

    Returns:

    Promise:

    一个新的 promise. 当前 promise 成功时新的 promise 也成功. 当前 promise 失败时新的 promise 也失败

    when

    (
    • obj
    • fulfilled
    • rejected
    )
    Promise static

    返回一个新的 promise

    Parameters:

    • obj Object

      监听的对象.如果 obj 为 promise 类型，相当于 obj.then(fulfilled, rejected);否则直接调用 fulfilled(obj)，并返回一个成功的 promise

    • fulfilled Function
    • rejected Function

    Returns:

    Promise:

    @2010 - 2112 KISSY UI LIBARAY