request-promise-core

Previousrepeat-string Nextrequest-promise-native

Last updated 3 years ago

Was this helpful?

request-promise-core

This package is the core for the following packages:

request-promise-core contains the core logic to add Promise support to .

Please use one of the libraries above. It is only recommended to use this library directly, if you have very specific requirements.

Installation for `request@^2.34`

This module is installed via npm:

npm install --save request
npm install --save request-promise-core

request is defined as a peer-dependency and thus has to be installed separately.

Usage for `request@^2.34`

// 1. Load the request library

// Only use a direct require if you are 100% sure that:
// - Your project does not use request directly. That is without the Promise capabilities by calling require('request').
// - Any of the installed libraries use request.
// ...because Request's prototype will be patched in step 2.
/* var request = require('request'); */

// Instead use:
var stealthyRequire = require('stealthy-require');
var request = stealthyRequire(require.cache, function () {
    return require('request');
});


// 2. Add Promise support to request

var configure = require('request-promise-core/configure/request2');

configure({
    request: request,
	// Pass your favorite ES6-compatible promise implementation
    PromiseImpl: Promise,
	// Expose all methods of the promise instance you want to call on the request(...) call
    expose: [
        'then',   // Allows to use request(...).then(...)
        'catch',  // Allows to use request(...).catch(...)
        'promise' // Allows to use request(...).promise() which returns the promise instance
    ],
    // Optional: Pass a callback that is called within the Promise constructor
    constructorMixin: function (resolve, reject) {
        // `this` is the request object
        // Additional arguments may be passed depending on the PromiseImpl used
    }
});


// 3. Use request with its promise capabilities

// E.g. crawl a web page:
request('http://www.google.com')
    .then(function (htmlString) {
        // Process html...
    })
    .catch(function (err) {
        // Crawling failed...
    });

Installation and Usage for `request@next`

Contributing

To set up your development environment:

clone the repo to your desktop,
in the shell cd to the main folder,
hit npm install,
hit npm install gulp -g if you haven't installed gulp globally yet, and
run gulp dev. (Or run node ./node_modules/.bin/gulp dev if you don't want to install gulp globally.)

gulp dev watches all source files and if you save some changes it will lint the code and execute all tests. The test coverage report can be viewed from ./coverage/lcov-report/index.html.

If you want to debug a test you should use gulp test-without-coverage to run all tests without obscuring the code by the test coverage instrumentation.

Change History

1.1.4 (2020-07-21)
1.1.3 (2019-11-03)
1.1.2 (2019-02-14)
1.1.1 (2016-08-08)
1.1.0 (2016-07-30)
1.0.0 (2016-07-15)
- All tests green, ready for prime time
1.0.0-rc.1 (2016-07-10)
- Reimplementation of core logic based on request-promise@3.0.0