lib/capybara/helpers.rb
# frozen_string_literal: true module Capybara # @api private module Helpers extend self ## # @deprecated # Normalizes whitespace space by stripping leading and trailing # whitespace and replacing sequences of whitespace characters # with a single space. # # @param [String] text Text to normalize # @return [String] Normalized text # def normalize_whitespace(text) warn "DEPRECATED: Capybara::Helpers::normalize_whitespace is deprecated, please update your driver" text.to_s.gsub(/[[:space:]]+/, ' ').strip end ## # # Escapes any characters that would have special meaning in a regexp # if text is not a regexp # # @param [String] text Text to escape # @param [Boolean] exact (false) Whether or not this should be an exact text match # @param [Fixnum, Boolean, nil] options Options passed to Regexp.new when creating the Regexp # @return [Regexp] Regexp to match the passed in text and options # def to_regexp(text, exact: false, all_whitespace: false, options: nil) return text if text.is_a?(Regexp) escaped = Regexp.escape(text) escaped = escaped.gsub("\\ ", "[[:blank:]]") if all_whitespace escaped = "\\A#{escaped}\\z" if exact Regexp.new(escaped, options) end ## # # Injects a `<base>` tag into the given HTML code, pointing to # `Capybara.asset_host`. # # @param [String] html HTML code to inject into # @param [URL] host (Capybara.asset_host) The host from which assets should be loaded # @return [String] The modified HTML code # def inject_asset_host(html, host: Capybara.asset_host) if host && Nokogiri::HTML(html).css("base").empty? match = html.match(/<head[^<]*?>/) return html.clone.insert match.end(0), "<base href='#{host}' />" if match end html end ## # # A poor man's `pluralize`. Given two declensions, one singular and one # plural, as well as a count, this will pick the correct declension. This # way we can generate grammatically correct error message. # # @param [String] singular The singular form of the word # @param [String] plural The plural form of the word # @param [Integer] count The number of items # def declension(singular, plural, count) count == 1 ? singular : plural end if defined?(Process::CLOCK_MONOTONIC) def monotonic_time; Process.clock_gettime Process::CLOCK_MONOTONIC; end else def monotonic_time; Time.now.to_f; end end end end