入门 - 库

简介

Playwright 可以与 MSTest、NUnit 或 xUnit 基类 一起使用，也可以作为 Playwright 库（本指南）。如果您正在开发利用 Playwright 功能的应用程序，或者您正在将 Playwright 与另一个测试运行器一起使用，请继续阅读。

用法

创建一个控制台项目并添加 Playwright 依赖项。

# Create project
dotnet new console -n PlaywrightDemo
cd PlaywrightDemo

# Add project dependency
dotnet add package Microsoft.Playwright
# Build the project
dotnet build
# Install required browsers - replace netX with actual output folder name, e.g. net8.0.
pwsh bin/Debug/netX/playwright.ps1 install

# If the pwsh command does not work (throws TypeNotFound), make sure to use an up-to-date version of PowerShell.
dotnet tool update --global PowerShell

创建一个 Program.cs 文件，它将导航到 https://playwright.net.cn/dotnet 并在 Chromium 中截取屏幕截图。

using Microsoft.Playwright;

using var playwright = await Playwright.CreateAsync();
await using var browser = await playwright.Chromium.LaunchAsync();
var page = await browser.NewPageAsync();
await page.GotoAsync("https://playwright.net.cn/dotnet");
await page.ScreenshotAsync(new()
{
    Path = "screenshot.png"
});

现在运行它。

dotnet run

默认情况下，Playwright 在无头模式下运行浏览器。要查看浏览器 UI，请将 Headless 选项设置为 false。您还可以使用 SlowMo 来减慢执行速度。在 调试工具 部分了解更多信息。

await using var browser = await playwright.Firefox.LaunchAsync(new()
{
    Headless = false,
    SlowMo = 50,
});

使用断言

当您使用自己的测试框架时，您可以执行以下操作来利用 Playwright 的 Web-first 断言。这些将自动重试，直到满足条件，例如元素具有特定文本或达到超时时间

using Microsoft.Playwright;
using static Microsoft.Playwright.Assertions;

// Change the default 5 seconds timeout if you'd like.
SetDefaultExpectTimeout(10_000);

using var playwright = await Playwright.CreateAsync();
await using var browser = await playwright.Chromium.LaunchAsync();
var page = await browser.NewPageAsync();
await page.GotoAsync("https://playwright.net.cn/dotnet");
await Expect(page.GetByRole(AriaRole.Link, new() { Name = "Get started" })).ToBeVisibleAsync();

捆绑不同平台的驱动程序

默认情况下，Playwright 仅捆绑 .NET 发布目标运行时的驱动程序。 如果您想要为其他平台捆绑驱动程序，您可以通过在项目文件中使用 all、none 或 linux、win、osx 来覆盖此行为。

<PropertyGroup>
  <PlaywrightPlatform>all</PlaywrightPlatform>
</PropertyGroup>

或

<PropertyGroup>
  <PlaywrightPlatform>osx;linux</PlaywrightPlatform>
</PropertyGroup>