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

# File actionpack/lib/action_dispatch/system_testing/test_helpers/screenshot_helper.rb, line 44
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 31
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/).