Skip to main content
Version: 22.9.0

Configuration 接口

¥Configuration interface

定义在安装和运行时配置 Puppeteer 行为的选项。

¥Defines options to configure Puppeteer's behavior during installation and runtime.

有关详细信息,请参阅各个属性。

¥See individual properties for more information.

签名:

¥Signature:

export interface Configuration

属性

¥Properties

属性

修饰符

类型

描述

默认

browserRevision

optional

string

指定你希望 Puppeteer 使用的浏览器的特定版本。

可以被 PUPPETEER_BROWSER_REVISION 覆盖。

请参阅 puppeteer.launch 了解如何推断可执行路径。

使用特定的浏览器版本(例如 119.0.6045.105)。如果你使用 stablecanary 等别名,它只会在安装 Puppeteer 期间起作用,并且在启动浏览器时会失败。

当前 Puppeteer 版本支持的固定浏览器版本。

cacheDirectory

optional

string

定义 Puppeteer 用于缓存的目录。

可以被 PUPPETEER_CACHE_DIR 覆盖。

path.join(os.homedir(), '.cache', 'puppeteer')

defaultProduct

optional

Product

指定你希望 Puppeteer 使用的浏览器。

可以被 PUPPETEER_PRODUCT 覆盖。

chrome

downloadBaseUrl

optional

string

指定用于下载浏览器的 URL 前缀。

可以被 PUPPETEER_DOWNLOAD_BASE_URL 覆盖。

评论:

这必须包括协议,甚至可能需要路径前缀。

https://storage.googleapis.com/chrome-for-testing-publichttps://archive.mozilla.org/pub/firefox/nightly/latest-mozilla-central,具体取决于产品。

可执行路径

optional

string

指定要在 puppeteer.launch 中使用的可执行路径。

可以被 PUPPETEER_EXECUTABLE_PATH 覆盖。

自动计算。

experiments

optional

ExperimentsConfiguration

定义 Puppeteer 的实验选项。

logLevel

optional

'silent' | '错误' | 'warn'

告诉 Puppeteer 在给定级别进行日志记录。

warn

skipChromeDownload

optional

boolean

告诉 Puppeteer 在安装过程中不要下载 Chrome。

可以被 PUPPETEER_SKIP_CHROME_DOWNLOAD 覆盖。

skipChromeHeadlessShellDownload

optional

boolean

告诉 Puppeteer 在安装过程中不要下载 chrome-headless-shell。

可以被 PUPPETEER_SKIP_CHROME_HEADLESS_SHELL_DOWNLOAD 覆盖。

skipDownload

optional

boolean

告诉 Puppeteer 在安装过程中不要下载。

可以被 PUPPETEER_SKIP_DOWNLOAD 覆盖。

temporaryDirectory

optional

string

定义 Puppeteer 用于创建临时文件的目录。

可以被 PUPPETEER_TMP_DIR 覆盖。

os.tmpdir()