Skip to content

Dialog ​

Added in: v1.8

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

An example of using Dialog class:

csharp
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');");
    }
}

INFO

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 ​

Dialog.AcceptAsync() ​

Added in: v1.8

Returns when the dialog has been accepted.

Arguments

  • promptText string (optional)

    A text to enter in prompt. Does not cause any effects if the dialog's type is not prompt. Optional.

Dialog.DefaultValue() ​

Added in: v1.8

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

Returns

  • string

Dialog.DismissAsync() ​

Added in: v1.8

Returns when the dialog has been dismissed.

Dialog.Message() ​

Added in: v1.8

A message displayed in the dialog.

Returns

  • string

Dialog.Page() ​

Added in: v1.34

The page that initiated this dialog, if available.

Returns

  • null | Page

Dialog.Type() ​

Added in: v1.8

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

Returns

  • string

Released under the Apache 2.0 License.