📄 playwright-python/dotnet/docs/api/class-dialog

File: class-dialog.md | Updated: 11/18/2025

Source: https://playwright.dev/dotnet/docs/api/class-dialog

Skip to main content

On this page

Dialog objects are dispatched by page via the Page.Dialog event.

An example of using Dialog class:

using Microsoft.Playwright;using System.Threading.Tasks;class DialogExample{    public static async Task Run()    {        using var playwright = await Playwright.CreateAsync();        await using var browser = await playwright.Chromium.LaunchAsync();        var page = await browser.NewPageAsync();        page.Dialog += async (_, dialog) =>        {            System.Console.WriteLine(dialog.Message);            await dialog.DismissAsync();        };        await page.EvaluateAsync("alert('1');");    }}

note

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

Methods​

AcceptAsync​

Added before v1.9 dialog.AcceptAsync

Returns when the dialog has been accepted.

Usage

await Dialog.AcceptAsync(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 before v1.9 dialog.DefaultValue

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

Usage

Dialog.DefaultValue

Returns

DismissAsync​

Added before v1.9 dialog.DismissAsync

Returns when the dialog has been dismissed.

Usage

await Dialog.DismissAsync();

Returns

Message​

Added before v1.9 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 before v1.9 dialog.Type

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

Usage

Dialog.Type

Returns