// Type definitions for node-fetch 2.5
|
|
// Project: https://github.com/bitinn/node-fetch
|
|
// Definitions by: Torsten Werner <https://github.com/torstenwerner>
|
|
// Niklas Lindgren <https://github.com/nikcorg>
|
|
// Vinay Bedre <https://github.com/vinaybedre>
|
|
// Antonio Román <https://github.com/kyranet>
|
|
// Andrew Leedham <https://github.com/AndrewLeedham>
|
|
// Jason Li <https://github.com/JasonLi914>
|
|
// Steve Faulkner <https://github.com/southpolesteve>
|
|
// ExE Boss <https://github.com/ExE-Boss>
|
|
// Alex Savin <https://github.com/alexandrusavin>
|
|
// Alexis Tyler <https://github.com/OmgImAlexis>
|
|
// Jakub Kisielewski <https://github.com/kbkk>
|
|
// Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
|
|
|
|
/// <reference types="node" />
|
|
|
|
declare module 'node-fetch' {
|
|
import type { Agent } from 'http';
|
|
import type { URLSearchParams, URL } from 'url';
|
|
|
|
export class Request extends Body {
|
|
constructor(input: RequestInfo, init?: RequestInit);
|
|
clone(): Request;
|
|
context: RequestContext;
|
|
headers: Headers;
|
|
method: string;
|
|
redirect: RequestRedirect;
|
|
referrer: string;
|
|
url: string;
|
|
|
|
// node-fetch extensions to the whatwg/fetch spec
|
|
agent?: Agent | ((parsedUrl: URL) => Agent) | undefined;
|
|
compress: boolean;
|
|
counter: number;
|
|
follow: number;
|
|
hostname: string;
|
|
port?: number | undefined;
|
|
protocol: string;
|
|
size: number;
|
|
timeout: number;
|
|
}
|
|
|
|
export interface RequestInit {
|
|
// whatwg/fetch standard options
|
|
body?: BodyInit | undefined;
|
|
headers?: HeadersInit | undefined;
|
|
method?: string | undefined;
|
|
redirect?: RequestRedirect | undefined;
|
|
|
|
// node-fetch extensions
|
|
agent?: Agent | ((parsedUrl: URL) => Agent) | undefined; // =null http.Agent instance, allows custom proxy, certificate etc.
|
|
compress?: boolean | undefined; // =true support gzip/deflate content encoding. false to disable
|
|
follow?: number | undefined; // =20 maximum redirect count. 0 to not follow redirect
|
|
size?: number | undefined; // =0 maximum response body size in bytes. 0 to disable
|
|
timeout?: number | undefined; // =0 req/res timeout in ms, it resets on redirect. 0 to disable (OS limit applies)
|
|
|
|
// node-fetch does not support mode, cache or credentials options
|
|
}
|
|
|
|
export type RequestContext =
|
|
| 'audio'
|
|
| 'beacon'
|
|
| 'cspreport'
|
|
| 'download'
|
|
| 'embed'
|
|
| 'eventsource'
|
|
| 'favicon'
|
|
| 'fetch'
|
|
| 'font'
|
|
| 'form'
|
|
| 'frame'
|
|
| 'hyperlink'
|
|
| 'iframe'
|
|
| 'image'
|
|
| 'imageset'
|
|
| 'import'
|
|
| 'internal'
|
|
| 'location'
|
|
| 'manifest'
|
|
| 'object'
|
|
| 'ping'
|
|
| 'plugin'
|
|
| 'prefetch'
|
|
| 'script'
|
|
| 'serviceworker'
|
|
| 'sharedworker'
|
|
| 'style'
|
|
| 'subresource'
|
|
| 'track'
|
|
| 'video'
|
|
| 'worker'
|
|
| 'xmlhttprequest'
|
|
| 'xslt';
|
|
export type RequestMode = 'cors' | 'no-cors' | 'same-origin';
|
|
export type RequestRedirect = 'error' | 'follow' | 'manual';
|
|
export type RequestCredentials = 'omit' | 'include' | 'same-origin';
|
|
|
|
export type RequestCache = 'default' | 'force-cache' | 'no-cache' | 'no-store' | 'only-if-cached' | 'reload';
|
|
|
|
export class Headers implements Iterable<[string, string]> {
|
|
constructor(init?: HeadersInit);
|
|
forEach(callback: (value: string, name: string) => void): void;
|
|
append(name: string, value: string): void;
|
|
delete(name: string): void;
|
|
get(name: string): string | null;
|
|
has(name: string): boolean;
|
|
raw(): { [k: string]: string[] };
|
|
set(name: string, value: string): void;
|
|
|
|
// Iterable methods
|
|
entries(): IterableIterator<[string, string]>;
|
|
keys(): IterableIterator<string>;
|
|
values(): IterableIterator<string>;
|
|
[Symbol.iterator](): Iterator<[string, string]>;
|
|
}
|
|
|
|
type BlobPart = ArrayBuffer | ArrayBufferView | Blob | string;
|
|
|
|
interface BlobOptions {
|
|
type?: string | undefined;
|
|
endings?: 'transparent' | 'native' | undefined;
|
|
}
|
|
|
|
export class Blob {
|
|
constructor(blobParts?: BlobPart[], options?: BlobOptions);
|
|
readonly type: string;
|
|
readonly size: number;
|
|
slice(start?: number, end?: number): Blob;
|
|
text(): Promise<string>;
|
|
}
|
|
|
|
export class Body {
|
|
constructor(body?: any, opts?: { size?: number | undefined; timeout?: number | undefined });
|
|
arrayBuffer(): Promise<ArrayBuffer>;
|
|
blob(): Promise<Blob>;
|
|
body: NodeJS.ReadableStream;
|
|
bodyUsed: boolean;
|
|
buffer(): Promise<Buffer>;
|
|
json(): Promise<any>;
|
|
size: number;
|
|
text(): Promise<string>;
|
|
textConverted(): Promise<string>;
|
|
timeout: number;
|
|
}
|
|
|
|
interface SystemError extends Error {
|
|
code?: string | undefined;
|
|
}
|
|
|
|
export class FetchError extends Error {
|
|
name: 'FetchError';
|
|
constructor(message: string, type: string, systemError?: SystemError);
|
|
type: string;
|
|
code?: string | undefined;
|
|
errno?: string | undefined;
|
|
}
|
|
|
|
export class Response extends Body {
|
|
constructor(body?: BodyInit, init?: ResponseInit);
|
|
static error(): Response;
|
|
static redirect(url: string, status: number): Response;
|
|
clone(): Response;
|
|
headers: Headers;
|
|
ok: boolean;
|
|
redirected: boolean;
|
|
status: number;
|
|
statusText: string;
|
|
type: ResponseType;
|
|
url: string;
|
|
}
|
|
|
|
export type ResponseType = 'basic' | 'cors' | 'default' | 'error' | 'opaque' | 'opaqueredirect';
|
|
|
|
export interface ResponseInit {
|
|
headers?: HeadersInit | undefined;
|
|
size?: number | undefined;
|
|
status?: number | undefined;
|
|
statusText?: string | undefined;
|
|
timeout?: number | undefined;
|
|
url?: string | undefined;
|
|
}
|
|
|
|
interface URLLike {
|
|
href: string;
|
|
}
|
|
|
|
export type HeadersInit = Headers | string[][] | { [key: string]: string };
|
|
// HeaderInit is exported to support backwards compatibility. See PR #34382
|
|
export type HeaderInit = HeadersInit;
|
|
export type BodyInit = ArrayBuffer | ArrayBufferView | NodeJS.ReadableStream | string | URLSearchParams;
|
|
export type RequestInfo = string | URLLike | Request;
|
|
|
|
declare function fetch(url: RequestInfo, init?: RequestInit): Promise<Response>;
|
|
|
|
declare namespace fetch {
|
|
function isRedirect(code: number): boolean;
|
|
}
|
|
|
|
export default fetch;
|
|
}
|