control-freak-ide/Control-Freak-Documentation/jQuery/docs/entries/deferred.reject.json

{"name":"deferred.reject","type":"method","title":"deferred.reject()","deprecated":null,"removed":null,"desc":" Reject a Deferred object and call any failCallbacks with the given <code>args</code>. ","categories":["deferred-object","version/1.5"],"entries":[{"return":"Deferred","signatures":{"added":"1.5","argument":{"desc":"\n        Optional arguments that are passed to the failCallbacks.\n      ","name":"args","type":"Anything","optional":"true"}},"examples":null,"longdesc":"\n    <p>Normally, only the creator of a Deferred should call this method; you can prevent other code from changing the Deferred's state by returning a restricted Promise object through <a href=\"/deferred.promise/\"><code>deferred.promise()</code></a>.</p>\n    <p>When the Deferred is rejected, any failCallbacks added by <a href=\"/deferred.then/\"><code>deferred.then()</code></a> or <a href=\"/deferred.fail/\"><code>deferred.fail()</code></a> are called. Callbacks are executed in the order they were added. Each callback is passed the <code>args</code> from the <code>deferred.reject()</code> call. Any failCallbacks added after the Deferred enters the rejected state are executed immediately when they are added, using the arguments that were passed to the <code>deferred.reject()</code> call. For more information, see the documentation for <a href=\"/jQuery.Deferred/\">jQuery.Deferred()</a>.</p>\n  "}]}