跳到主要内容

页面

页面​

每个 BrowserContext 可以有多个页面。Page 指的是浏览器上下文中的单个标签页或弹出窗口。它应该用于导航到 URL 并与页面内容交互。

// Create a page.
var page = await context.NewPageAsync();

// Navigate explicitly, similar to entering a URL in the browser.
await page.GotoAsync("http://example.com");
// Fill an input.
await page.Locator("#search").FillAsync("query");

// Navigate implicitly by clicking a link.
await page.Locator("#submit").ClickAsync();
// Expect a new url.
Console.WriteLine(page.Url);

多个页面​

每个浏览器上下文可以托管多个页面（标签页）。

  • 每个页面的行为都像一个焦点集中的活动页面。不需要将页面置于前台。
  • 上下文中的页面遵循上下文级别的模拟，例如视口大小、自定义网络路由或浏览器区域设置。
// Create two pages
var pageOne = await context.NewPageAsync();
var pageTwo = await context.NewPageAsync();

// Get pages of a browser context
var allPages = context.Pages;

处理新页面​

浏览器上下文上的 page 事件可用于获取在该上下文中创建的新页面。这可以用于处理由 target="_blank" 链接打开的新页面。

// Get page after a specific action (e.g. clicking a link)
var newPage = await context.RunAndWaitForPageAsync(async () =>
{
    await page.GetByText("open new tab").ClickAsync();
});
// Interact with the new page normally
await newPage.GetByRole(AriaRole.Button).ClickAsync();
Console.WriteLine(await newPage.TitleAsync());

如果触发新页面的操作未知，可以使用以下模式。

// Get all new pages (including popups) in the context
context.Page += async  (_, page) => {
    await page.WaitForLoadStateAsync();
    Console.WriteLine(await page.TitleAsync());
};

处理弹出窗口​

如果页面打开一个弹出窗口（例如，由 target="_blank" 链接打开的页面），您可以通过监听页面上的 popup 事件来获取对其的引用。

此事件除了 browserContext.on('page') 事件之外还会发出，但仅针对与此页面相关的弹出窗口。

// Get popup after a specific action (e.g., click)
var popup = await page.RunAndWaitForPopupAsync(async () =>
{
    await page.GetByText("open the popup").ClickAsync();
});
// Interact with the popup normally
await popup.GetByRole(AriaRole.Button).ClickAsync();
Console.WriteLine(await popup.TitleAsync());

如果触发弹出窗口的操作未知，可以使用以下模式。

// Get all popups when they open
page.Popup += async  (_, popup) => {
    await popup.WaitForLoadStateAsync();
    Console.WriteLine(await page.TitleAsync());
};