Skip to main content
Version: 1.15

Dialog

Dialog objects are dispatched by page via the event 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 event Page.Dialog listener. When listener is present, it must either Dialog.AcceptAsync(promptText) or Dialog.DismissAsync() the dialog - otherwise the page will freeze waiting for the dialog, and actions like click will never finish.

Dialog.AcceptAsync(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.DismissAsync()#

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.