Skip to main content
Version: 1.16

Dialog

Dialog objects are dispatched by page via the Page.onDialog(handler) event.

An example of using Dialog class:

import com.microsoft.playwright.*;
public class Example {  public static void main(String[] args) {    try (Playwright playwright = Playwright.create()) {      BrowserType chromium = playwright.chromium();      Browser browser = chromium.launch();      Page page = browser.newPage();      page.onDialog(dialog -> {        System.out.println(dialog.message());        dialog.dismiss();      });      page.evaluate("alert('1')");      browser.close();    }  }}
note

Dialogs are dismissed automatically, unless there is a Page.onDialog(handler) listener. When listener is present, it must either Dialog.accept([promptText]) or Dialog.dismiss() the dialog - otherwise the page will freeze waiting for the dialog, and actions like click will never finish.

Dialog.accept([promptText])#

  • promptText <String> A text to enter in prompt. Does not cause any effects if the dialog's type is not prompt. Optional.#
  • returns: <void>#

Returns when the dialog has been accepted.

Dialog.defaultValue()#

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

Dialog.dismiss()#

Returns when the dialog has been dismissed.

Dialog.message()#

A message displayed in the dialog.

Dialog.type()#

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