Skip to main content

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]#