メインコンテンツにスキップ

入門 - ライブラリ

イントロダクション​

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.dokyumento.jp/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.dokyumento.jp/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 ファーストアサーションを活用するには、次の手順を実行します。これらは、条件が満たされるまで (たとえば、要素に特定のテキストが含まれているか、タイムアウトに達するまで) 自動的に再試行します。

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.dokyumento.jp/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>