модуль ActionDispatch::SystemTesting::TestHelpers::ScreenshotHelper

# File actionpack/lib/action_dispatch/system_testing/test_helpers/screenshot_helper.rb, line 53
def take_failed_screenshot
  return unless failed? && supports_screenshot? && Capybara::Session.instance_created?

  take_screenshot
  metadata[:failure_screenshot_path] = relative_image_path if Minitest::Runnable.method_defined?(:metadata)
end

Создаёт скриншот текущей страницы в браузере, если тест завершился неудачно.

take_failed_screenshot вызывается во время завершения системного теста.

# 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

Создаёт скриншот текущей страницы в браузере.

take_screenshot можно использовать в любой момент ваших системных тестов для создания скриншота текущего состояния. Это может быть полезно для отладки или автоматизации визуальных тестов. Вы можете сделать несколько скриншотов за тест, чтобы исследовать изменения в разные моменты вашего теста. Они будут именоваться с последовательным префиксом (или «failed» для неудачных тестов).

Директория по умолчанию для скриншотов — tmp/screenshots, но вы можете установить другую с помощью Capybara.save_path

Вы можете использовать аргумент html или установить переменную окружения RAILS_SYSTEM_TESTING_SCREENSHOT_HTML, чтобы сохранить HTML страницы, которая скриншотится, для исследования элементов страницы на момент скриншота

Вы можете использовать аргумент screenshot или установить переменную окружения RAILS_SYSTEM_TESTING_SCREENSHOT для управления выводом. Возможные значения: simple (по умолчанию) : Отображает только путь к скриншотов. Это значение по умолчанию.

`inline`

: Отображает скриншот в терминале с использованием протокола изображений iTerm (iterm2.com/documentation-images.html).

`artifact`

: Отображает скриншот в терминале, используя формат артефактов терминала (buildkite.github.io/terminal-to-html/inline-images/).