xhr

What is xhr?

The xhr npm package is a simple and lightweight library for making XMLHttpRequests in a browser environment. It provides a straightforward API for performing HTTP requests, handling responses, and managing errors.

What are xhr's main functionalities?

Basic GET Request

This feature allows you to perform a basic GET request to a specified URL. The callback function handles the response or any errors that occur.

const xhr = require('xhr');
xhr({ url: 'https://api.example.com/data' }, function (err, resp, body) {
  if (err) {
    console.error(err);
  } else {
    console.log(body);
  }
});

POST Request with Data

This feature allows you to perform a POST request with a JSON payload. The request includes headers to specify the content type, and the callback function handles the response or any errors.

const xhr = require('xhr');
xhr({
  url: 'https://api.example.com/data',
  method: 'POST',
  body: JSON.stringify({ key: 'value' }),
  headers: { 'Content-Type': 'application/json' }
}, function (err, resp, body) {
  if (err) {
    console.error(err);
  } else {
    console.log(body);
  }
});

Handling Response Status Codes

This feature demonstrates how to handle different HTTP response status codes. The callback function checks the status code and logs the appropriate message.

const xhr = require('xhr');
xhr({ url: 'https://api.example.com/data' }, function (err, resp, body) {
  if (err) {
    console.error(err);
  } else if (resp.statusCode === 200) {
    console.log('Success:', body);
  } else {
    console.log('Error:', resp.statusCode);
  }
});

Other packages similar to xhr

axios

Axios is a promise-based HTTP client for the browser and Node.js. It provides a more powerful and flexible API compared to xhr, including support for interceptors, automatic JSON transformation, and request cancellation.

fetch

Fetch is a built-in web API for making HTTP requests in the browser. It is a modern alternative to XMLHttpRequest and provides a more powerful and flexible API. Unlike xhr, fetch is built into modern browsers and does not require an external library.

superagent

Superagent is a small, progressive client-side HTTP request library. It provides a more feature-rich API compared to xhr, including support for promises, request retries, and plugins.

README

xhr

A small xhr wrapper

Example

var xhr = require("xhr")

xhr({
    method: "GET",
    data: someJSON,
    uri: "/foo",
    headers: {
        "Content-Type": "application/json"
    }
})

MIT Licenced