Documentation Index
Fetch the complete documentation index at: https://mintlify.com/microsoft/playwright/llms.txt
Use this file to discover all available pages before exploring further.
The Response class represents responses received by pages. Responses are emitted when the page receives an HTTP response for a request.
Methods
url
Returns the URL of the response.
const url = response.url();
console.log(url);
string
Returns whether the response was successful (status in the range 200-299).
if (response.ok()) {
console.log('Success!');
}
boolean
status
Returns the HTTP status code.
const status = response.status();
console.log(status); // 200, 404, etc.
number
statusText
Returns the HTTP status text.
const text = response.statusText();
console.log(text); // 'OK', 'Not Found', etc.
string
Returns the response headers.
const headers = response.headers();
console.log(headers['content-type']);
Object
This method returns provisional headers. Use allHeaders() for actual headers received over the network.
Returns all response headers.
const headers = await response.allHeaders();
console.log(headers);
Promise<Object>
Returns the response headers as an array of objects.
const headers = await response.headersArray();
console.log(headers); // [{ name: 'content-type', value: 'application/json' }, ...]
Promise<Array<{name: string, value: string}>>
Returns the value of a specific header.
const contentType = await response.headerValue('content-type');
console.log(contentType);
The header name (case-insensitive)
Promise<string | null>
Returns all values of a specific header.
const cookies = await response.headerValues('set-cookie');
console.log(cookies);
The header name (case-insensitive)
Promise<string[]>
body
Returns the response body as a Buffer.
const buffer = await response.body();
console.log(buffer);
Promise<Buffer>
text
Returns the response body as text.
const text = await response.text();
console.log(text);
Promise<string>
json
Parses the response body as JSON.
const data = await response.json();
console.log(data);
Promise<object>
request
Returns the request that initiated this response.
const request = response.request();
console.log(request.url());
Request
frame
Returns the frame that initiated the request.
const frame = response.frame();
console.log(frame.url());
Frame
fromServiceWorker
Returns whether the response was served by a service worker.
if (response.fromServiceWorker()) {
console.log('Served by service worker');
}
boolean
finished
Waits for the response to finish loading.
await response.finished();
console.log('Response finished loading');
Promise<null>
serverAddr
Returns the server IP address and port.
const addr = await response.serverAddr();
if (addr) {
console.log(`${addr.ipAddress}:${addr.port}`);
}
Promise<{ipAddress: string, port: number} | null>
securityDetails
Returns SSL and other security information.
const details = await response.securityDetails();
if (details) {
console.log('Protocol:', details.protocol);
console.log('Issuer:', details.issuer);
}
Promise<Object | null>
httpVersion
Returns the HTTP version.
const version = await response.httpVersion();
console.log(version); // 'HTTP/1.1', 'HTTP/2', etc.
Promise<string>
Example Usage
Monitor API Responses
page.on('response', async response => {
if (response.url().includes('/api/')) {
console.log('API Response:', response.status());
const data = await response.json();
console.log('Data:', data);
}
});
Check Response Status
page.on('response', response => {
if (!response.ok()) {
console.log('Failed response:', response.url(), response.status());
}
});
page.on('response', async response => {
const contentType = await response.headerValue('content-type');
console.log('Content-Type:', contentType);
});
Wait for Specific Response
const response = await page.waitForResponse(resp =>
resp.url().includes('/api/data') && resp.status() === 200
);
const data = await response.json();
console.log(data);
