Skip to main content
Version: 22.9.0

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

属性

修饰符

类型

描述

defaultProduct

readonly

Product

默认情况下启动的浏览器的名称。对于 puppeteer,这受你的配置影响。否则就是 chrome

lastLaunchedProduct

readonly

Product

最后启动的浏览器的名称。

product

readonly, deprecated

string

已弃用:

不要用作此字段,因为它没有考虑不同类型的多个浏览器。使用 defaultProductlastLaunchedProduct

方法

¥Methods

方法

修饰符

描述

connect(options)

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

defaultArgs(options)
executablePath(channel)

默认可执行路径。

launch(options)

在指定时启动具有给定参数和选项的浏览器实例。

puppeteer-coreoptions.executablePathoptions.channel 一起使用时,必须提供。

评论:

Puppeteer 也可用于控制 Chrome 浏览器,但它与默认下载的 Chrome 测试版本配合使用效果最佳。不保证它可以与任何其他版本一起使用。如果首选 Google Chrome(而不是用于测试的 Chrome),则建议使用 Chrome Canary开发通道 版本。有关 Chromium 和 Chrome 之间差异的说明,请参阅 本文本文 描述了 Linux 用户的一些差异。Chrome 测试说明见 这个文档

trimCache()

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

评论:

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