Important: This documentation is about an older version. It's relevant only to the release noted, many of the features and functions have been updated or replaced. Please view the current version.
page.on(“requestfailed”)
Subscribe to the requestfailed event, which fires when a network request fails to reach the server.
This event is triggered when requests encounter network-level failures such as DNS errors, connection refused, timeouts, or other network problems. It does not fire for HTTP 4xx/5xx responses, which are considered successful network requests.
Handler Parameters
Request Object Properties
The handler receives a Request object with the following useful properties:
Request Failure Information
The request.failure() method returns an object with the following property:
Examples
Basic usage
import { browser } from 'k6/browser';
export const options = {
scenarios: {
ui: {
executor: 'shared-iterations',
options: {
browser: {
type: 'chromium',
},
},
},
},
};
export default async function () {
const page = await browser.newPage();
// Track all failed requests
const failedRequests = [];
page.on('requestfailed', (request) => {
const failure = request.failure();
failedRequests.push({
url: request.url(),
method: request.method(),
error: failure ? failure.errorText : 'unknown error',
});
console.log(`✗ Request failed: ${request.method()} ${request.url()}`);
if (failure) {
console.log(` Error: ${failure.errorText}`);
}
});
try {
// This will trigger a requestfailed event due to DNS failure
await page.goto('https://does-not-exist.invalid/');
} catch (e) {
// Navigation error expected
}
console.log(`Total failed requests: ${failedRequests.length}`);
await page.close();
}Monitoring for specific failure types
import { browser } from 'k6/browser';
export const options = {
scenarios: {
ui: {
executor: 'shared-iterations',
options: {
browser: {
type: 'chromium',
},
},
},
},
};
export default async function () {
const page = await browser.newPage();
// Track connection timeout failures specifically
const timeoutFailures = [];
page.on('requestfailed', (request) => {
const failure = request.failure();
if (failure && failure.errorText.toLowerCase().includes('timeout')) {
timeoutFailures.push({
url: request.url(),
error: failure.errorText,
timestamp: new Date().toISOString(),
});
console.log(`Timeout: ${failure.errorText} for ${request.url()}`);
}
});
// Perform actions that might cause timeouts
await page.goto('https://test.k6.io/');
console.log(`Timeout failures: ${timeoutFailures.length}`);
await page.close();
}Best practices
Setup before navigation: Always set up the event listener before performing actions that trigger network requests:
import { browser } from 'k6/browser'; export const options = { scenarios: { ui: { executor: 'shared-iterations', options: { browser: { type: 'chromium', }, }, }, }, }; export default async function () { const page = await browser.newPage(); // CORRECT: Setup event listener before navigation page.on('requestfailed', (request) => { console.log(`Request failed: ${request.method()} ${request.url()}`); }); await page.goto('https://example.com'); await page.close(); }If you set up the event listener after navigation, you may miss early failures:
import { browser } from 'k6/browser'; export const options = { scenarios: { ui: { executor: 'shared-iterations', options: { browser: { type: 'chromium', }, }, }, }, }; export default async function () { const page = await browser.newPage(); // INCORRECT: May miss early failures since navigation happens first await page.goto('https://example.com'); page.on('requestfailed', (request) => { console.log(`Request failed: ${request.method()} ${request.url()}`); }); await page.close(); }Distinguish from other events:
- Use
page.on('request')to track when requests are initiated - Use
page.on('response')to track when responses start arriving - Use
page.on('requestfinished')to track when requests successfully complete - Use
page.on('requestfailed')to track when requests fail at the network level
- Use
Error categorization: The
failure.errorTextcan help categorize different types of network failures.Monitoring: This event is valuable for identifying network infrastructure issues during browser automation tests.
Related
- page.on() - Register handlers for page events
- page.on(“request”) - Subscribe to request initiation events
- page.on(“response”) - Subscribe to response start events
- page.on(“requestfinished”) - Subscribe to request completion events
- page.waitForEvent() - Wait for page events with predicate functions
- page.waitForRequest() - Wait for HTTP requests with URL pattern matching
- page.waitForResponse() - Wait for HTTP responses with URL pattern matching
- Request - Request object methods and properties

