Response

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

---

Методы

allHeaders

Добавлено в: v1.15 response.allHeaders

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

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

await response.allHeaders();

Возвращает

• Promise<Object<string, string>>#

---

body

Добавлено до v1.9 response.body

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

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

await response.body();

Возвращает

• Promise<Buffer>#

---

finished

Добавлено до v1.9 response.finished

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

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

await response.finished();

Возвращает

• Promise<null | Error>#

---

frame

Добавлено до v1.9 response.frame

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

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

response.frame();

Возвращает

• Frame#

---

fromServiceWorker

Добавлено в: v1.23 response.fromServiceWorker

Указывает, был ли этот ответ выполнен обработчиком Fetch Service Worker (например, через FetchEvent.respondWith).

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

response.fromServiceWorker();

Возвращает

• boolean#

---

headerValue

Добавлено в: v1.15 response.headerValue

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

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

await response.headerValue(name);

Аргументы

• name string#

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

Возвращает

• Promise<null | string>#

---

headerValues

Добавлено в: v1.15 response.headerValues

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

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

await response.headerValues(name);

Аргументы

• name string#

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

Возвращает

• Promise<Array<string>>#

---

headers

Добавлено до v1.9 response.headers

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

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

response.headers();

Возвращает

• Object<string, string>#

---

headersArray

Добавлено в: v1.15 response.headersArray

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

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

await response.headersArray();

Возвращает

• Promise<Array<Object>>#

  • name string

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

  • value string

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

---

json

Добавлено до v1.9 response.json

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

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

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

await response.json();

Возвращает

• Promise<Serializable>#

---

ok

Добавлено до v1.9 response.ok

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

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

response.ok();

Возвращает

• boolean#

---

request

Добавлено до v1.9 response.request

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

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

response.request();

Возвращает

• Request#

---

securityDetails

Добавлено в: v1.13 response.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

Добавлено в: v1.13 response.serverAddr

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

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

await response.serverAddr();

Возвращает

• Promise<null | Object>#

  • ipAddress string

    IPv4 или IPV6 адрес сервера.

  • port number

---

status

Добавлено до v1.9 response.status

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

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

response.status();

Возвращает

• number#

---

statusText

Добавлено до v1.9 response.statusText

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

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

response.statusText();

Возвращает

• string#

---

text

Добавлено до v1.9 response.text

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

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

await response.text();

Возвращает

• Promise<string>#

---

url

Добавлено до v1.9 response.url

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

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

response.url();

Возвращает

• string#