@algolia/requester-fetch

What is @algolia/requester-fetch?

@algolia/requester-fetch is a lightweight HTTP client built on top of the Fetch API. It is designed to be used with Algolia's JavaScript API clients but can be used independently for making HTTP requests in a straightforward manner.

What are @algolia/requester-fetch's main functionalities?

Basic GET Request

This feature allows you to make a basic GET request to a specified URL. The response is returned as a promise, which can be handled using `.then` and `.catch`.

const { createFetchRequester } = require('@algolia/requester-fetch');

const requester = createFetchRequester();

requester({
  method: 'GET',
  url: 'https://jsonplaceholder.typicode.com/posts/1'
}).then(response => {
  console.log(response.content);
}).catch(error => {
  console.error(error);
});

POST Request with JSON Body

This feature allows you to make a POST request with a JSON body. You can specify the request method, URL, data, and headers.

const { createFetchRequester } = require('@algolia/requester-fetch');

const requester = createFetchRequester();

requester({
  method: 'POST',
  url: 'https://jsonplaceholder.typicode.com/posts',
  data: JSON.stringify({
    title: 'foo',
    body: 'bar',
    userId: 1
  }),
  headers: {
    'Content-type': 'application/json; charset=UTF-8'
  }
}).then(response => {
  console.log(response.content);
}).catch(error => {
  console.error(error);
});

Handling Response Headers

This feature allows you to access and handle response headers from the HTTP response. The headers can be accessed using the `.headers` property of the response object.

const { createFetchRequester } = require('@algolia/requester-fetch');

const requester = createFetchRequester();

requester({
  method: 'GET',
  url: 'https://jsonplaceholder.typicode.com/posts/1'
}).then(response => {
  console.log(response.headers.get('Content-Type'));
}).catch(error => {
  console.error(error);
});

Other packages similar to @algolia/requester-fetch

axios

Axios is a promise-based HTTP client for the browser and Node.js. It provides a more feature-rich API compared to @algolia/requester-fetch, including request and response interceptors, automatic JSON data transformation, and support for older browsers.

node-fetch

Node-fetch is a lightweight module that brings `window.fetch` to Node.js. It is similar to @algolia/requester-fetch in that it is built on top of the Fetch API, but it is more focused on providing a polyfill for the Fetch API in Node.js environments.

got

Got is a human-friendly and powerful HTTP request library for Node.js. It offers a more extensive set of features compared to @algolia/requester-fetch, including retry mechanisms, advanced stream support, and hooks for modifying requests and responses.

README

The README file is missing

Changelog

5.25.0

• e5387adf09 chore(deps): dependencies 2025-05-05 (#4804) by @algolia-bot
• d26cbaa311 feat(specs): enrich response for list composition endpoint (#4819) by @ClaraMuller
• 95f3208e92 feat(specs): make response fields required for composition list endpoint (#4821) by @ClaraMuller
• bebb56e0b9 fix(specs): add x-acl to insights endpoints (#4822) by @kai687
• d29371295f chore(deps): dependencies 2025-05-12 (#4823) by @algolia-bot
• 7e226c4559 feat(scripts): add push to mcp-node on release (#4784) by @shortcuts