LaunchOptions 接口
启动任何浏览器时可以传递的通用启动选项。
签名:
export interface LaunchOptions
属性
属性 | 修饰符 | 类型 | 描述 | 默认值 |
---|---|---|---|---|
channel | 可选 | ChromeReleaseChannel | Chrome 发布渠道 | |
dumpio | 可选 | 布尔值 | 如果为真,将浏览器进程 stdout 和 stderr 管道传输到 process.stdout 和 process.stderr 。 | false |
env | 可选 | Record<string, string | undefined> | 指定浏览器可见的环境变量。 | process.env 的内容。 |
executablePath | 可选 | string | 浏览器可执行文件的路径,用于代替捆绑的 Chromium。请注意,Puppeteer 仅保证与捆绑的 Chromium 一起使用,因此请自行承担使用此设置的风险。 | |
extraPrefsFirefox | 可选 | Record<string, unknown> | 其他首选项,可在使用 Firefox 启动时传递。 | |
handleSIGHUP | 可选 | 布尔值 | 在 SIGHUP 上关闭浏览器进程。 | true |
handleSIGINT | 可选 | 布尔值 | 在 Ctrl+C 上关闭浏览器进程。 | true |
handleSIGTERM | 可选 | 布尔值 | 在 SIGTERM 上关闭浏览器进程。 | true |
ignoreDefaultArgs | 可选 | boolean | string[] | 如果为 true ,则在创建浏览器时不使用 puppeteer.defaultArgs() 。如果提供了数组,则将过滤掉这些参数。请谨慎使用 - 你可能需要 Puppeteer 使用的默认参数。 | false |
pipe | 可选 | 布尔值 | 通过管道连接到浏览器,而不是 WebSocket。 | false |
product | 可选 | Product | 启动哪个浏览器。 | chrome |
timeout | 可选 | number | 等待浏览器启动的最大时间(以毫秒为单位)。传递 0 以禁用超时。 | 30_000 (30 秒)。 |
waitForInitialPage | 可选 | 布尔值 | 是否等待初始页面就绪。当用户明确禁用该页面时很有用(例如 Chrome 的 --no-startup-window )。 | true |