npm

Don't miss out on this year's npm Pride t-shirt designs!Order your favorites here »

bees-request

1.1.6 • Public • Published

bees-request npm version

A promise based simple abortable http client for node and browsers. bees-request uses the http or https modules on node and the XMLHttpRequest on browsers and React Native.

Installation

NPM:

npm install bees-request

CDN:

<script src="https://unpkg.com/bees-request/umd/bees-request.min.js"></script>

Usage

beesRequest.fetch(url[, options][, callback])
beesRequest.fetch(options)

options object has the following proprties:

  • url: the url for the request. If the url is specified as a fetch argument it overwrites the value in the options object if present
  • method: the method for the request. Default: GET
  • data: optional data to be appended to the querystring (GET) or sent in the request body (POST)
  • headers: optional key/value to be added to the request HTTP headers
  • timeout: optional timeout for the request (in milliseconds)
  • callback: an optional function to be called when the request is sent. If the callback is specified as a fetch argument it overwrites the value in the options object

Basic GET request:

 
beesRequest.fetch('http://example.com/api')
  .then(function(response) {
    // response is an instance of beesResponse object
    // it has the following methods:
    // response.json() returns a json object 
    // response.text() returns the plain text object
    // response.toString() alias to .text()
    console.log(response.text())
  })
  .catch(function(error) {
    // error is an instance of beesError
    // it has the following properties:
    // error.message
    // error.code
    // error.isAborted - an error is raised when the request is aborted
    console.log(error.message);
  });

POST Request with data:

  
beesRequest.fetch({
  url: 'http://example.com/api',
  method: 'POST', 
  data: { 
    id: 1234
  }
})
  .then(function(response) {
    console.log(response.text())
  })
  .catch(function(error) {
    console.error(error.message)
  });

Abort example:

var request = null;
 
beesRequest.fetch({
  url: 'http://example.com/api',
  callback: function(req) {
    request = req
  }
})
  .then(function(response) {
      console.log(response.text())
  })
  .catch(function(error) {
    if(error.isAborted) {
      // the request has been aborted
    } else {
      console.error(error.message)
    }
  });
 
request.abort();

Aliases:

beesRequest.get(url[, options][, callback]) // equivalent to fetch(url, options, callback) with options.method = 'GET'
beesRequest.get(options) // equivalent to fetch(url, options, callback) with options.method = 'GET'
 
beesRequest.post(url[, options][, callback]) // equivalent to fetch(url, options, callback) with options.method = 'POST'
beesRequest.post(options) // equivalent to fetch(url, options, callback) with options.method = 'POST'

install

npm i bees-request

Downloadsweekly downloads

76

version

1.1.6

license

MIT

homepage

github.com

repository

Gitgithub

last publish

collaborators

  • avatar
Report a vulnerability