mirror of
https://github.com/the-djmaze/snappymail.git
synced 2025-01-09 00:08:18 +08:00
27 lines
1.2 KiB
Markdown
27 lines
1.2 KiB
Markdown
|
|
||
|
This API varies from Tyler Closes ref_send in the
|
||
|
following ways:
|
||
|
|
||
|
* Promises can be resolved to function values.
|
||
|
* Promises can be resolved to null or undefined.
|
||
|
* Promises are distinguishable from arbitrary functions.
|
||
|
* The promise API is abstracted with a Promise constructor
|
||
|
that accepts a descriptor that receives all of the
|
||
|
messages forwarded to that promise and handles the
|
||
|
common patterns for message receivers. The promise
|
||
|
constructor also takes optional fallback and valueOf
|
||
|
methods which handle the cases for missing handlers on
|
||
|
the descriptor (rejection by default) and the valueOf
|
||
|
call (which returns the promise itself by default)
|
||
|
* near(ref) has been changed to Promise.valueOf() in
|
||
|
keeping with JavaScript's existing Object.valueOf().
|
||
|
* post(promise, name, args) has been altered to a variadic
|
||
|
post(promise, name ...args)
|
||
|
* variadic arguments are used internally where
|
||
|
applicable. However, I have not altered the Q.post()
|
||
|
API to expand variadic arguments since Tyler Close
|
||
|
informed the CommonJS list that it would restrict
|
||
|
usage patterns for web_send, posting arbitrary JSON
|
||
|
objects as the "arguments" over HTTP.
|
||
|
|