Struct Tracing 

pub struct Tracing { /* private fields */ }

Tracing manager for recording test execution traces.

Traces record screenshots, DOM snapshots, network activity, and action history. They can be viewed using Playwright’s Trace Viewer.

Example

// Start tracing with screenshots
context.tracing().start(
    TracingOptions::new()
        .name("my-test")
        .screenshots(true)
        .snapshots(true)
).await?;

// ... perform test actions ...

// Stop and save trace
context.tracing().stop("trace.zip").await?;

Implementations

impl Tracing

pub async fn start(&self, options: TracingOptions) -> Result<(), ContextError>

Start recording a trace.

Errors

Returns an error if tracing is already active or CDP commands fail.

Example

context.tracing().start(
    TracingOptions::new()
        .screenshots(true)
        .snapshots(true)
).await?;

pub async fn stop(&self, path: impl AsRef<Path>) -> Result<(), ContextError>

Stop tracing and save the trace to a file.

The trace is saved as a zip file containing:

• trace.json: The trace data
• resources/: Screenshots and other resources
• network.har: Network activity in HAR format

Errors

Returns an error if tracing is not active or saving the trace fails.

Example

context.tracing().stop("trace.zip").await?;

pub async fn stop_discard(&self) -> Result<(), ContextError>

Stop tracing and discard the trace data.

Use this when you don’t need to save the trace (e.g., test passed).

Errors

Returns an error if tracing is not active.

pub async fn start_chunk(&self) -> Result<(), ContextError>

Start a new trace chunk.

This is useful for long-running tests where you want to save periodic snapshots.

Errors

Returns an error if tracing is not active.

pub async fn stop_chunk( &self, path: impl AsRef<Path>, ) -> Result<(), ContextError>

Stop the current trace chunk and save it.

Errors

Returns an error if tracing is not active or saving fails.

pub async fn is_recording(&self) -> bool

Check if tracing is currently active.

pub async fn add_source_file( &self, path: impl Into<String>, content: impl Into<String>, )

Add a source file to include in the trace.

Source files are shown in the Trace Viewer for debugging.

Example

context.tracing().add_source_file(
    "tests/my_test.rs",
    include_str!("tests/my_test.rs")
).await;

pub async fn collect_sources( &self, dir: impl AsRef<Path>, extensions: &[&str], ) -> Result<(), ContextError>

Collect source files from a directory.

This recursively adds all matching files from the directory.

Arguments

• dir - Directory to scan
• extensions - File extensions to include (e.g., ["rs", "ts"])

Errors

Returns an error if reading files fails.

Trait Implementations

impl Debug for Tracing

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.