Package Exports
- req-then
This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (req-then) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.
Readme
req-then
Wraps node's built-in http(s) request
function with a few extras:
- Returns a promise, resolving to an object containing the data, node response and original request.
- Automatically selects
http
orhttps
transport depending on the input URL. - Cancellable (which
fetch
is not).
Example
const request = require('req-then')
request('http://www.bbc.co.uk')
.then(response => {
console.log('Response data received', response.data)
console.log('The original request options', response.req)
console.log('The nodejs response instance', response.res)
})
.catch(console.error)
Example
const request = require('req-then')
const url = require('url')
const reqOptions = url.parse('http://www.bbc.co.uk')
const controller = {}
reqOptions.controller = controller
request(reqOptions)
.then(response => {
console.log('Response data received', response.data)
})
// kill the request and close the socket
controller.abort()
request(reqOptions, [data]) ⇒ external:Promise
⏏
Returns a promise for the response.
Kind: Exported function
Resolve: object
- res
will be the node response object, data
will be the data, req
the original request.
Reject: Error
- If aborted, the name
property of the error will be aborted
.
Param | Type | Description |
---|---|---|
reqOptions | string | object |
Target url string or a standard node.js http request options object. |
[reqOptions.controller] | object |
If supplied, an .abort() method will be created on it which, if invoked, will cancel the request. Cancelling will cause the returned promise to reject with an 'aborted' error. |
[data] | * |
Data to send with the request. |
© 2015-17 Lloyd Brookes <75pound@gmail.com>. Documented by jsdoc-to-markdown.