Dialog
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');");
}
}
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 in: v1.8Returns 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.
DefaultValue
Added in: v1.8If dialog is prompt, returns default prompt value. Otherwise, returns empty string.
Usage
Dialog.DefaultValue
Returns
DismissAsync
Added in: v1.8Returns when the dialog has been dismissed.
Usage
await Dialog.DismissAsync();
Message
Added in: v1.8A message displayed in the dialog.
Usage
Dialog.Message
Returns
Page
Added in: v1.34The page that initiated this dialog, if available.
Usage
Dialog.Page
Returns
Type
Added in: v1.8Returns dialog's type, can be one of alert
, beforeunload
, confirm
or prompt
.
Usage
Dialog.Type
Returns