async-request
Deprecated
---
async-request is a wrapper for [request](https://www.npmjs.com/package/request) that uses [ES7 async functions](https://github.com/lukehoban/ecmascript-asyncawait).
## Usage
```js
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
* Make sure API is based on https://fetch.spec.whatwg.org/ standard.
## 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](https://babeljs.io/) to compile ES7 code into ES5. Refer to the [./gulpfile.js](./gulpfile.js).
## Beware
This library has been created as part of [ES7 async function](https://github.com/lukehoban/ecmascript-asyncawait) proposal research. It covers basic use of [request](https://www.npmjs.com/package/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.