# deferred.reject()

所属分类：延迟对象 英文文档：deferred.reject()

## deferred.reject( args )返回: Deferred

描述: 拒绝Deferred（延迟）对象，并根据给定的`args`参数调用任何失败回调函数（failCallbacks）。

- #### 添加的版本: 1.5deferred.reject( args )

  - args
    类型: Object
    传递给失败回调函数（failCallbacks）的可选的参数。

通常只有延迟对象的创建者才可以调用该方法。你可以通过调用 `deferred.promise()`，返回一个受限的 Promise 对象，来阻止其它代码改变延迟对象的状态或报告它的状态。

当延迟对象被 rejected 时，任何通过 `deferred.then`或`deferred.fail` 添加的 failCallbacks，都会被调用。回调函数的执行顺序和它们被添加的顺序是一样的。传递给 `deferred.reject()` 的 `args` 参数，会传给每个回调函数。当延迟对象进入 rejected 状态后，再添加的任何 failCallbacks，当它们被添加时，就会被立刻执行，并带上传入给 `.reject()` 的参数。有关详细信息，请参阅文件Deferred object 。