Electron

Playwright 对 Electron 自动化提供实验性支持。您可以通过以下方式访问 electron 命名空间：

const { _electron } = require('playwright');

一个 Electron 自动化脚本的示例是：

const { _electron: electron } = require('playwright');

(async () => {
  // Launch Electron app.
  const electronApp = await electron.launch({ args: ['main.js'] });

  // Evaluation expression in the Electron context.
  const appPath = await electronApp.evaluate(async ({ app }) => {
    // This runs in the main Electron process, parameter here is always
    // the result of the require('electron') in the main app script.
    return app.getAppPath();
  });
  console.log(appPath);

  // Get the first window that the app opens, wait if necessary.
  const window = await electronApp.firstWindow();
  // Print the title.
  console.log(await window.title());
  // Capture a screenshot.
  await window.screenshot({ path: 'intro.png' });
  // Direct Electron console to Node terminal.
  window.on('console', console.log);
  // Click button.
  await window.click('text=Click me');
  // Exit app.
  await electronApp.close();
})();

支持的 Electron 版本是：

v12.2.0+
v13.4.0+
v14+

已知问题

如果您无法启动 Electron 并在启动过程中遇到超时，请尝试以下方法：

确保 nodeCliInspect (FuseV1Options.EnableNodeCliInspectArguments) fuse 未设置为 false。

方法

launch

添加于：v1.9

electron.launch

使用 executablePath 指定的 Electron 应用程序。

用法

await electron.launch();
await electron.launch(options);

参数

options Object (可选)
- acceptDownloads boolean (可选)添加于：v1.12#
  
  是否自动下载所有附件。默认为 true，即接受所有下载。
- args Array<string> (可选)#
  
  启动应用程序时要传递的附加参数。通常在此处传递主脚本名称。
- bypassCSP boolean (可选)添加于：v1.12#
  
  切换是否绕过页面的内容安全策略（Content-Security-Policy）。默认为 false。
- colorScheme null | "light" | "dark" | "no-preference" (可选)添加于：v1.12#
  
  模拟 prefers-colors-scheme 媒体特性，支持的值为 'light' 和 'dark'。详见 page.emulateMedia()。传递 null 将仿真重置为系统默认值。默认为 'light'。
- cwd string (可选)#
  
  启动应用程序的当前工作目录。
- env Object<string, string> (可选)#
  
  指定 Electron 可见的环绕变量。默认为 process.env。
- executablePath string (可选)#
  
  启动指定的 Electron 应用程序。如果未指定，则启动安装在此包中的默认 Electron 可执行文件，位于 node_modules/.bin/electron。
- extraHTTPHeaders Object<string, string> (可选)添加于：v1.12#
  
  一个包含附加 HTTP 头部信息的对象，这些头部信息将随每个请求发送。默认为空。
- geolocation Object (可选)添加于：v1.12#
  - latitude number
    
    纬度，介于 -90 到 90 之间。
  - longitude number
    
    经度，介于 -180 到 180 之间。
  - accuracy number (可选)
    
    非负精度值。默认为 0。
- httpCredentials Object (可选)添加于：v1.12#
  - username string
  - password string
  - origin string (可选)
    
    限制在特定 origin (scheme://host:port).
  - send "unauthorized" | "always" (可选)
    
    此选项仅适用于从相应的 APIRequestContext 发送的请求，不影响从浏览器发送的请求。'always' - 每次 API 请求都会发送带有基本身份验证凭据的 Authorization 头部。'unauthorized - 只有收到带有 WWW-Authenticate 头部信息的 401 (Unauthorized) 响应时，才会发送凭据。默认为 'unauthorized'。
  HTTP 身份验证的凭据。如果未指定 origin，用户名和密码将在收到未经授权的响应时发送给任何服务器。
- ignoreHTTPSErrors boolean (可选)添加于：v1.12#
  
  发送网络请求时是否忽略 HTTPS 错误。默认为 false。
- locale string (可选)添加于：v1.12#
  
  指定用户区域设置，例如 en-GB, de-DE 等。区域设置会影响 navigator.language 的值、Accept-Language 请求头部的值以及数字和日期格式化规则。默认为系统默认区域设置。在我们的仿真指南中了解更多关于仿真的信息。
- offline boolean (可选)添加于：v1.12#
  
  是否模拟网络处于离线状态。默认为 false。了解更多关于网络仿真的信息。
- recordHar Object (可选)添加于：v1.12#
  - omitContent boolean (可选)
    
    可选设置，用于控制是否从 HAR 中省略请求内容。默认为 false。已弃用，请改用 content 策略。
  - content "omit" | "embed" | "attach" (可选)
    
    可选设置，用于控制资源内容管理。如果指定 omit，则内容不会持久化。如果指定 attach，资源将作为单独文件或 ZIP 归档中的条目进行持久化。如果指定 embed，内容将根据 HAR 规范存储在 HAR 文件中。对于 .zip 输出文件，默认为 attach；对于所有其他文件扩展名，默认为 embed。
  - path string
    
    要写入 HAR 文件的文件系统路径。如果文件名以 .zip 结尾，默认使用 content: 'attach'。
  - mode "full" | "minimal" (可选)
    
    当设置为 minimal 时，仅记录从 HAR 进行路由所需的信息。这将省略大小、时间、页面、cookie、安全以及其他在从 HAR 回放时不使用的 HAR 信息类型。默认为 full。
  - urlFilter string | RegExp (可选)
    
    用于过滤存储在 HAR 中的请求的 glob 或正则表达式模式。当通过 context options 提供 baseURL 且传递的 URL 是一个路径时，它将通过 new URL() 构造函数进行合并。默认为无。
  启用所有页面的 HAR 记录到 recordHar.path 文件。如果未指定，则不记录 HAR。确保等待 browserContext.close() 以保存 HAR。
- recordVideo Object (可选)添加于：v1.12#
  - dir string
    
    存放视频的目录路径。
  - size Object (可选)
    - width number
      
      视频帧宽度。
    - height number
      
      视频帧高度。
    录制视频的可选尺寸。如果未指定，尺寸将等于按比例缩小到 800x800 以内的 viewport。如果未明确配置 viewport，视频尺寸默认为 800x450。如有必要，每页的实际图像将按比例缩小以适应指定尺寸。
  启用所有页面的视频录制到 recordVideo.dir 目录。如果未指定，则不录制视频。确保等待 browserContext.close() 以保存视频。
- timeout number (可选)添加于：v1.15#
  
  等待应用程序启动的最大毫秒数。默认为 30000 (30 秒)。传递 0 表示禁用超时。
- timezoneId string (可选)添加于：v1.12#
  
  更改 context 的时区。有关支持的时区 ID 列表，请参阅 ICU 的 metaZones.txt。默认为系统时区。
- tracesDir string (可选)添加于：v1.36#
  
  如果指定，跟踪信息将保存到此目录中。

返回值

Promise<ElectronApplication>#

方法​

launch​

方法

launch