Skip to main content

Dialog

Dialog 对象通过 page.on('dialog') 事件按页分派。

¥Dialog objects are dispatched by page via the page.on('dialog') event.

使用 Dialog 类的示例：

¥An example of using Dialog class:

const { chromium } = require('playwright');  // Or 'firefox' or 'webkit'.

(async () => {
  const browser = await chromium.launch();
  const page = await browser.newPage();
  page.on('dialog', async dialog => {
    console.log(dialog.message());
    await dialog.dismiss();
  });
  await page.evaluate(() => alert('1'));
  await browser.close();
})();
注意

除非有 page.on('dialog') 监听器，否则对话框会自动关闭。当监听器存在时，它必须是 dialog.accept() 或 dialog.dismiss() 对话框 - 否则页面将 freeze 等待对话框，并且单击等操作将永远不会完成。

¥Dialogs are dismissed automatically, unless there is a page.on('dialog') listener. When listener is present, it must either dialog.accept() or dialog.dismiss() the dialog - otherwise the page will freeze waiting for the dialog, and actions like click will never finish.

方法​

¥Methods

accept​

Added in: v1.8 dialog.accept

当对话框被接受时返回。

¥Returns when the dialog has been accepted.

用法

¥Usage

await dialog.accept();
await dialog.accept(promptText);

参数

¥Arguments

在提示中输入的文本。如果对话框的 type 没有提示，不会造成任何影响。可选的。

¥A text to enter in prompt. Does not cause any effects if the dialog's type is not prompt. Optional.

返回

¥Returns

defaultValue​

Added in: v1.8 dialog.defaultValue

如果对话框有提示，则返回默认提示值。否则，返回空字符串。

¥If dialog is prompt, returns default prompt value. Otherwise, returns empty string.

用法

¥Usage

dialog.defaultValue();

返回

¥Returns

dismiss​

Added in: v1.8 dialog.dismiss

当对话框关闭时返回。

¥Returns when the dialog has been dismissed.

用法

¥Usage

await dialog.dismiss();

返回

¥Returns

message​

Added in: v1.8 dialog.message

对话框中显示一条消息。

¥A message displayed in the dialog.

用法

¥Usage

dialog.message();

返回

¥Returns

page​

Added in: v1.34 dialog.page

启动此对话框的页面（如果可用）。

¥The page that initiated this dialog, if available.

用法

¥Usage

dialog.page();

返回

¥Returns

type​

Added in: v1.8 dialog.type

返回对话框的类型，可以是 alert、beforeunload、confirm 或 prompt 之一。

¥Returns dialog's type, can be one of alert, beforeunload, confirm or prompt.

用法

¥Usage

dialog.type();

返回

¥Returns