Being an end-user product, puppeteer supports a bunch of convenient PUPPETEER_* env variables to tweak its behavior. When installed, it downloads a version ofĬhromium, which it then drives using puppeteer-core. Puppeteer is a product for browser automation. puppeteer-core Įvery release since v1.7.0 we publish two packages:

PUPPETEER_* env variables are not accounted for in puppeteer-core. It works without any problems, however, with this option, you should get more efficient resource usage (CPU and RAM) that could lead to a faster execution time. On Apple M1 devices Puppeteer by default downloads the version for Intel's processor which runs via Rosetta.

PUPPETEER_EXPERIMENTAL_CHROMIUM_MAC_ARM - specify Puppeteer download Chromium for Apple M1.

The product is exposed in puppeteer.product Setting product programmatically in puppeteer.launch supersedes this environment variable. This can also be used during installation to fetch the recommended browser binary.

PUPPETEER_PRODUCT - specify which browser you'd like Puppeteer to use.

PUPPETEER_EXECUTABLE_PATH - specify an executable path to be used in puppeteer.launch.

See puppeteer.launch on how executable path is inferred.

PUPPETEER_CHROMIUM_REVISION - specify a certain version of Chromium you'd like Puppeteer to use.

Defaults to /.local-chromium, where is Puppeteer's package root.

PUPPETEER_DOWNLOAD_PATH - overwrite the path for the downloads folder.

Note: this includes protocol and might even include path prefix.

PUPPETEER_DOWNLOAD_HOST - overwrite URL prefix that is used to download Chromium.

PUPPETEER_TMP_DIR - defines the directory to be used by Puppeteer for creating temporary files.

PUPPETEER_SKIP_CHROMIUM_DOWNLOAD - do not download bundled Chromium during installation step.

HTTP_PROXY, HTTPS_PROXY, NO_PROXY - defines HTTP proxy settings that are used to download and run the browser.

If Puppeteer doesn't find them in the environment during the installation step, a lowercased variant of these variables will be used from the npm config. Puppeteer looks for certain environment variables to aid its operations. For a version of Puppeteer purely for connection, see puppeteer-core. When you install Puppeteer, it downloads a recent version of Chromium (~170MB Mac, ~282MB Linux, ~280MB Win) that is guaranteed to work with the API (customizable through Environment Variables).

Javascript download event