What is Promise.pending()?

No idea what the following example extracted from the doc means:

function applicationFunction(arg1) {
    var deferred = Promise.pending(); //Or Q.defer() in Q
    libraryFunction(arg1, function (err, value) {
        if (err) {
            deferred.reject(err);
        } else {
            deferred.fulfill(value);
        }
    });
    return deferred.promise;
}

• What is Promise.pending()? what does it return? It seems it returns:

{ promise:
   Promise {
     _bitField: 0,
     _fulfillmentHandler0: undefined,
     _rejectionHandler0: undefined,
     _promise0: undefined,
     _receiver0: undefined },
  resolve: [Function: deferResolve],
  reject: [Function: deferReject] }

but that is not documented.

[cchamberlain]

Looks like wiki has dupe information that needs updating - https://github.com/petkaantonov/bluebird/wiki/Promise-anti-patterns

[petkaantonov]

pushed