Skip to main content
Note

Methods are listed as name(arguments), called on a BaseCase as sb.name(...).await?. The argument names, the selector syntax and the return types are explained in Reading the API reference.

Tours, presentations, charts#

MethodDescription
create_tour(name)Creates a tour with the default theme.
create_tour_with_theme(name, theme)Creates a tour with a specific TourTheme.
create_shepherd_tour(name) / create_introjs_tour(name) / create_driverjs_tour(name) / create_bootstrap_tour(name) / create_hopscotch_tour(name)Convenience themed constructors.
add_tour_step(message, target)Adds a tour step; target is an optional CSS selector.
play_tour() / start_tour()Plays the tour in the current page.
export_tour(path)Exports tour HTML.
create_presentation(name)Creates HTML presentation.
add_presentation_slide(html)Adds a slide.
save_presentation(path)Saves presentation.
create_pie_chart(name) / create_bar_chart(name) / …Creates a chart.
add_data_point(label, value)Adds data to the current chart.
save_chart(path)Saves chart HTML.

See the Tours and Charts pages for details.

Recorder#

MethodDescription
activate_recorder()Injects the browser-side action recorder.
recorded_actions()Returns actions captured so far.
export_recording_as_rust()Returns recorded actions as Rust source (pure CDP code when rec_sb_cdp() is on).
export_recording_as_cdp_rust()Returns recorded actions as a pure CDP program (Page and Locator calls).
save_recording_to_logs()Saves the recording as JSON and Rust source.
save_recorded_actions(path)Saves recorded actions to a JSON file.

Utility / misc helpers#

MethodDescription
get_beautiful_soup()Returns a BeautifulSoup-style parser for the page.
get_beautiful_soup_object()Alias for get_beautiful_soup.
convert_css_to_xpath(css)Converts a CSS selector to an XPath expression.
convert_xpath_to_css(xpath)Converts a simple XPath expression (a tag with attribute tests) to a CSS selector; any other XPath is an InvalidSelector error.
ad_block()Removes the ad elements of upstream’s AD_BLOCK_LIST from the current page.
disable_beforeunload()Disables beforeunload prompts.
print_unique_links_with_status_codes()Prints all unique links and their HTTP status codes.