In a Puppeteer request event handler, call request.isNavigationRequest(). It returns true when that request drives navigation of its current frame.
Check the request in the page event handler
The page’s request event provides an HTTPRequest object. Call the navigation method directly on that object:
As an Amazon Associate I earn from qualifying purchases.
page.on('request', request => {
if (request.isNavigationRequest()) {
console.log('This request drives navigation of its current frame:', request.url());
}
});The Puppeteer API reference consulted is labeled version 25.12.0. If compatibility matters, check the reference for the version installed in your project: Puppeteer HTTPRequest API.
Do these 3 things before closing this tab:
1Repair Windows errors before they cause bigger problems2Scan for outdated or missing drivers - takes under a minute3Clear out junk files and repair common Windows errorsWhat a true result means
The method answers one specific question: is this request the driver of the current frame’s navigation? It does not determine navigation from the URL, HTTP method, or resource type. An HTTPRequest also exposes separate properties and methods such as frame(), resourceType(), method(), and url(); those can provide context, but they are not substitutes for the documented navigation predicate.
#1 Best Overall
Keep navigation status separate from request outcome
isNavigationRequest() does not say whether the request succeeded. Puppeteer reports request completion and failure through separate lifecycle events:
requestfinishedfires after the response body has been downloaded.requestfailedfires when a request fails.
An HTTP error response such as 404 or 503 can still complete the HTTP request lifecycle and lead to requestfinished. Use the appropriate lifecycle event when you need to track completion or failure rather than inferring an outcome from the navigation boolean.
Rank #2
Or skip the browser setup
If your goal is to obtain a webpage screenshot rather than inspect Puppeteer’s request events, ScreenshotNeo offers a one-call screenshot API. For example, using cURL:
Recommended Free Tools
Quick Recap
Best Value
- Used Book in Good Condition
curl -G "https://api.screenshotneo.com/v1/shot" -d access_key=YOUR_API_KEY --data-urlencode url=https://stripe.com -o shot.webpSee the ScreenshotNeo API documentation for options. Cookie banners, popups, and chat widgets are removed before capture; bot checks, blank pages, and failed loads are never billed. Its MCP server lets AI agents take screenshots. The free plan includes 1,000 screenshots a month with no card, and paid plans start at $5 for 3,000. Sign up for free.
Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.
