Skip to main content
Version: Next

LaunchOptions interface

Generic launch options that can be passed when launching any browser.

Signature:

export interface LaunchOptions

Properties

PropertyModifiersTypeDescription
channel?ChromeReleaseChannel(Optional) Chrome Release Channel
dumpio?boolean(Optional) If true, pipes the browser process stdout and stderr to process.stdout and process.stderr.
env?Record<string, string | undefined>(Optional) Specify environment variables that will be visible to the browser.
executablePath?string(Optional) Path to a browser executable to use instead of the bundled Chromium. Note that Puppeteer is only guaranteed to work with the bundled Chromium, so use this setting at your own risk.
extraPrefsFirefox?Record<string, unknown>(Optional) Additional preferences that can be passed when launching with Firefox.
handleSIGHUP?boolean(Optional) Close the browser process on SIGHUP.
handleSIGINT?boolean(Optional) Close the browser process on Ctrl+C.
handleSIGTERM?boolean(Optional) Close the browser process on SIGTERM.
ignoreDefaultArgs?boolean | string[](Optional) If true, do not use puppeteer.defaultArgs() when creating a browser. If an array is provided, these args will be filtered out. Use this with care - you probably want the default arguments Puppeteer uses.
pipe?boolean(Optional) Connect to a browser over a pipe instead of a WebSocket.
product?Product(Optional) Which browser to launch.
timeout?number(Optional) Maximum time in milliseconds to wait for the browser to start. Pass 0 to disable the timeout.
waitForInitialPage?boolean(Optional) Whether to wait for the initial page to be ready. Useful when a user explicitly disables that (e.g. --no-startup-window for Chrome).