Puppeteer icon

Puppeteer

Automate browser interactions using Puppeteer

Get Page Content

AI-generated

Summary

Navigates to a URL and returns the page's HTML body, response headers, and status code.

Inputs

  • url (required) — The URL to navigate to.
  • queryParameters — Query parameters to append to the URL. Each parameter has a name and value.
  • waitUntil — When to consider navigation succeeded. Defaults to 'load'.
  • timeout — Maximum navigation time in milliseconds. Pass 0 to disable timeout.
  • pageCaching — Whether to enable page level caching. Defaults to true.
  • headless — Whether to run the browser in headless mode. Defaults to true.
  • stealth — When enabled, applies techniques to make headless Puppeteer harder to detect.
  • proxyServer — Custom proxy configuration for Puppeteer (e.g., 'localhost:8080' or 'socks5://localhost:1080').
  • addContainerArgs — When enabled (default), adds recommended Chrome launch arguments for container environments.
  • browserWSEndpoint — WebSocket URL of an existing browser instance to connect to. Skips browser launch.
  • protocol — Protocol for connecting to the browser. Defaults to 'cdp'. Use 'webDriverBiDi' for Firefox support.
  • device — Emulate a specific device's viewport and touch settings.
  • executablePath — Path where Puppeteer expects to find the bundled browser. Has no effect when Browser WebSocket Endpoint is set.
  • launchArguments — Additional command line arguments to pass to the browser instance.

Output shape

array

Each item contains the page's HTML content and navigation metadata, one per input item. If navigation fails (no response or status >= 400), an error is returned instead via the node's error handling path. The operation processes items in batches defined by the 'Batch Size' option (default 1).

Examples

Example 1: Fetch HTML of a page and retrieve its status code and headers.

Set URL to the target site; leave other parameters at defaults. The node returns an array with one item containing the page's body, headers, and status code in the JSON field.

Links

Discussion