---

sidebar_position: 10

Tracing

API for collecting and saving Playwright traces. Playwright traces can be opened in Trace Viewer
after Playwright script runs.

Start recording a trace before performing actions. At the end, stop tracing and save it to a file.

browser.new_context do |context|
  context.tracing.start(screenshots: true, snapshots: true)
  page = context.new_page
  page.goto('https://playwright.dev')
  context.tracing.stop(path: 'trace.zip')
end

start

def start(name: nil, screenshots: nil, snapshots: nil)

Start tracing.

context.tracing.start(name: 'trace', screenshots: true, snapshots: true)
page = context.new_page
page.goto('https://playwright.dev')
context.tracing.stop(path: 'trace.zip')

start_chunk

def start_chunk

Start a new trace chunk. If you’d like to record multiple traces on the same BrowserContext, use
Tracing#start once, and then create multiple trace chunks with Tracing#start_chunk and
Tracing#stop_chunk.

context.tracing.start(name: "trace", screenshots: true, snapshots: true)
page = context.new_page
page.goto("https://playwright.dev")

context.tracing.start_chunk
page.click("text=Get Started")
# Everything between start_chunk and stop_chunk will be recorded in the trace.
context.tracing.stop_chunk(path: "trace1.zip")

context.tracing.start_chunk
page.goto("http://example.com")
# Save a second trace file with different actions.
context.tracing.stop_chunk(path: "trace2.zip")

stop

def stop(path: nil)

Stop tracing.

stop_chunk

def stop_chunk(path: nil)

Stop the trace chunk. See Tracing#start_chunk for more details about multiple trace chunks.