Tracing

Playwright トレースを収集および保存するための API。Playwright スクリプトの実行後、トレースビューアーで Playwright トレースを開くことができます。

アクションを実行する前にトレースの記録を開始します。最後に、トレースを停止してファイルに保存します。

using var playwright = await Playwright.CreateAsync();
var browser = await playwright.Chromium.LaunchAsync();
await using var context = await browser.NewContextAsync();
await context.Tracing.StartAsync(new()
{
  Screenshots = true,
  Snapshots = true
});
var page = await context.NewPageAsync();
await page.GotoAsync("https://playwright.dokyumento.jp");
await context.Tracing.StopAsync(new()
{
  Path = "trace.zip"
});

---

メソッド

GroupAsync

追加: v1.49 tracing.GroupAsync

注意

可能な場合は test.step を代わりに使用してください。

トレース内に新しいグループを作成し、Tracing.GroupEndAsync() が呼び出されるまで、後続の API 呼び出しをこのグループに割り当てます。グループはネストでき、トレースビューアーに表示されます。

使用例

// All actions between GroupAsync and GroupEndAsync
// will be shown in the trace viewer as a group.
await Page.Context.Tracing.GroupAsync("Open Playwright.dev > API");
await Page.GotoAsync("https://playwright.dokyumento.jp/");
await Page.GetByRole(AriaRole.Link, new() { Name = "API" }).ClickAsync();
await Page.Context.Tracing.GroupEndAsync();

引数

• name string#

  トレースビューアーに表示されるグループ名。

• options TracingGroupOptions? (オプション)

  • Location Location? (オプション)#

    • File string

    • Line int? (オプション)

    • Column int? (オプション)

    トレースビューアーに表示するグループのカスタムロケーションを指定します。デフォルトは Tracing.GroupAsync() 呼び出しのロケーションです。

戻り値

• void#

---

GroupEndAsync

追加: v1.49 tracing.GroupEndAsync

Tracing.GroupAsync() によって作成された最後のグループを閉じます。

使用例

await Tracing.GroupEndAsync();

戻り値

• void#

---

StartAsync

追加: v1.12 tracing.StartAsync

トレースを開始します。

使用例

using var playwright = await Playwright.CreateAsync();
var browser = await playwright.Chromium.LaunchAsync();
await using var context = await browser.NewContextAsync();
await context.Tracing.StartAsync(new()
{
  Screenshots = true,
  Snapshots = true
});
var page = await context.NewPageAsync();
await page.GotoAsync("https://playwright.dokyumento.jp");
await context.Tracing.StopAsync(new()
{
  Path = "trace.zip"
});

引数

• options TracingStartOptions? (オプション)

  • Name string? (オプション)#

    指定した場合、中間トレースファイルは BrowserType.LaunchAsync() で指定された TracesDir ディレクトリ内に、指定された名前のプレフィックスを持つファイルに保存されます。最終的なトレース zip ファイル名を指定するには、代わりに Tracing.StopAsync() に path オプションを渡す必要があります。

  • Screenshots bool? (オプション)#

    トレース中にスクリーンショットをキャプチャするかどうか。スクリーンショットはタイムラインプレビューの作成に使用されます。

  • Snapshots bool? (オプション)#

    このオプションが true の場合、トレースは

    • すべてのアクションで DOM スナップショットをキャプチャします
    • ネットワークアクティビティを記録します

  • Sources bool? (オプション)追加: v1.17#

    トレースアクションのソースファイルを含めるかどうか。

  • Title string? (オプション)追加: v1.17#

    トレースビューアーに表示されるトレース名。

戻り値

• void#

---

StartChunkAsync

追加: v1.15 tracing.StartChunkAsync

新しいトレースチャンクを開始します。同じ BrowserContext で複数のトレースを記録する場合は、Tracing.StartAsync() を一度使用してから、Tracing.StartChunkAsync() および Tracing.StopChunkAsync() で複数のトレースチャンクを作成します。

使用例

using var playwright = await Playwright.CreateAsync();
var browser = await playwright.Chromium.LaunchAsync();
await using var context = await browser.NewContextAsync();
await context.Tracing.StartAsync(new()
{
  Screenshots = true,
  Snapshots = true
});
var page = await context.NewPageAsync();
await page.GotoAsync("https://playwright.dokyumento.jp");

await context.Tracing.StartChunkAsync();
await page.GetByText("Get Started").ClickAsync();
// Everything between StartChunkAsync and StopChunkAsync will be recorded in the trace.
await context.Tracing.StopChunkAsync(new()
{
  Path = "trace1.zip"
});

await context.Tracing.StartChunkAsync();
await page.GotoAsync("http://example.com");
// Save a second trace file with different actions.
await context.Tracing.StopChunkAsync(new()
{
  Path = "trace2.zip"
});

引数

• options TracingStartChunkOptions? (オプション)

  • Name string? (オプション)追加: v1.32#

    指定した場合、中間トレースファイルは BrowserType.LaunchAsync() で指定された TracesDir ディレクトリ内に、指定された名前のプレフィックスを持つファイルに保存されます。最終的なトレース zip ファイル名を指定するには、代わりに Tracing.StopChunkAsync() に path オプションを渡す必要があります。

  • Title string? (オプション)追加: v1.17#

    トレースビューアーに表示されるトレース名。

戻り値

• void#

---

StopAsync

追加: v1.12 tracing.StopAsync

トレースを停止します。

使用例

await Tracing.StopAsync(options);

引数

• options TracingStopOptions? (オプション)

  • Path string? (オプション)#

    指定されたパスのファイルにトレースをエクスポートします。

戻り値

• void#

---

StopChunkAsync

追加: v1.15 tracing.StopChunkAsync

トレースチャンクを停止します。複数のトレースチャンクの詳細については、Tracing.StartChunkAsync() を参照してください。

使用例

await Tracing.StopChunkAsync(options);

引数

• options TracingStopChunkOptions? (オプション)

  • Path string? (オプション)#

    最後の Tracing.StartChunkAsync() 呼び出し以降に収集されたトレースを、指定されたパスのファイルにエクスポートします。

戻り値

• void#