File: class-response.md | Updated: 11/18/2025
On this page
Response class represents responses which are received by page.
Methods
Added in: v1.15 response.all_headers
An object with all the response HTTP headers associated with this response.
Usage
response.all_headers()
Returns
Added before v1.9 response.body
Returns the buffer with response body.
Usage
response.body()
Returns
Added before v1.9 response.finished
Waits for this response to finish, returns always null.
Usage
response.finished()
Returns
Added in: v1.15 response.header_value
Returns the value of the header matching the name. The name is case-insensitive. If multiple headers have the same name (except set-cookie), they are returned as a list separated by , . For set-cookie, the \n separator is used. If no headers are found, null is returned.
Usage
response.header_value(name)
Arguments
Returns
Added in: v1.15 response.header_values
Returns all values of the headers matching the name, for example set-cookie. The name is case-insensitive.
Usage
response.header_values(name)
Arguments
Returns
Added in: v1.15 response.headers_array
An array with all the request HTTP headers associated with this response. Unlike response.all_headers()
, header names are NOT lower-cased. Headers with multiple entries, such as Set-Cookie, appear in the array multiple times.
Usage
response.headers_array()
Returns
Added before v1.9 response.json
Returns the JSON representation of response body.
This method will throw if the response body is not parsable via JSON.parse.
Usage
response.json()
Returns
Added in: v1.13 response.security_details
Returns SSL and other security information.
Usage
response.security_details()
Returns
issuer str
(optional)
Common Name component of the Issuer field. from the certificate. This should only be used for informational purposes. Optional.
protocol str
(optional)
The specific TLS protocol used. (e.g. TLS 1.3). Optional.
subjectName str
(optional)
Common Name component of the Subject field from the certificate. This should only be used for informational purposes. Optional.
validFrom float
(optional)
Unix timestamp (in seconds) specifying when this cert becomes valid. Optional.
validTo float
(optional)
Unix timestamp (in seconds) specifying when this cert becomes invalid. Optional.
Added in: v1.13 response.server_addr
Returns the IP address and port of the server.
Usage
response.server_addr()
Returns
Added before v1.9 response.text
Returns the text representation of response body.
Usage
response.text()
Returns
Properties
Added before v1.9 response.frame
Returns the Frame that initiated this response.
Usage
response.frame
Returns
Added in: v1.23 response.from_service_worker
Indicates whether this Response was fulfilled by a Service Worker's Fetch Handler (i.e. via FetchEvent.respondWith ).
Usage
response.from_service_worker
Returns
Added before v1.9 response.headers
An object with the response HTTP headers. The header names are lower-cased. Note that this method does not return security-related headers, including cookie-related ones. You can use response.all_headers()
for complete list of headers that include cookie information.
Usage
response.headers
Returns
Added before v1.9 response.ok
Contains a boolean stating whether the response was successful (status in the range 200-299) or not.
Usage
response.ok
Returns
Added before v1.9 response.request
Returns the matching Request object.
Usage
response.request
Returns
Added before v1.9 response.status
Contains the status code of the response (e.g., 200 for a success).
Usage
response.status
Returns
Added before v1.9 response.status_text
Contains the status text of the response (e.g. usually an "OK" for a success).
Usage
response.status_text
Returns
Added before v1.9 response.url
Contains the URL of the response.
Usage
response.url
Returns