Запрос

Этот интерфейс API Fetch представляет собой запрос на ресурс.

class Request implements Body {

constructor(input: RequestInfo | URL, init?: RequestInit);


readonly body: ReadableStream<Uint8Array> | null;


readonly bodyUsed: boolean;


readonly cache: RequestCache;


readonly credentials: RequestCredentials;


readonly destination: RequestDestination;


readonly headers: Headers;


readonly integrity: string;


readonly isHistoryNavigation: boolean;


readonly isReloadNavigation: boolean;


readonly keepalive: boolean;


readonly method: string;


readonly mode: RequestMode;


readonly redirect: RequestRedirect;


readonly referrer: string;


readonly referrerPolicy: ReferrerPolicy;


readonly signal: AbortSignal;


readonly url: string;



arrayBuffer(): Promise<ArrayBuffer>;

blob(): Promise<Blob>;

clone(): Request;

formData(): Promise<FormData>;

json(): Promise<any>;

text(): Promise<string>;

}

Реализует

Body

Конструкторы

new Request(input: RequestInfo | URL, init?: RequestInit)

Свойства

body: ReadableStream<Uint8Array> | null

Простой геттер, используемый для отображения ReadableStream содержимого тела.

bodyUsed: boolean

Хранит Boolean , определяющий, использовалось ли тело в запросе.

cache: RequestCache

Возвращает режим кэширования, связанный с запросом, — строку, указывающую, как запрос будет взаимодействовать с кэшем браузера при получении.

credentials: RequestCredentials

Возвращает режим авторизации, связанный с запросом, — строку, указывающую, будут ли передаваться данные авторизации с запросом всегда, никогда или только при отправке на URL того же происхождения.

destination: RequestDestination

Возвращает тип запрашиваемого ресурса, например, «документ» или «скрипт».

headers: Headers

Возвращает объект Headers, содержащий заголовки, связанные с запросом. Обратите внимание, что заголовки, добавленные в сетевом слое агентом пользователя, не будут учитываться в этом объекте, например, заголовок «Host».

integrity: string

Возвращает метаданные целостности подресурса запроса, представляющие собой криптографический хэш запрашиваемого ресурса. Его значение состоит из нескольких хэшей, разделенных пробелами. [SRI]

isHistoryNavigation: boolean

Возвращает логическое значение, указывающее, является ли запрос переходом по истории (т. е. навигацией вперед-назад).

isReloadNavigation: boolean

Возвращает логическое значение, указывающее, является ли запрос повторной загрузкой.

keepalive: boolean

Возвращает логическое значение, указывающее, может ли запрос пережить глобальную область, в которой он был создан.

method: string

Возвращает HTTP-метод запроса, по умолчанию — «GET».

mode: RequestMode

Возвращает режим, связанный с запросом, — строку, указывающую, будет ли запрос использовать CORS или будет ограничен URL-адресами одного происхождения.

redirect: RequestRedirect

Возвращает режим перенаправления, связанный с запросом, — строку, указывающую, как будут обрабатываться перенаправления запроса во время получения. По умолчанию запрос следует перенаправлениям.

referrer: string

Возвращает отправителя запроса. Его значение может быть URL-адресом одного происхождения, если он явно задан в init, пустой строкой, чтобы указать отсутствие отправителя, и «about:client», когда используется значение по умолчанию для глобальной области. Это используется при получении для определения значения заголовка Referer отправляемого запроса.

referrerPolicy: ReferrerPolicy

Возвращает политику отправителя, связанную с запросом. Она используется во время получения для вычисления значения отправителя запроса.

signal: AbortSignal

Возвращает сигнал, связанный с запросом, — объект AbortSignal, указывающий, прерван ли запрос, и его обработчик события прерывания.

url: string

Возвращает URL запроса в виде строки.

Методы

arrayBuffer(): Promise<ArrayBuffer>

Принимает Request поток и читает его до конца. Возвращает промис, который разрешается с ArrayBuffer.

blob(): Promise<Blob>

Принимает Request поток и читает его до конца. Возвращает промис, который разрешается с Blob.

clone(): Request

formData(): Promise<FormData>

Принимает Request поток и читает его до конца. Возвращает промис, который разрешается с объектом FormData.

json(): Promise<any>

Принимает Request поток и читает его до конца. Возвращает промис, который разрешается с результатом разбора текста тела как JSON.

text(): Promise<string>

Принимает Request поток и читает его до конца. Возвращает промис, который разрешается с USVString (текстом).