node-fetch-native

node-fetch-native

A redistribution of node-fetch v3 for better backward and forward compatibility.

Why this package?

• We can no longer require('node-fetch') with latest version. This stopped popular libraries from upgrading and dependency conflicts between node-fetch@2 and node-fetch@3.
• With upcoming versions of Node.js, native fetch is being supported. We are prepared for native fetch support using this package yet keep supporting older Node versions.

✅ Prefer to native globals when available (fetch, Blob, File, FormData, Headers, Request, and Response) when available (Node.js experimental fetch)

✅ Compact build and less install size with zero dependencies

✅ Support both CommonJS (require) and ESM (import) usage

✅ Use native version if imported without node condition using conditional exports with zero bundle overhead

Usage

Install node-fetch-native dependency:

# npm
npm i node-fetch-native

# yarn
yarn add node-fetch-native

# pnpm
pnpm i node-fetch-native

You can now either import or require the dependency:

// ESM
import fetch from `node-fetch-native`

// CommonJS
const fetch = require('node-fetch-native')

Other exports:

// ESM
import { fetch, Blob, FormData, Headers, Request, Response } from `node-fetch-native`

// CommonJS
const { fetch, Blob, FormData, Headers, Request, Response } = require('node-fetch-native')

Alias to node-fetch

Using this method, you can ensure all project dependencies and usages of node-fetch can benefit from improved node-fetch-native and won't conflict between node-fetch@2 and node-fetch@3.

npm

Using npm overrides:

// package.json
{
  "overrides": {
    "node-fetch": "npm:node-fetch-native@latest"
  }
}

yarn

Using yarn selective dependency resolutions:

// package.json
{
  "resolutions": {
    "node-fetch": "npm:node-fetch-native@latest"
  }
}

pnpm

Using pnpm.overrides:

// package.json
{
  "pnpm": {
    "overrides": {
      "node-fetch": "npm:node-fetch-native@latest"
    }
  }
}

License

Made with 💛

node-fetch is published under the MIT license