xhr2-cookies

What is xhr2-cookies?

The xhr2-cookies npm package is a fork of the 'xhr2' package that adds support for cookies. It provides an XMLHttpRequest implementation for Node.js, allowing you to make HTTP requests and handle cookies in a similar way to how you would in a browser environment.

What are xhr2-cookies's main functionalities?

Making HTTP GET Requests

This feature allows you to make HTTP GET requests. The code sample demonstrates how to create an XMLHttpRequest object, open a connection to a URL, and handle the response.

const XMLHttpRequest = require('xhr2-cookies').XMLHttpRequest;
const xhr = new XMLHttpRequest();
xhr.open('GET', 'https://api.example.com/data', true);
xhr.onload = function () {
  if (xhr.status >= 200 && xhr.status < 300) {
    console.log(xhr.responseText);
  }
};
xhr.send();

Handling Cookies

This feature allows you to handle cookies in your HTTP requests. The code sample demonstrates how to enable credentials (cookies) in the XMLHttpRequest object.

const XMLHttpRequest = require('xhr2-cookies').XMLHttpRequest;
const xhr = new XMLHttpRequest();
xhr.open('GET', 'https://api.example.com/data', true);
xhr.withCredentials = true;
xhr.onload = function () {
  if (xhr.status >= 200 && xhr.status < 300) {
    console.log(xhr.responseText);
  }
};
xhr.send();

Making HTTP POST Requests

This feature allows you to make HTTP POST requests. The code sample demonstrates how to create an XMLHttpRequest object, set the request headers, and send data in the request body.

const XMLHttpRequest = require('xhr2-cookies').XMLHttpRequest;
const xhr = new XMLHttpRequest();
xhr.open('POST', 'https://api.example.com/data', true);
xhr.setRequestHeader('Content-Type', 'application/json');
xhr.onload = function () {
  if (xhr.status >= 200 && xhr.status < 300) {
    console.log(xhr.responseText);
  }
};
xhr.send(JSON.stringify({ key: 'value' }));

Other packages similar to xhr2-cookies

axios

Axios is a popular promise-based HTTP client for Node.js and the browser. It supports automatic transformation of JSON data, intercepting requests and responses, and handling cookies. Compared to xhr2-cookies, Axios provides a more modern and feature-rich API.

node-fetch

Node-fetch is a lightweight module that brings the Fetch API to Node.js. It is similar to the browser's fetch API and supports cookies through the 'node-fetch-cookies' package. Compared to xhr2-cookies, node-fetch offers a simpler and more modern API for making HTTP requests.

request

Request is a simplified HTTP client for Node.js with support for cookies, redirects, and more. It is more feature-rich compared to xhr2-cookies but has been deprecated in favor of more modern alternatives like Axios and node-fetch.

README

XMLHttpRequest polyfill for node.js

Based on https://github.com/pwnall/node-xhr2

• Adds support for cookies
• Adds in-project TypeScript type definitions
• Switched to TypeScript

Cookies

• saved in XMLHttpRequest.cookieJar
• saved between redirects
• saved between requests
• can be cleared by doing:

import * as Cookie from 'cookiejar';
XMLHttpRequest.cookieJar = Cookie.CookieJar();

Aims

• Provide full XMLHttpRequest features to Angular Universal HttpClient & node-angular-http-client

Changelog

1.1.0

• added saving of cookies between requests, not just redirects
• bug fixes
• most tests from xhr2 ported over and passing