Skip to main content

對話框

簡介​

Playwright 可以與網頁對話框互動，例如 alert、confirm、prompt 以及 beforeunload 確認。關於列印對話框，請參見 Print。

alert(), confirm(), prompt() 對話框​

預設情況下，對話框會被 Playwright 自動關閉，所以你不需要處理它們。然而，你可以在觸發對話框的操作之前註冊一個對話框處理器來Dialog.accept()或Dialog.dismiss()。

page.onDialog(dialog -> dialog.accept());
page.getByRole(AriaRole.BUTTON).click();
note

Page.onDialog(handler) 監聽器必須處理對話框。否則你的操作將會停滯，不管是 Locator.click() 還是其他操作。這是因為網頁中的對話框通常為模態視窗 (modal dialog)，會阻擋進一步的頁面執行，直到它們被處理為止。

由此可見，以下程式碼片段將永遠無法解析:

warning

錯誤！

page.onDialog(dialog -> System.out.println(dialog.message()));
page.getByRole(AriaRole.BUTTON).click(); // Will hang here
note

如果沒有 Page.onDialog(handler) 的監聽器，所有對話框將自動關閉。

beforeunload 對話框​

當 Page.close() 被呼叫並帶有真值的 runBeforeUnload 值時，頁面會執行其卸載處理程式。這是唯一一種 Page.close() 不會等待頁面實際關閉的情況，因為在操作結束時頁面可能會保持開啟。

您可以註冊一個對話框處理器來自行處理 beforeunload 對話框:

page.onDialog(dialog -> {
  assertEquals("beforeunload", dialog.type());
  dialog.dismiss();
});
page.close(new Page.CloseOptions().setRunBeforeUnload(true));

列印對話框​

為了確認透過 window.print 觸發的列印對話框，你可以使用以下程式碼片段:

page.navigate("<url>");

page.evaluate("(() => {window.waitForPrintDialog = new Promise(f => window.print = f);})()");
page.getByText("Print it!").click();

page.waitForFunction("window.waitForPrintDialog");

這將在按鈕被點擊後等待列印對話框被打開。確保在點擊按鈕之前/頁面載入後評估腳本。