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 = chromium.launch()
context = browser.new_context()
context.tracing.start(screenshots=True, snapshots=True)
page = context.new_page()
page.goto("https://playwright.dev")
context.tracing.stop(path = "trace.zip")
browser = await chromium.launch()
context = await browser.new_context()
await context.tracing.start(screenshots=True, snapshots=True)
page = await context.new_page()
await page.goto("https://playwright.dev")
await context.tracing.stop(path = "trace.zip")
Methods groupAdded in: v1.49 tracing.group
caution
Use test.step
instead when available.
Creates a new group within the trace, assigning any subsequent API calls to this group, until tracing.group_end() is called. Groups can be nested and will be visible in the trace viewer.
Usage
page.context.tracing.group("Open Playwright.dev > API")
page.goto("https://playwright.dev/")
page.get_by_role("link", name="API").click()
page.context.tracing.group_end()
await page.context.tracing.group("Open Playwright.dev > API")
await page.goto("https://playwright.dev/")
await page.get_by_role("link", name="API").click()
await page.context.tracing.group_end()
Arguments
Group name shown in the trace viewer.
Specifies a custom location for the group to be shown in the trace viewer. Defaults to the location of the tracing.group() call.
Returns
group_endAdded in: v1.49 tracing.group_endCloses the last group created by tracing.group().
Usage
Returns
startAdded in: v1.12 tracing.startStart tracing.
Usage
context.tracing.start(screenshots=True, snapshots=True)
page = context.new_page()
page.goto("https://playwright.dev")
context.tracing.stop(path = "trace.zip")
await context.tracing.start(screenshots=True, snapshots=True)
page = await context.new_page()
await page.goto("https://playwright.dev")
await context.tracing.stop(path = "trace.zip")
Arguments
If specified, intermediate trace files are going to be saved into the files with the given name prefix inside the traces_dir directory specified in browser_type.launch(). To specify the final trace zip file name, you need to pass path
option to tracing.stop() instead.
Whether to capture screenshots during tracing. Screenshots are used to build a timeline preview.
If this option is true tracing will
sources
bool (optional) Added in: v1.17#
Whether to include source files for trace actions.
title
str (optional) Added in: v1.17#
Trace name to be shown in the Trace Viewer.
Returns
start_chunkAdded in: v1.15 tracing.start_chunkStart 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().
Usage
context.tracing.start(screenshots=True, snapshots=True)
page = context.new_page()
page.goto("https://playwright.dev")
context.tracing.start_chunk()
page.get_by_text("Get Started").click()
context.tracing.stop_chunk(path = "trace1.zip")
context.tracing.start_chunk()
page.goto("http://example.com")
context.tracing.stop_chunk(path = "trace2.zip")
await context.tracing.start(screenshots=True, snapshots=True)
page = await context.new_page()
await page.goto("https://playwright.dev")
await context.tracing.start_chunk()
await page.get_by_text("Get Started").click()
await context.tracing.stop_chunk(path = "trace1.zip")
await context.tracing.start_chunk()
await page.goto("http://example.com")
await context.tracing.stop_chunk(path = "trace2.zip")
Arguments
name
str (optional) Added in: v1.32#
If specified, intermediate trace files are going to be saved into the files with the given name prefix inside the traces_dir directory specified in browser_type.launch(). To specify the final trace zip file name, you need to pass path
option to tracing.stop_chunk() instead.
title
str (optional) Added in: v1.17#
Trace name to be shown in the Trace Viewer.
Returns
stopAdded in: v1.12 tracing.stopStop tracing.
Usage
tracing.stop()
tracing.stop(**kwargs)
Arguments
path
Union[str, pathlib.Path] (optional)#
Export trace into the file with the given path.
Returns
stop_chunkAdded in: v1.15 tracing.stop_chunkStop the trace chunk. See tracing.start_chunk() for more details about multiple trace chunks.
Usage
tracing.stop_chunk()
tracing.stop_chunk(**kwargs)
Arguments
path
Union[str, pathlib.Path] (optional)#
Export trace collected since the last tracing.start_chunk() call into the file with the given path.
Returns
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4