跳至主要内容

ElectronApplication

Electron 应用程序表示。您可以使用 electron.launch() 获取应用程序实例。您可以使用此实例控制主 Electron 进程，以及处理 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();
})();

方法​

browserWindow​

新增于：v1.11 electronApplication.browserWindow

返回与给定 Playwright 页面对应的 BrowserWindow 对象。

用法

await electronApplication.browserWindow(page);

参数

  • page Page#

    要为其检索窗口的页面。

返回值

close​

新增于：v1.9 electronApplication.close

关闭 Electron 应用程序。

用法

await electronApplication.close();

返回值

context​

新增于：v1.9 electronApplication.context

此方法返回可用于设置上下文范围路由等操作的浏览器上下文。

用法

electronApplication.context();

返回值

evaluate​

新增于：v1.9 electronApplication.evaluate

返回 pageFunction 的返回值。

如果传递给 electronApplication.evaluate() 的函数返回一个 Promise，则 electronApplication.evaluate() 将等待此 Promise 解析并返回其值。

如果传递给 electronApplication.evaluate() 的函数返回一个非 可序列化 的值，则 electronApplication.evaluate() 返回 undefined。Playwright 还支持传输一些无法通过 JSON 序列化的附加值：-0、NaN、Infinity、-Infinity。

用法

await electronApplication.evaluate(pageFunction);
await electronApplication.evaluate(pageFunction, arg);

参数

返回值

evaluateHandle​

新增于：v1.9 electronApplication.evaluateHandle

将 pageFunction 的返回值作为 JSHandle 返回。

electronApplication.evaluate() 和 electronApplication.evaluateHandle() 之间的唯一区别在于 electronApplication.evaluateHandle() 返回 JSHandle。

如果传递给 electronApplication.evaluateHandle() 的函数返回一个 Promise，则 electronApplication.evaluateHandle() 将等待此 Promise 解析并返回其值。

用法

await electronApplication.evaluateHandle(pageFunction);
await electronApplication.evaluateHandle(pageFunction, arg);

参数

返回值

firstWindow​

新增于：v1.9 electronApplication.firstWindow

等待打开第一个应用程序窗口的便捷方法。

用法

const electronApp = await electron.launch({
  args: ['main.js']
});
const window = await electronApp.firstWindow();
// ...

参数

返回值

process​

新增于：v1.21 electronApplication.process

返回此 Electron 应用程序的主进程。

用法

electronApplication.process();

返回值

waitForEvent​

新增于：v1.9 electronApplication.waitForEvent

等待事件触发并将事件值传递给谓词函数。当谓词返回真值时返回。如果应用程序在事件触发之前关闭，则会抛出错误。返回事件数据值。

用法

const windowPromise = electronApp.waitForEvent('window');
await mainWindow.click('button');
const window = await windowPromise;

参数

  • event string#

    事件名称，与通常传递给 *.on(event) 的名称相同。

  • optionsOrPredicate function | Object (可选)#

    • predicate function

      接收事件数据，并在等待应解析时解析为真值。

    • timeout number (可选)

      以毫秒为单位的最大等待时间。默认为 30000（30 秒）。传递 0 以禁用超时。可以使用 browserContext.setDefaultTimeout() 更改默认值。

    接收事件的谓词或选项对象。可选。

返回值

窗口​

新增于：v1.9 electronApplication.windows

返回所有已打开窗口的便捷方法。

用法

electronApplication.windows();

返回值

事件​

on('close')​

新增于：v1.9 electronApplication.on('close')

当应用程序进程终止时，将发出此事件。

用法

electronApplication.on('close', data => {});

on('console')​

新增于：v1.42 electronApplication.on('console')

当 Electron 主进程中的 JavaScript 调用其中一个控制台 API 方法（例如 console.log 或 console.dir）时发出。

传递给 console.log 的参数可在 控制台消息 事件处理程序参数中获得。

用法

electronApp.on('console', async msg => {
  const values = [];
  for (const arg of msg.args())
    values.push(await arg.jsonValue());
  console.log(...values);
});
await electronApp.evaluate(() => console.log('hello', 5, { foo: 'bar' }));

事件数据

on('window')​

新增于：v1.9 electronApplication.on('window')

此事件针对 Electron 中创建**并加载**的每个窗口发出。它包含一个可用于 Playwright 自动化的 页面。

用法

electronApplication.on('window', data => {});

事件数据