minipass-fetch

What is minipass-fetch?

The minipass-fetch npm package is a light-weight implementation of the window.fetch API built on top of the minipass stream library. It is designed to be a smaller, stream-based alternative to the larger fetch implementations, allowing for efficient data handling and manipulation in Node.js environments.

What are minipass-fetch's main functionalities?

Performing HTTP GET requests

This feature allows you to perform HTTP GET requests to retrieve data from a specified URL. The response can be processed as JSON.

const fetch = require('minipass-fetch');

fetch('https://api.example.com/data')
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error('Error:', error));

Performing HTTP POST requests

This feature allows you to perform HTTP POST requests to send data to a server. You can include headers and a body in the request.

const fetch = require('minipass-fetch');

fetch('https://api.example.com/submit', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({ key: 'value' })
})
.then(response => response.json())
.then(data => console.log('Success:', data))
.catch(error => console.error('Error:', error));

Streaming response data

This feature leverages the streaming capabilities of minipass-fetch to handle large amounts of data without buffering it all in memory at once.

const fetch = require('minipass-fetch');
const { PassThrough } = require('stream');

fetch('https://api.example.com/large-data')
  .then(response => {
    const stream = new PassThrough();
    response.body.pipe(stream);
    stream.on('data', chunk => console.log(chunk.toString()));
  })
  .catch(error => console.error('Error:', error));

Other packages similar to minipass-fetch

node-fetch

node-fetch is a light-weight module that brings the Fetch API to Node.js. It is similar to minipass-fetch but does not focus on streaming data and may not be as minimal in size.

axios

axios is a promise-based HTTP client for the browser and Node.js. It provides a more feature-rich API compared to minipass-fetch, including interceptors, automatic transforms for JSON data, and client-side protection against XSRF.

got

got is a human-friendly and powerful HTTP request library for Node.js. It offers advanced features like retries, streams, and convenient JSON handling, which can make it a more comprehensive alternative to minipass-fetch.

README

minipass-fetch

An implementation of window.fetch in Node.js using Minipass streams

This is a fork (or more precisely, a reimplementation) of node-fetch. All streams have been replaced with minipass streams.

The goal of this module is to stay in sync with the API presented by node-fetch, with the exception of the streaming interface provided.

Why

Minipass streams are faster and more deterministic in their timing contract than node-core streams, making them a better fit for many server-side use cases.

API

See node-fetch

Differences from node-fetch (and, by extension, from the WhatWG Fetch specification):

• Returns minipass streams instead of node-core streams.
• Supports the full set of TLS Options that may be provided to https.request() when making https requests.

Changelog

4.0.0 (2024-09-05)

⚠️ BREAKING CHANGES

• minipass-fetch now supports node ^18.17.0 || >=20.5.0

Bug Fixes

• 1ce7c52 #161 align to npm 10 node engine range (@hashtagchris)

Dependencies

• fddb214 #164 bump minizlib from 2.1.2 to 3.0.1 (@dependabot[bot])

Chores

• f59d139 #160 bump @npmcli/eslint-config from 4.0.5 to 5.0.0 (@dependabot[bot])
• 8e696c6 #161 run template-oss-apply (@hashtagchris)
• 4a7fb89 #149 tests NODE_TLS_REJECT_UNAUTHORIZED (#149) (@reggi)
• 7f99262 #163 postinstall for dependabot template-oss PR (@hashtagchris)
• 21fcdc0 #163 bump @npmcli/template-oss from 4.22.0 to 4.23.3 (@dependabot[bot])