Skip to main content
Version: 1.22

Dialog

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

An example of using Dialog class:

from playwright.sync_api import sync_playwright

def handle_dialog(dialog):
print(dialog.message)
dialog.dismiss()

def run(playwright):
chromium = playwright.chromium
browser = chromium.launch()
page = browser.new_page()
page.on("dialog", handle_dialog)
page.evaluate("alert('1')")
browser.close()

with sync_playwright() as playwright:
run(playwright)
note

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

dialog.accept(**kwargs)

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

Returns when the dialog has been accepted.

dialog.default_value

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.