regrest

Regrest - Micro HTTP client

Micro Promise based HTTP client for the browser and node.js

Features

• Make XMLHttpRequests from the browser

• Make http requests from node.js

• Supports the Promise API

• Built in TypeScript support

Browser Support

Latest ✔	Latest ✔	Latest ✔	Latest ✔	Latest ✔	11 ✔

NOTE

If you intend to support Internet Explorer, be sure to have a poly-fill that adds a global Promise object

Installing

Using npm:

$ npm install regrest

Using cdn:

<script src="https://cdn.jsdelivr.net/npm/regrest/lib/index.umd.min.js"></script>

Example

Regrest is designed to be the simplest way possible to make http calls

Performing a GET request

// Import using NodeJS or CommonJS moduleconst regrest = require("regrest").default;// Or using ES6 moduleimport regrest from "regrest";// Use Promiseregrest
  .get("/man/bear/pig")
  // Print the raw response string
  .then((response) => console.log(response.text))
  // Print any error if occurred
  .catch((error) => console.log(`*** Error: ${error}`));// Or use the new async/await keywordsconst getGood = async () => {
  try {// Store the response in a variableconst response = await regrest.get("/foo/bar.json");// print out the parsed responseconsole.log(response.json);
  } catch (error) {// Print any error if occurredconsole.log(`*** Error: ${error}`);
  }};getGood();// Or use callbacks// WE DON'T DO THAT HERE

Performing a POST request

regrest
  .post("/comment", JSON.stringify({ name: "Foo", comment: "Bar" }))
  .then((response) => console.log(response.status, response.statusText))
  .catch((error) => console.log(error));

Documentation

Convenience methods

regrest.request(options)

regrest.get(url[, options])

regrest.head(url[, options])

regrest.post(url[, data[, options]])

regrest.put(url[, data[, options]])

regrest.delete(url[, options])

regrest.options(url[, options])

regrest.patch(url[, data[, options]])

Options options

// Default options are marked with *const options = {
  method: "GET", // *GET, POST, PUT, DELETE, etc.
  url: "https://some-domain.com/api/",
  headers: { "Content-Type": "application/json; charset=utf-8" }, // *{}
  params: { UID: 9873 },
  data: JSON.stringify(data), // *null
  maxRedirects: 10, // *5
  withCredentials: true, // *false, true};

Response object attributes

{
  // Contains the status code of the response, e.g. 404 for a not found resource, 200 for a success
  status: 200,
  // A message related to the status attribute, e.g. OK for a status 200
  statusText: "OK",
  // The headers that the server responded with
  headers: {},
  // Response content as a string
  text: "",
  // Response content as JSON
  json: {},
  // Response content as Blob on browser and Buffer on Node js
  arrayBuffer: instance of Blob || instance of Buffer,
  // Reponse content as Blob
  blob: instance of Blob};

Errors handling

regrest.get("/McNullington").catch((error) => {
  if (error.response) {/**     * A request was made but server responded     * with status code out of the 2XX range     * `error.response` is an instance of the response object     */console.log(error.response.status);console.log(error.response.statusText);console.log(error.response.headers);// ...
  } else if (error.request) {/**     * A request was made, but no response was received     * `error.request` is an instance of XMLHttpRequest on browser and an instance of     * http.ClientRequest on Node js     */console.log(error.request);
  } else {// Something else happenedconsole.log(error.message);
  }});