PuppeteerNode 类

¥PuppeteerNode class

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

¥Extends the main Puppeteer class with Node specific behaviour for fetching and downloading browsers.

如果你在 Node 环境中使用 Puppeteer，则这是你在运行 require('puppeteer')（或等效的 ES import）时获得的类。

¥If you're using Puppeteer in a Node environment, this is the class you'll get when you run require('puppeteer') (or the equivalent ES import).

签名

¥Signature

export declare class PuppeteerNode extends Puppeteer

Extends: Puppeteer

备注

¥Remarks

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

¥The most common method to use is launch, which is used to launch and connect to a new browser instance.

所有环境通用的方法请参见 主 Puppeteer 类，例如 Puppeteer.connect()。

¥See the main Puppeteer class for methods common to all environments, such as Puppeteer.connect().

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

¥The constructor for this class is marked as internal. Third-party code should not call the constructor directly or create subclasses that extend the PuppeteerNode class.

示例

¥Example

以下是使用 Puppeteer 驱动自动化的典型示例：

¥The following is a typical example of using Puppeteer to drive automation:

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 文档 列出了所有可用的方法。

¥Once you have created a page you have access to a large API to interact with the page, navigate, or find certain elements in that page. The page documentation lists all the available methods.

属性

¥Properties

属性	修饰符	类型	描述
defaultBrowser	readonly	SupportedBrowser	默认情况下启动的浏览器的名称。对于 puppeteer，这受你的配置影响。否则就是 chrome。
lastLaunchedBrowser	readonly	SupportedBrowser	最后启动的浏览器的名称。
product	readonly, deprecated	string	已弃用： 不要用作此字段，因为它没有考虑不同类型的多个浏览器。使用 defaultBrowser 或 lastLaunchedBrowser。

方法

¥Methods

方法	修饰符	描述
connect(options)		此方法将 Puppeteer 附加到现有浏览器实例。
defaultArgs(options)
executablePath(channel)		给定 ChromeReleaseChannel 的默认可执行路径。
executablePath(options)		给定 LaunchOptions 的默认可执行路径。
executablePath()		默认可执行路径。
launch(options)		在指定时启动具有给定参数和选项的浏览器实例。 与 puppeteer-core、options.executablePath 或 options.channel 一起使用时，必须提供。 评论： Puppeteer 也可用于控制 Chrome 浏览器，但它与默认下载的 Chrome 测试版本配合使用效果最佳。不保证它可以与任何其他版本一起使用。如果首选 Google Chrome（而不是用于测试的 Chrome），则建议使用 Chrome Canary 或 开发通道 版本。有关 Chromium 和 Chrome 之间差异的说明，请参阅 本文。本文 描述了 Linux 用户的一些差异。Chrome 测试说明见 这个文档。
trimCache()		删除由提供的 Puppeteer 配置标识的缓存目录中的所有非当前 Firefox 和 Chrome 二进制文件。当前浏览器版本是通过解析 Puppeteer 中的 PUPPETEER_REVISIONS 来确定的，除非提供了 configuration.browserRevision。 评论： 请注意，该方法不会检查主机上安装的使用相同缓存目录的任何其他 Puppeteer 版本是否需要非当前二进制文件。