Response

Класс Response представляет ответы, полученные страницей.

Методы​

allHeaders​

Объект со всеми HTTP-заголовками ответа, связанными с этим ответом.

Использование

await response.allHeaders();

Возвращает

• Promise<Object<string, string>>

body​

Возвращает буфер с телом ответа.

Использование

await response.body();

Возвращает

• Promise<Buffer>

finished​

Ожидает завершения этого ответа; всегда возвращает null.

Использование

await response.finished();

Возвращает

• Promise<null | Error>

frame​

Возвращает Frame, инициировавший этот ответ.

Использование

response.frame();

Возвращает

• Frame

fromServiceWorker​

Указывает, был ли этот Response обработан Fetch Handler сервисного работника (то есть через FetchEvent.respondWith).

Использование

response.fromServiceWorker();

Возвращает

• boolean

headerValue​

Возвращает значение заголовка с указанным именем. Регистр имени не учитывается. Если несколько заголовков имеют одинаковое имя (кроме set-cookie), они возвращаются в виде списка, разделённого , . Для set-cookie используется разделитель \n. Если заголовки не найдены, возвращается null.

Использование

await response.headerValue(name);

Аргументы

• name string

  Имя заголовка.

Возвращает

• Promise<null | string>

headerValues​

Возвращает все значения заголовков с указанным именем, например set-cookie. Регистр имени не учитывается.

Использование

await response.headerValues(name);

Аргументы

• name string

  Имя заголовка.

Возвращает

• Promise<Array<string>>

headers​

Объект с HTTP-заголовками ответа. Имена заголовков приведены к нижнему регистру. Обратите внимание, что этот метод не возвращает заголовки, связанные с безопасностью, включая заголовки, связанные с cookie. Для получения полного списка заголовков, включающего сведения cookie, можно использовать response.allHeaders().

Использование

response.headers();

Возвращает

• Object<string, string>

headersArray​

Массив со всеми HTTP-заголовками запроса, связанными с этим ответом. В отличие от response.allHeaders(), имена заголовков НЕ приводятся к нижнему регистру. Заголовки с несколькими значениями, например Set-Cookie, встречаются в массиве несколько раз.

Использование

await response.headersArray();

Возвращает

• Promise<Array<Object>>

  • name string

    Имя заголовка.

  • value string

    Значение заголовка.

httpVersion​

Возвращает версию HTTP, используемую в ответе.

Использование

await response.httpVersion();

Возвращает

• Promise<string>

json​

Возвращает JSON-представление тела ответа.

Этот метод вызовет ошибку, если тело ответа нельзя разобрать с помощью JSON.parse.

Использование

await response.json();

Возвращает

• Promise<Serializable>

ok​

Содержит логическое значение, указывающее, был ли ответ успешным (код состояния в диапазоне 200–299).

Использование

response.ok();

Возвращает

• boolean

request​

Возвращает соответствующий объект Request.

Использование

response.request();

Возвращает

• Request

securityDetails​

Возвращает сведения SSL и другую информацию о безопасности.

Использование

await response.securityDetails();

Возвращает

• Promise<null | Object>

  • issuer string (необязательно)

    Компонент Common Name поля Issuer из сертификата. Используется только в информационных целях. Необязательный параметр.

  • protocol string (необязательно)

    Используемый протокол TLS (например, TLS 1.3). Необязательный параметр.

  • subjectName string (необязательно)

    Компонент Common Name поля Subject из сертификата. Используется только в информационных целях. Необязательный параметр.

  • validFrom number (необязательно)

    Метка времени Unix (в секундах), указывающая, с какого момента этот сертификат становится действительным. Необязательный параметр.

  • validTo number (необязательно)

    Метка времени Unix (в секундах), указывающая, с какого момента этот сертификат становится недействительным. Необязательный параметр.

serverAddr​

Возвращает IP-адрес и порт сервера.

Использование

await response.serverAddr();

Возвращает

• Promise<null | Object>

  • ipAddress string

    Адрес IPv4 или IPv6 сервера.

  • port number

status​

Содержит код состояния ответа (например, 200 означает успешное выполнение).

Использование

response.status();

Возвращает

• number

statusText​

Содержит текст состояния ответа (например, обычно "OK" при успешном выполнении).

Использование

response.statusText();

Возвращает

• string

text​

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

Использование

await response.text();

Возвращает

• Promise<string>

url​

Содержит URL ответа.

Использование

response.url();

Возвращает

• string