0.6.4 • Published 7 years ago

req-then v0.6.4

Weekly downloads
6,188
License
MIT
Repository
github
Last release
7 years ago

view on npm npm module downloads Dependency Status Coverage Status js-standard-style

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 or https 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.

ParamTypeDescription
reqOptionsstring | objectTarget url string or a standard node.js http request options object.
reqOptions.controllerobjectIf 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.

0.6.4

7 years ago

0.6.3

7 years ago

0.6.2

7 years ago

0.6.1

7 years ago

0.6.0

7 years ago

0.5.1

7 years ago

0.5.0

8 years ago

0.4.1

8 years ago

0.4.0

8 years ago

0.3.4

8 years ago

0.3.3

8 years ago

0.3.2

8 years ago

0.3.1

8 years ago

0.3.0

8 years ago

0.2.4

8 years ago

0.2.3

8 years ago

0.2.2

9 years ago

0.2.1

9 years ago

0.2.0

9 years ago