Nâng cấp node-fetch từ 2.x lên 3.x

So sánh API công khai của node-fetch 2.7.0 và 3.3.2, được tính tự động từ kiểu TypeScript. Chữ ký thay đổi là thay đổi có thể không tương thích, không phải điều chắc chắn.

Tóm tắt

Đường dẫn import bị xóa	1
Export bị xóa	6
Chữ ký thay đổi	5
Thành viên lớp hoặc interface bị xóa	19
Thành viên lớp hoặc interface thay đổi	14
Mới bị ngừng hỗ trợ	3
Thay đổi yêu cầu (engines, phụ thuộc peer)	2
Export mới	7

Đường dẫn import bị xóa

Đường dẫn import bị xóa
`node-fetch/externals`

Export bị xóa

import	export	kind	Trước
`node-fetch`	`HeaderInit`	type	`Headers \| string[][] \| { [key: string]: string \| string[]; }`
`node-fetch`	`RequestMode`	type	`"same-origin" \| "cors" \| "no-cors"`
`node-fetch`	`RequestCache`	type	`"default" \| "force-cache" \| "no-cache" \| "no-store" \| "only-if-cached" \| "reload"`
`node-fetch`	`ResponseType`	type	`"error" \| "default" \| "cors" \| "basic" \| "opaque" \| "opaqueredirect"`
`node-fetch`	`RequestContext`	type	`"object" \| "audio" \| "beacon" \| "cspreport" \| "download" \| "embed" \| "eventsource" \| "favicon" \| "fetch" \| "font" \| "form" \| "frame" \| "hyperlink" \| "iframe" \| "image" \| "imageset" \| "import" \| "internal" \| "location" \| "manifest" \| "ping" \| "plugin" \| "prefetch" \| "script" \| "serviceworker" \| "sharedworker" \| "style" \| "subresource" \| "track" \| "video" \| "worker" \| "xmlhttprequest" \| "xslt"`
`node-fetch`	`RequestCredentials`	type	`"omit" \| "include" \| "same-origin"`

Chữ ký thay đổi

export	Trước	Sau
`node-fetch · Blob`	`class`	`any`
`node-fetch · Body`	`class`	`interface`
`node-fetch · default`	`(url: RequestInfo, init?: RequestInit \| undefined): Promise<Response>`	`(url: URL \| RequestInfo, init?: RequestInit \| undefined): Promise<Response>`
`node-fetch · HeadersInit`	`Headers \| string[][] \| { [key: string]: string \| string[]; }`	`Headers \| Record<string, string> \| Iterable<readonly [string, string]> \| Iterable<Iterable<string>>`
`node-fetch · RequestInfo`	`string \| Request \| URLLike`	`string \| Request`

Thành viên lớp hoặc interface bị xóa

member	import	Trước
`Body.timeout`	`node-fetch`	`number`
`Body.textConverted`	`node-fetch`	`(): Promise<string>`
`Request.port`	`node-fetch`	`number \| undefined`
`Request.agent`	`node-fetch`	`any`
`Request.follow`	`node-fetch`	`number`
`Request.context`	`node-fetch`	`RequestContext`
`Request.counter`	`node-fetch`	`number`
`Request.timeout`	`node-fetch`	`number`
`Request.compress`	`node-fetch`	`boolean`
`Request.hostname`	`node-fetch`	`string`
`Request.protocol`	`node-fetch`	`string`
`Request.textConverted`	`node-fetch`	`(): Promise<string>`
`Response.timeout`	`node-fetch`	`number`
`Response.textConverted`	`node-fetch`	`(): Promise<string>`
`RequestInit.timeout`	`node-fetch`	`number \| undefined`
`ResponseInit.url`	`node-fetch`	`string \| undefined`
`ResponseInit.size`	`node-fetch`	`number \| undefined`
`ResponseInit.counter`	`node-fetch`	`number \| undefined`
`ResponseInit.timeout`	`node-fetch`	`number \| undefined`

Thành viên lớp hoặc interface thay đổi

member	Trước	Sau
`Body.body`	`NodeJS.ReadableStream`	`any`
`Body.json`	`(): Promise<any>`	`(): Promise<unknown>`
`Body.constructor`	`(body?: any, opts?: { size?: number \| undefined; timeout?: number \| undefined; } \| undefined): Body`
`Headers.raw`	`(): { [k: string]: string[]; }`	`(): Record<string, string[]>`
`Headers.forEach`	`(callback: (value: string, name: string) => void): void`	`(callbackfn: (value: string, key: string, parent: Headers) => void, thisArg?: any): void`
`Request.body`	`NodeJS.ReadableStream`	`any`
`Request.json`	`(): Promise<any>`	`(): Promise<unknown>`
`Request.constructor`	`(input: RequestInfo, init?: RequestInit \| undefined): Request`	`(input: URL \| RequestInfo, init?: RequestInit \| undefined): Request`
`Response.body`	`NodeJS.ReadableStream`	`any`
`Response.json`	`(): Promise<any>`	`(): Promise<unknown>`
`Response.static redirect`	`(url: string, status: number): Response`	`(url: string, status?: number \| undefined): Response`
`AbortError.type`	`"aborted"`	`string`
`AbortError.constructor`	`(message: string): AbortError`	`(message?: string \| undefined): AbortError \| (message?: string \| undefined, options?: ErrorOptions \| undefined): AbortError`
`FetchError.constructor`	`(message: string, type: string, systemError?: SystemError \| undefined): FetchError`	`(message: string, type: string, systemError?: Record<string, unknown> \| undefined): FetchError`

Mới bị ngừng hỗ trợ

export	@deprecated
`node-fetch · Body.buffer`	Use `body.arrayBuffer()` instead.
`node-fetch · Request.buffer`	Use `body.arrayBuffer()` instead.
`node-fetch · Response.buffer`	Use `body.arrayBuffer()` instead.

Thay đổi yêu cầu (engines, phụ thuộc peer)

	Trước	Sau
`engines.node`	`4.x \|\| >=6.0.0`	`^12.20.0 \|\| ^14.13.1 \|\| >=16.0.0`
`peerDependencies.encoding`	`^0.1.0`	`—`

Export mới (7)

import	export	kind
`node-fetch`	`File`	variable
`node-fetch`	`FormData`	variable
`node-fetch`	`blobFrom`	variable
`node-fetch`	`fileFrom`	variable
`node-fetch`	`blobFromSync`	variable
`node-fetch`	`fileFromSync`	variable
`node-fetch`	`ReferrerPolicy`	type

Câu hỏi thường gặp

Nâng cấp node-fetch từ 2 lên 3 có những thay đổi không tương thích nào?

Giữa node-fetch 2.7.0 và 3.3.2, Vigia tìm thấy 6 export bị xóa, 5 chữ ký thay đổi và 33 thành viên lớp hoặc interface bị xóa hay thay đổi.

Những gì bị ngừng hỗ trợ trong node-fetch 3?

3 export hoặc thành viên mới bị đánh dấu ngừng hỗ trợ trong node-fetch 3.3.2.

Dành cho tác tử

GET https://vigia.coredls.cloud/v1/packages/npm/node-fetch/upgrade?from=2.7.0&to=3.3.2