跳到主要内容
版本:23.11.1

PuppeteerNode 类

扩展了主 Puppeteer 类,添加了 Node 特定的行为,用于获取和下载浏览器。

如果您在 Node 环境中使用 Puppeteer,当您运行 require('puppeteer') (或等效的 ES import) 时,您将获得此类。

签名

export declare class PuppeteerNode extends Puppeteer

继承自: Puppeteer

备注

最常用的方法是 launch,它用于启动并连接到新的浏览器实例。

有关所有环境通用的方法,例如 Puppeteer.connect(),请参阅 主 Puppeteer 类

此类的构造函数标记为内部使用。第三方代码不应直接调用构造函数或创建扩展 PuppeteerNode 类的子类。

示例

以下是使用 Puppeteer 进行自动化的典型示例

import puppeteer from 'puppeteer';

(async () => {
const browser = await puppeteer.launch();
const page = await browser.newPage();
await page.goto('https://www.google.com');
// other actions...
await browser.close();
})();

创建 page 后,您可以访问大量的 API 来与页面交互、导航或查找页面中的某些元素。`page` 文档列出了所有可用的方法。

属性

属性

修饰符

类型

描述

defaultBrowser

只读

SupportedBrowser

默认启动的浏览器的名称。对于 puppeteer,这受您的配置影响。否则,它为 chrome

lastLaunchedBrowser

只读

SupportedBrowser

上次启动的浏览器的名称。

product

只读,已弃用

string

已弃用

请勿使用此字段,因为它不考虑不同类型的多个浏览器。使用 defaultBrowserlastLaunchedBrowser

方法

方法

修饰符

描述

connect(options)

此方法将 Puppeteer 附加到现有的浏览器实例。

defaultArgs(options)
executablePath(channel)

给定 ChromeReleaseChannel 的默认可执行文件路径。

executablePath(options)

给定 LaunchOptions 的默认可执行文件路径。

executablePath()

默认可执行文件路径。

launch(options)

使用给定的参数和选项(如果指定)启动浏览器实例。

puppeteer-core 一起使用时,必须提供 options.executablePathoptions.channel

备注

Puppeteer 也可用于控制 Chrome 浏览器,但它与默认下载的 Chrome for Testing 版本配合效果最佳。不保证它与其他任何版本一起工作。如果首选 Google Chrome(而不是 Chrome for Testing),建议使用 Chrome CanaryDev Channel 构建。有关 Chromium 和 Chrome 之间差异的描述,请参阅 这篇文章这篇文章描述了 Linux 用户的一些差异。有关 Chrome for Testing 的描述,请参阅 此文档

trimCache()

删除缓存目录中由提供的 Puppeteer 配置标识的所有非当前 Firefox 和 Chrome 二进制文件。当前的浏览器版本是通过解析 Puppeteer 中的 PUPPETEER_REVISIONS 来确定的,除非提供了 configuration.browserRevision

备注

请注意,该方法不检查主机上安装的任何其他 Puppeteer 版本是否需要使用相同缓存目录的非当前二进制文件。