JSPM

  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 17162
  • Score
    100M100P100Q138666F
  • License MIT

Simple http(s) request function, returning a promise.

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

view on npm npm module downloads Dependency 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.

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.