Skip to main content

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() 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

Dialog.accept();
Dialog.accept(promptText);

Arguments

  • promptText String (optional)#

    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

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

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

Usage

Dialog.type();

Returns