instance method `take_screenshot`

Ruby on Rails 8.1.2

Since v5.2.8.1

Available in: v5.2.8.1 v6.0.6 v6.1.7.10 v7.0.10 v7.1.6 v7.2.3 v8.0.4 v8.1.2

Compare with:

take_screenshot(html: false, screenshot: nil)

Takes a screenshot of the current page in the browser.

take_screenshot can be used at any point in your system tests to take a screenshot of the current state. This can be useful for debugging or automating visual testing. You can take multiple screenshots per test to investigate changes at different points during your test. These will be named with a sequential prefix (or ‘failed’ for failing tests)

The default screenshots directory is tmp/screenshots but you can set a different one with Capybara.save_path

You can use the html argument or set the RAILS_SYSTEM_TESTING_SCREENSHOT_HTML environment variable to save the HTML from the page that is being screenshotted so you can investigate the elements on the page at the time of the screenshot

You can use the screenshot argument or set the RAILS_SYSTEM_TESTING_SCREENSHOT environment variable to control the output. Possible values are: simple (default) : Only displays the screenshot path. This is the default value.

`inline`

: Display the screenshot in the terminal using the iTerm image protocol (iterm2.com/documentation-images.html).

`artifact`

: Display the screenshot in the terminal, using the terminal artifact format (buildkite.github.io/terminal-to-html/inline-images/).

Parameters

html key = false
screenshot key = nil

Source

# File actionpack/lib/action_dispatch/system_testing/test_helpers/screenshot_helper.rb, line 41
        def take_screenshot(html: false, screenshot: nil)
          showing_html = html || html_from_env?

          increment_unique
          save_html if showing_html
          save_image
          show display_image(html: showing_html, screenshot_output: screenshot)
        end

Defined in actionpack/lib/action_dispatch/system_testing/test_helpers/screenshot_helper.rb line 41 · View on GitHub · Improve this page · Find usages on GitHub

Defined in ActionDispatch::SystemTesting::TestHelpers::ScreenshotHelper

Signature

Parameters