async-request

1.2.0 • Public • Published

async-request

NPM version Travis build status Dependency Status

async-request is a wrapper for request that uses ES7 async functions.

Usage

let request = require('async-request'),
    response;
 
try {
    response = await request('http://gajus.com/');
 
    // response.statusCode
    // response.headers
    // response.body
 
    await request('http://gajus.com', {
        // This example demonstrates all of the supported options.
        // Request method (uppercase): POST, DELETE, ...
        method: 'POST',
        data: {
            foo: 'bar'
        },
        headers: {
            foo: 'bar'
        },
        proxy: 'http://127.0.0.1:8000',
        // To create a new cookie jar.
        cookieJar: true,
        // To use a custom/existing cookie jar.
        // https://www.npmjs.com/package/tough-cookie
        cookieJar: new tough.CookieJar()
    });
} catch (e) {
 
}
 
// Returns a wrapper for the request using predefined custom options.
request = request.defaults({headers: {foo: 'bar'}});
 
// Returns the current default options.
request.defaults();
// {foo: 'bar'}
 
// Makes a HTTP GET request with {foo: 'bar'} headers.
await request('http://gajus.com');

Debugging

async-request does not provide (expose) inbuilt debugging capabilities. Use a proxy (e.g. https://mitmproxy.org/) to intercept and analyze HTTP traffic.

API

Running

Async function behavior has been accepted into stage 1 ("Proposal") of the ECMASCript 7 spec process in January 2014. This means that it cannot be used out of the box with node.js or iojs without a transpiler.

This library is using Babel to compile ES7 code into ES5. Refer to the ./gulpfile.js.

Beware

This library has been created as part of ES7 async function proposal research. It covers basic use of request. I do not advise to use it in production, though I will be testing it in several private projects and update as I go – contributions are welcome too.

Dependents (26)

Package Sidebar

Install

npm i async-request

Weekly Downloads

4,934

Version

1.2.0

License

BSD-3-Clause

Last publish

Collaborators

  • gajus