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 |
| 默认启动的浏览器的名称。对于 | |
lastLaunchedBrowser |
| 上次启动的浏览器的名称。 | |
product |
| string | 已弃用 请勿使用此字段,因为它不考虑不同类型的多个浏览器。使用 defaultBrowser 或 lastLaunchedBrowser。 |
方法
方法 | 修饰符 | 描述 |
---|---|---|
connect(options) | 此方法将 Puppeteer 附加到现有的浏览器实例。 | |
defaultArgs(options) | ||
executablePath(channel) | 给定 ChromeReleaseChannel 的默认可执行文件路径。 | |
executablePath(options) | 给定 LaunchOptions 的默认可执行文件路径。 | |
executablePath() | 默认可执行文件路径。 | |
launch(options) | 使用给定的参数和选项(如果指定)启动浏览器实例。 与 备注 Puppeteer 也可用于控制 Chrome 浏览器,但它与默认下载的 Chrome for Testing 版本配合效果最佳。不保证它与其他任何版本一起工作。如果首选 Google Chrome(而不是 Chrome for Testing),建议使用 Chrome Canary 或 Dev Channel 构建。有关 Chromium 和 Chrome 之间差异的描述,请参阅 这篇文章。这篇文章描述了 Linux 用户的一些差异。有关 Chrome for Testing 的描述,请参阅 此文档。 | |
trimCache() | 删除缓存目录中由提供的 Puppeteer 配置标识的所有非当前 Firefox 和 Chrome 二进制文件。当前的浏览器版本是通过解析 Puppeteer 中的 PUPPETEER_REVISIONS 来确定的,除非提供了 备注 请注意,该方法不检查主机上安装的任何其他 Puppeteer 版本是否需要使用相同缓存目录的非当前二进制文件。 |