Interface IDialog

Namespace

Microsoft.Playwright

Assembly

Microsoft.Playwright.dll

IDialog objects are dispatched by page via the 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');");
}

}

public interface IDialog

Remarks

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

Properties

DefaultValue

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

string DefaultValue { get; }

Property Value

string

Message

A message displayed in the dialog.

string Message { get; }

Property Value

string

Page

The page that initiated this dialog, if available.

IPage? Page { get; }

Property Value

IPage

Type

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

string Type { get; }

Property Value

string

Methods

AcceptAsync(string?)

Returns when the dialog has been accepted.

Task AcceptAsync(string? promptText = null)

Parameters

promptText string

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

Returns

Task

DismissAsync()

Returns when the dialog has been dismissed.

Task DismissAsync()

Returns

Task