lib/capybara-screenshot/saver.rb
require 'capybara-screenshot/helpers'
require 'capybara-screenshot/callbacks'
module Capybara
module Screenshot
class Saver
include Capybara::Screenshot::Callbacks
define_callback :after_save_html
define_callback :after_save_screenshot
attr_reader :capybara, :page, :file_base_name
def initialize(capybara, page, html_save=true, filename_prefix='screenshot')
@capybara, @page, @html_save = capybara, page, html_save
time_now = Time.now
timestamp = "#{time_now.strftime('%Y-%m-%d-%H-%M-%S.')}#{'%03d' % (time_now.usec/1000).to_i}"
filename = [filename_prefix]
filename << timestamp if Capybara::Screenshot.append_timestamp
filename << SecureRandom.hex if Capybara::Screenshot.append_random
@file_base_name = filename.join('_')
Capybara::Screenshot.prune
end
def save
current_path do |path|
within_offending_window do
if path.empty?
warn 'WARN: Screenshot could not be saved. `page.current_path` is empty.'
else
begin
save_html if @html_save
rescue StandardError => e
warn "WARN: HTML source could not be saved. An exception is raised: #{e.inspect}."
end
begin
save_screenshot
rescue StandardError => e
warn "WARN: Screenshot could not be saved. An exception is raised: #{e.inspect}."
end
end
end
end
end
def save_html
path = html_path
clear_save_path do
if Capybara::VERSION.match(/^\d+/)[0] == '1'
capybara.save_page(page.body, path.to_s)
else
capybara.save_page(path.to_s)
end
end
@html_saved = true
run_callbacks :after_save_html, html_path if html_saved?
end
def save_screenshot
path = screenshot_path
clear_save_path do
result = Capybara::Screenshot.registered_drivers.fetch(capybara.current_driver) { |driver_name|
warn "capybara-screenshot could not detect a screenshot driver for '#{capybara.current_driver}'. Saving with default with unknown results."
Capybara::Screenshot.registered_drivers[:default]
}.call(page.driver, path)
@screenshot_saved = result != :not_supported
end
run_callbacks :after_save_screenshot, screenshot_path if screenshot_saved?
end
def html_path
File.join(Capybara::Screenshot.capybara_root, "#{file_base_name}.html")
end
def screenshot_path
File.join(Capybara::Screenshot.capybara_root, "#{file_base_name}.png")
end
def html_saved?
@html_saved
end
def screenshot_saved?
@screenshot_saved
end
# If Capybara::Screenshot.capybara_tmp_path is set then
# the html_path or screenshot_path can be appended to this path in
# some versions of Capybara instead of using it as an absolute path
def clear_save_path
old_path = Capybara::Screenshot.capybara_tmp_path
Capybara::Screenshot.capybara_tmp_path = nil
yield
ensure
Capybara::Screenshot.capybara_tmp_path = old_path
end
def output_screenshot_path
output "HTML screenshot: #{html_path}" if html_saved?
output "Image screenshot: #{screenshot_path}" if screenshot_saved?
end
# Print image to screen, if imgcat is available
def display_image
system("#{imgcat} #{screenshot_path}") unless imgcat.nil?
end
private
def current_path
# the current_path may raise error in selenium
begin
path = page.current_path.to_s
rescue StandardError => e
warn "WARN: Screenshot could not be saved. `page.current_path` raised exception: #{e.inspect}."
end
yield path if path
end
def output(message)
puts " #{CapybaraScreenshot::Helpers.yellow(message)}"
end
def imgcat
@imgcat ||= which('imgcat')
end
# Cross-platform way of finding an executable in the $PATH.
#
# which('ruby') #=> /usr/bin/ruby
def which(cmd)
exts = ENV['PATHEXT'] ? ENV['PATHEXT'].split(';') : ['']
ENV['PATH'].split(File::PATH_SEPARATOR).each do |path|
exts.each { |ext|
exe = File.join(path, "#{cmd}#{ext}")
return exe if File.executable?(exe) && !File.directory?(exe)
}
end
nil
end
def within_offending_window
return yield unless Thread.current[:capybara_screenshot_offending_window]
page.within_window(Thread.current[:capybara_screenshot_offending_window]) do
yield
end
Thread.current[:capybara_screenshot_offending_window] = nil
end
end
end
end