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 betweennode-fetch@2andnode-fetch@3. - With upcoming versions of Node.js, native
fetchis being supported. We are prepared for native fetch support using this package yet keep supporting older Node versions.
Features:
vs
require) and ESM (import) usage
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')
More named exports:
// ESM
import { fetch, Blob, FormData, Headers, Request, Response, AbortController } from 'node-fetch-native'
// CommonJS
const { fetch, Blob, FormData, Headers, Request, Response, AbortController } = require('node-fetch-native')
Polyfill support
Using the polyfill method, we can once ensure global fetch is available in the environment and all files. Natives are always preferred.
Note: I don't recommand this if you are authoring a library! Please prefer explicit methods.
// ESM
import 'node-fetch-native/polyfill'
// CJS
require('node-fetch-native/polyfill')
// You can now use fetch() without any import!
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
2 Feb 17, 2022
2 Jan 28, 2022
12 Apr 6, 2022
47 Nov 29, 2022
2 Mar 27, 2022
3 May 7, 2022
19 Mar 31, 2022
10 Dec 31, 2022
858 Jan 3, 2023
6 Jun 23, 2022
38 Sep 11, 2020
20 Nov 27, 2022
5 Aug 29, 2022
4 Sep 20, 2022
17 Jul 31, 2022
255 Dec 27, 2022
6 Dec 27, 2022
49 Dec 28, 2022
3 Nov 19, 2022