WebView2

イントロダクション

以下では、Playwright を Microsoft Edge WebView2 で使用する方法について説明します。WebView2 は WinForms コントロールであり、内部的には Microsoft Edge を使用して Web コンテンツをレンダリングします。これは Microsoft Edge ブラウザの一部であり、Windows 10 および Windows 11 で利用できます。Playwright は WebView2 アプリケーションを自動化するために使用でき、WebView2 で Web コンテンツをテストするために使用できます。WebView2 に接続するために、Playwright は BrowserType.ConnectOverCDPAsync() を使用します。これは Chrome DevTools Protocol (CDP) 経由で接続します。

概要

WebView2 コントロールは、--remote-debugging-port=9222 を指定した WEBVIEW2_ADDITIONAL_BROWSER_ARGUMENTS 環境変数を設定するか、--remote-debugging-port=9222 引数を指定して EnsureCoreWebView2Async を呼び出すことで、受信 CDP 接続をリッスンするように指示できます。これにより、Chrome DevTools Protocol が有効になった WebView2 プロセスが開始され、Playwright による自動化が可能になります。9222 はこの場合のポートの例ですが、他の未使用ポートも同様に使用できます。

await this.webView.EnsureCoreWebView2Async(await CoreWebView2Environment.CreateAsync(null, null, new CoreWebView2EnvironmentOptions()
{
  AdditionalBrowserArguments = "--remote-debugging-port=9222",
})).ConfigureAwait(false);

WebView2 コントロールを備えたアプリケーションが実行されたら、Playwright 経由で接続できます

var browser = await playwright.Chromium.ConnectOverCDPAsync("http://localhost:9222");
var context = browser.Contexts[0];
var page = context.Pages[0];

WebView2 コントロールの準備が整っていることを確認するには、CoreWebView2InitializationCompleted イベントを待つことができます

this.webView.CoreWebView2InitializationCompleted += (_, e) =>
{
    if (e.IsSuccess)
    {
        Console.WriteLine("WebView2 initialized");
    }
};

テストの作成と実行

デフォルトでは、WebView2 コントロールはすべてのインスタンスに対して同じユーザーデータディレクトリを使用します。これは、複数のテストを並行して実行すると、互いに干渉することを意味します。これを回避するには、WEBVIEW2_USER_DATA_FOLDER 環境変数を設定するか (WebView2.EnsureCoreWebView2Async メソッドを使用)、各テストで異なるフォルダーに設定する必要があります。これにより、各テストが独自のユーザーデータディレクトリで実行されるようになります。

以下を使用すると、Playwright は WebView2 アプリケーションをサブプロセスとして実行し、一意のユーザーデータディレクトリを割り当て、テストに Page インスタンスを提供します

// WebView2Test.cs
using System.Diagnostics;
using Microsoft.Playwright;
using Microsoft.Playwright.MSTest;

namespace PlaywrightTests;

[TestClass]
public class ExampleTest : PlaywrightTest
{
    public IBrowser Browser { get; internal set; } = null!;
    public IBrowserContext Context { get; internal set; } = null!;
    public IPage Page { get; internal set; } = null!;
    private Process? _webView2Process = null;
    private string _userDataDir = null!;
    private string _executablePath = Path.Join(Directory.GetCurrentDirectory(), @"..\..\..\..\webview2-app\bin\Debug\net8.0-windows\webview2.exe");

    [TestInitialize]
    public async Task BrowserTestInitialize()
    {
        var cdpPort = 10000 + WorkerIndex;
        Assert.IsTrue(File.Exists(_executablePath), "Make sure that the executable exists");
        _userDataDir = Path.Join(Path.GetTempPath(), $"playwright-webview2-tests/user-data-dir-{WorkerIndex}");
        // WebView2 does some lazy cleanups on shutdown so we can't clean it up after each test
        if (Directory.Exists(_userDataDir))
        {
            Directory.Delete(_userDataDir, true);
        }
        _webView2Process = Process.Start(new ProcessStartInfo(_executablePath)
        {
            EnvironmentVariables =
        {
            ["WEBVIEW2_ADDITIONAL_BROWSER_ARGUMENTS"] = $"--remote-debugging-port={cdpPort}",
            ["WEBVIEW2_USER_DATA_FOLDER"] = _userDataDir,
        },
            RedirectStandardOutput = true,
        });
        while (!_webView2Process!.HasExited)
        {
            var output = await _webView2Process!.StandardOutput.ReadLineAsync();
            if (_webView2Process!.HasExited)
            {
                throw new Exception("WebView2 process exited unexpectedly");
            }
            if (output != null && output.Contains("WebView2 initialized"))
            {
                break;
            }
        }
        var cdpAddress = $"http://127.0.0.1:{cdpPort}";
        Browser = await Playwright.Chromium.ConnectOverCDPAsync(cdpAddress);
        Context = Browser.Contexts[0];
        Page = Context.Pages[0];
    }

    [TestCleanup]
    public async Task BrowserTestCleanup()
    {
        _webView2Process!.Kill(true);
        await Browser.CloseAsync();
    }
}

// UnitTest1.cs
using Microsoft.Playwright;
using Microsoft.Playwright.MSTest;

namespace PlaywrightTests;

[TestClass]
public class ExampleTest : WebView2Test
{
    [TestMethod]
    public async Task HomepageHasPlaywrightInTitleAndGetStartedLinkLinkingtoTheIntroPage()
    {
        await Page.GotoAsync("https://playwright.dokyumento.jp");
        var getStarted = Page.GetByText("Get Started");
        await Expect(getStarted).ToBeVisibleAsync();
    }
}

デバッグ

webview2 コントロール内で、右クリックしてコンテキストメニューを開き、[Inspect] を選択して DevTools を開くか、F12 キーを押すだけです。WebView2.CoreWebView2.OpenDevToolsWindow メソッドを使用して、プログラムで DevTools を開くこともできます。

テストのデバッグについては、Playwright のデバッグガイドを参照してください。

イントロダクション​

概要​

テストの作成と実行​

デバッグ​

イントロダクション

概要

テストの作成と実行

デバッグ