eyes_selenium 3.15.39 → 3.15.40

data/lib/applitools/selenium/rgrid_dom.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: false
 module Applitools
   module Selenium
     class RGridDom
@@ -13,21 +14,16 @@ module Applitools
         self.resources = options[:resources]
         self.hash_format = 'sha256'
         self.data = {
-            'resources' => resources,
-            'domNodes' => dom_nodes
+          'resources' => resources,
+          'domNodes' => dom_nodes
         }
         self.hash = calculate_sha_256
       end
 
       def calculate_sha_256
-        # str = Applitools::Utils.stringify_for_hash(data)
         Digest::SHA256.hexdigest(content)
       end
 
-      # def hash
-      #   calculate_sha_256
-      # end
-
       def content
         Oj.dump(json_value(data.sort.to_h))
       end
@@ -41,4 +37,4 @@ module Applitools
       end
     end
   end
-end
+end

data/lib/applitools/selenium/scripts/get_element_xpath.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module Applitools
   module Selenium
     module Scripts
@@ -22,4 +24,4 @@ module Applitools
 END
     end
   end
-end
+end

data/lib/applitools/selenium/scripts/process_page_and_poll.rb

@@ -1,13 +1,46 @@
+# frozen_string_literal: true
+
 module Applitools
   module Selenium
     module Scripts
       PROCESS_PAGE_AND_POLL = <<'END'
-/* @applitools/dom-snapshot@2.2.1 */
+/* @applitools/dom-snapshot@3.1.4 */
 
-function __processPageAndPoll() {
-  var processPageAndPoll = (function () {
+function __processPageAndSerializePoll() {
+  var processPageAndSerializePoll = (function () {
   'use strict';
 
+  const EYES_NAME_SPACE = '__EYES__APPLITOOLS__';
+
+  function pullify(script, win = window) {
+    return function() {
+      const scriptName = script.name;
+      if (!win[EYES_NAME_SPACE]) {
+        win[EYES_NAME_SPACE] = {};
+      }
+      if (!win[EYES_NAME_SPACE][scriptName]) {
+        win[EYES_NAME_SPACE][scriptName] = {
+          status: 'WIP',
+          value: null,
+          error: null,
+        };
+        script
+          .apply(null, arguments)
+          .then(r => ((resultObject.status = 'SUCCESS'), (resultObject.value = r)))
+          .catch(e => ((resultObject.status = 'ERROR'), (resultObject.error = e.message)));
+      }
+
+      const resultObject = win[EYES_NAME_SPACE][scriptName];
+      if (resultObject.status === 'SUCCESS') {
+        win[EYES_NAME_SPACE][scriptName] = null;
+      }
+
+      return JSON.stringify(resultObject);
+    };
+  }
+
+  var pollify = pullify;
+
   // This code was copied and modified from https://github.com/beatgammit/base64-js/blob/bf68aaa277/index.js
   // License: https://github.com/beatgammit/base64-js/blob/bf68aaa277d9de7007cc0c58279c411bb10670ac/LICENSE
 
@@ -134,6 +167,21 @@ function __processPageAndPoll() {
 
   var absolutizeUrl_1 = absolutizeUrl;
 
+  const NEED_MAP_INPUT_TYPES = new Set([
+    'date',
+    'datetime-local',
+    'email',
+    'month',
+    'number',
+    'password',
+    'search',
+    'tel',
+    'text',
+    'time',
+    'url',
+    'week',
+  ]);
+
   function domNodesToCdt(docNode, baseUrl) {
     const cdt = [{nodeType: Node.DOCUMENT_NODE}];
     const docRoots = [docNode];
@@ -171,6 +219,11 @@ function __processPageAndPoll() {
             manualChildNodeIndexes = [cdt.length - 1];
           }
 
+          if (elementNode.tagName === 'TEXTAREA' && elementNode.value !== elementNode.textContent) {
+            cdt.push(getTextContentNode(elementNode));
+            manualChildNodeIndexes = [cdt.length - 1];
+          }
+
           node = getBasicNode(elementNode);
           node.childNodeIndexes =
             manualChildNodeIndexes ||
@@ -226,6 +279,13 @@ function __processPageAndPoll() {
       };
     }
 
+    function getTextContentNode(elementNode) {
+      return {
+        nodeType: Node.TEXT_NODE,
+        nodeValue: elementNode.value,
+      };
+    }
+
     function getBasicNode(elementNode) {
       const node = {
         nodeType: elementNode.nodeType,
@@ -255,7 +315,7 @@ function __processPageAndPoll() {
 
       if (
         elementNode.tagName === 'INPUT' &&
-        elementNode.type === 'text' &&
+        NEED_MAP_INPUT_TYPES.has(elementNode.type) &&
         (elementNode.attributes.value && elementNode.attributes.value.value) !== elementNode.value
       ) {
         const nodeAttr = node.attributes.find(a => a.name === 'value');
@@ -265,6 +325,13 @@ function __processPageAndPoll() {
           node.attributes.push({name: 'value', value: elementNode.value});
         }
       }
+
+      if (elementNode.tagName === 'OPTION' && elementNode.parentElement.value === elementNode.value) {
+        const nodeAttr = node.attributes.find(a => a.name === 'selected');
+        if (!nodeAttr) {
+          node.attributes.push({name: 'selected', value: ''});
+        }
+      }
       return node;
     }
 
@@ -410,7 +477,7 @@ function __processPageAndPoll() {
                   value,
                   styleSheet,
                 );
-                dependentUrls = extractResourcesFromStyleSheet(corsFreeStyleSheet, documents[0]);
+                dependentUrls = extractResourcesFromStyleSheet(corsFreeStyleSheet);
                 cleanStyleSheet();
               }
             } else if (/image\/svg/.test(type)) {
@@ -495,6 +562,19 @@ function __processPageAndPoll() {
       const domparser = parser || new DOMParser();
       const doc = domparser.parseFromString(svgStr, 'image/svg+xml');
 
+      const srcsetUrls = Array.from(doc.querySelectorAll('img[srcset]'))
+        .map(srcsetEl =>
+          srcsetEl
+            .getAttribute('srcset')
+            .split(', ')
+            .map(str => str.trim().split(/\s+/)[0]),
+        )
+        .reduce((acc, urls) => acc.concat(urls), []);
+
+      const srcUrls = Array.from(doc.querySelectorAll('img[src]')).map(srcEl =>
+        srcEl.getAttribute('src'),
+      );
+
       const fromHref = Array.from(doc.querySelectorAll('image,use,link[rel="stylesheet"]')).map(
         e => e.getAttribute('href') || e.getAttribute('xlink:href'),
       );
@@ -504,7 +584,9 @@ function __processPageAndPoll() {
       const fromStyleTags = extractResourceUrlsFromStyleTags(doc, false);
       const fromStyleAttrs = urlsFromStyleAttrOfDoc(doc);
 
-      return fromHref
+      return srcsetUrls
+        .concat(srcUrls)
+        .concat(fromHref)
         .concat(fromObjects)
         .concat(fromStyleTags)
         .concat(fromStyleAttrs)
@@ -526,53 +608,78 @@ function __processPageAndPoll() {
   /* global window */
 
   function fetchUrl(url, fetch = window.fetch) {
-    return fetch(url, {cache: 'force-cache', credentials: 'same-origin'}).then(resp =>
-      resp.status === 200
-        ? resp.arrayBuffer().then(buff => ({
-            url,
-            type: resp.headers.get('Content-Type'),
-            value: buff,
-          }))
-        : Promise.reject(`bad status code ${resp.status}`),
-    );
+    // Why return a `new Promise` like this? Because people like Atlassian do horrible things.
+    // They monkey patched window.fetch, and made it so it throws a synchronous exception if the route is not well known.
+    // Returning a new Promise guarantees that `fetchUrl` is the async function that it declares to be.
+    return new Promise((resolve, reject) => {
+      return fetch(url, {cache: 'force-cache', credentials: 'same-origin'})
+        .then(resp =>
+          resp.status === 200
+            ? resp.arrayBuffer().then(buff => ({
+                url,
+                type: resp.headers.get('Content-Type'),
+                value: buff,
+              }))
+            : Promise.reject(`bad status code ${resp.status}`),
+        )
+        .then(resolve)
+        .catch(err => reject(err));
+    });
   }
 
   var fetchUrl_1 = fetchUrl;
 
+  function sanitizeAuthUrl(urlStr) {
+    const url = new URL(urlStr);
+    if (url.username && url.password) {
+      return urlStr.replace(`${url.username}:${url.password}@`, '');
+    }
+    return urlStr;
+  }
+
+  var sanitizeAuthUrl_1 = sanitizeAuthUrl;
+
   function makeFindStyleSheetByUrl({styleSheetCache}) {
     return function findStyleSheetByUrl(url, documents) {
       const allStylesheets = flat_1(documents.map(d => Array.from(d.styleSheets)));
       return (
         styleSheetCache[url] ||
-        allStylesheets.find(styleSheet => styleSheet.href && toUnAnchoredUri_1(styleSheet.href) === url)
+        allStylesheets.find(styleSheet => {
+          const styleUrl = styleSheet.href && toUnAnchoredUri_1(styleSheet.href);
+          return styleUrl && sanitizeAuthUrl_1(styleUrl) === url;
+        })
       );
     };
   }
 
   var findStyleSheetByUrl = makeFindStyleSheetByUrl;
 
-  function makeExtractResourcesFromStyleSheet({styleSheetCache}) {
-    return function extractResourcesFromStyleSheet(styleSheet, doc) {
-      const win = doc.defaultView || (doc.ownerDocument && doc.ownerDocument.defaultView) || window;
+  function makeExtractResourcesFromStyleSheet({styleSheetCache, CSSRule = window.CSSRule}) {
+    return function extractResourcesFromStyleSheet(styleSheet) {
       const urls = uniq_1(
         Array.from(styleSheet.cssRules || []).reduce((acc, rule) => {
-          if (rule instanceof win.CSSImportRule) {
-            styleSheetCache[rule.styleSheet.href] = rule.styleSheet;
-            return acc.concat(rule.href);
-          } else if (rule instanceof win.CSSFontFaceRule) {
-            return acc.concat(getUrlFromCssText_1(rule.cssText));
-          } else if (
-            (win.CSSSupportsRule && rule instanceof win.CSSSupportsRule) ||
-            rule instanceof win.CSSMediaRule
-          ) {
-            return acc.concat(extractResourcesFromStyleSheet(rule, doc));
-          } else if (rule instanceof win.CSSStyleRule) {
-            for (let i = 0, ii = rule.style.length; i < ii; i++) {
-              const urls = getUrlFromCssText_1(rule.style.getPropertyValue(rule.style[i]));
-              urls.length && (acc = acc.concat(urls));
-            }
-          }
-          return acc;
+          const getRuleUrls = {
+            [CSSRule.IMPORT_RULE]: () => {
+              if (rule.styleSheet) {
+                styleSheetCache[rule.styleSheet.href] = rule.styleSheet;
+                return rule.href;
+              }
+            },
+            [CSSRule.FONT_FACE_RULE]: () => getUrlFromCssText_1(rule.cssText),
+            [CSSRule.SUPPORTS_RULE]: () => extractResourcesFromStyleSheet(rule),
+            [CSSRule.MEDIA_RULE]: () => extractResourcesFromStyleSheet(rule),
+            [CSSRule.STYLE_RULE]: () => {
+              let rv = [];
+              for (let i = 0, ii = rule.style.length; i < ii; i++) {
+                const urls = getUrlFromCssText_1(rule.style.getPropertyValue(rule.style[i]));
+                rv = rv.concat(urls);
+              }
+              return rv;
+            },
+          }[rule.type];
+
+          const urls = (getRuleUrls && getRuleUrls()) || [];
+          return acc.concat(urls);
         }, []),
       );
       return urls.filter(u => u[0] !== '#');
@@ -603,7 +710,7 @@ function __processPageAndPoll() {
             ? Array.from(doc.styleSheets).find(styleSheet => styleSheet.ownerNode === styleEl)
             : styleEl.sheet;
           return styleSheet
-            ? resourceUrls.concat(extractResourcesFromStyleSheet(styleSheet, doc))
+            ? resourceUrls.concat(extractResourcesFromStyleSheet(styleSheet))
             : resourceUrls;
         }, []),
       );
@@ -776,7 +883,7 @@ function __processPageAndPoll() {
 
   var sessionCache = makeSessionCache;
 
-  function processPage(doc = document, {showLogs, useSessionCache} = {}) {
+  function processPage(doc = document, {showLogs, useSessionCache, dontFetchResources} = {}) {
     const log$$1 = showLogs ? log(Date.now()) : noop;
     log$$1('processPage start');
     const sessionCache$$1 = useSessionCache && sessionCache({log: log$$1});
@@ -826,12 +933,12 @@ function __processPageAndPoll() {
         .map(toUnAnchoredUri_1)
         .filter(filterInlineUrlsIfExisting);
 
-      const resourceUrlsAndBlobsPromise = getResourceUrlsAndBlobs$$1({documents: docRoots, urls}).then(
-        result => {
-          sessionCache$$1 && sessionCache$$1.persist();
-          return result;
-        },
-      );
+      const resourceUrlsAndBlobsPromise = dontFetchResources
+        ? Promise.resolve({resourceUrls: urls, blobsObj: {}})
+        : getResourceUrlsAndBlobs$$1({documents: docRoots, urls}).then(result => {
+            sessionCache$$1 && sessionCache$$1.persist();
+            return result;
+          });
       const canvasBlobs = buildCanvasBlobs_1(canvasElements);
       const frameDocs = extractFrames_1(docRoots);
 
@@ -907,38 +1014,13 @@ function __processPageAndPoll() {
 
   var processPageAndSerialize_1 = processPageAndSerialize;
 
-  const EYES_NAME_SPACE = '__EYES__APPLITOOLS__';
-
-  function processPageAndPoll(doc) {
-    if (!window[EYES_NAME_SPACE]) {
-      window[EYES_NAME_SPACE] = {};
-    }
-    if (!window[EYES_NAME_SPACE].processPageAndSerializeResult) {
-      window[EYES_NAME_SPACE].processPageAndSerializeResult = {
-        status: 'WIP',
-        value: null,
-        error: null,
-      };
-      processPageAndSerialize_1(doc)
-        .then(r => ((resultObject.status = 'SUCCESS'), (resultObject.value = r)))
-        .catch(e => ((resultObject.status = 'ERROR'), (resultObject.error = e.message)));
-    }
-
-    const resultObject = window[EYES_NAME_SPACE].processPageAndSerializeResult;
-    if (resultObject.status === 'SUCCESS') {
-      window[EYES_NAME_SPACE].processPageAndSerializeResult = null;
-    }
-
-    return JSON.stringify(resultObject);
-  }
-
-  var processPageAndPoll_1 = processPageAndPoll;
+  var processPageAndSerializePoll = pollify(processPageAndSerialize_1);
 
-  return processPageAndPoll_1;
+  return processPageAndSerializePoll;
 
 }());
 
-  return processPageAndPoll.apply(this, arguments);
+  return processPageAndSerializePoll.apply(this, arguments);
 }
 END
     end

data/lib/applitools/selenium/scripts/process_page_and_serialize.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module Applitools
   module Selenium
     module Scripts
@@ -531,4 +533,4 @@ function __processPageAndSerialize() {
 END
     end
   end
-end
+end

data/lib/applitools/selenium/selenium_eyes.rb

@@ -3,6 +3,7 @@
 module Applitools::Selenium
   # The main API gateway for the SDK
   class SeleniumEyes < Applitools::EyesBase
+    include Applitools::Selenium::Concerns::SeleniumEyes
     # @!visibility private
     UNKNOWN_DEVICE_PIXEL_RATIO = 0
 
@@ -11,8 +12,6 @@ module Applitools::Selenium
 
     DEFAULT_WAIT_BEFORE_SCREENSHOTS = 0.1 # Seconds
 
-    USE_DEFAULT_MATCH_TIMEOUT = -1
-
     DEFAULT_STITCHING_OVERLAP = 50 # Pixels
 
     ENTIRE_ELEMENT_SCREENSHOT = 0
@@ -96,10 +95,10 @@ module Applitools::Selenium
     #   @return [Applitools::RectangleSize] explicit_entire_size
 
     attr_accessor :base_agent_id, :screenshot, :force_full_page_screenshot, :hide_scrollbars,
-                  :wait_before_screenshots, :debug_screenshots, :stitch_mode, :disable_horizontal_scrolling,
-                  :disable_vertical_scrolling, :explicit_entire_size, :debug_screenshot_provider, :stitching_overlap,
-                  :full_page_capture_algorithm_left_top_offset, :screenshot_type, :send_dom, :use_dom, :enable_patterns,
-                  :config
+      :wait_before_screenshots, :debug_screenshots, :stitch_mode, :disable_horizontal_scrolling,
+      :disable_vertical_scrolling, :explicit_entire_size, :debug_screenshot_provider, :stitching_overlap,
+      :full_page_capture_algorithm_left_top_offset, :screenshot_type, :send_dom, :use_dom, :enable_patterns,
+      :config
     attr_reader :driver
 
     def_delegators 'Applitools::EyesLogger', :logger, :log_handler, :log_handler=
@@ -124,8 +123,8 @@ module Applitools::Selenium
       self.region_visibility_strategy = MoveToRegionVisibilityStrategy.new
       self.debug_screenshots = false
       self.debug_screenshot_provider = Applitools::DebugScreenshotProvider.new
-                                           .tag_access { tag_for_debug }
-                                           .debug_flag_access { debug_screenshots }
+                                                                          .tag_access { tag_for_debug }
+                                                                          .debug_flag_access { debug_screenshots }
       self.disable_horizontal_scrolling = false
       self.disable_vertical_scrolling = false
       self.explicit_entire_size = nil
@@ -138,7 +137,6 @@ module Applitools::Selenium
       self.prevent_dom_processing = false
     end
 
-
     def ensure_config
       self.config = Applitools::Selenium::Configuration.new
     end
@@ -183,7 +181,7 @@ module Applitools::Selenium
 
       self.eyes_screenshot_factory = lambda do |image|
         Applitools::Selenium::ViewportScreenshot.new(
-            image, driver: @driver, force_offset: position_provider.force_offset
+          image, driver: @driver, force_offset: position_provider.force_offset
         )
       end
 
@@ -207,44 +205,6 @@ module Applitools::Selenium
 
     private :perform_driver_specific_settings
 
-    # Sets the stitch mode.
-    #
-    # @param [Hash] value The desired type of stitching (:SCROLL is default).
-    # @option value [Symbol] :css use Css to perform stitching.
-    # @option value [Symbol] :scroll Scroll to perform stitching.
-    # @return [Symbol] The type of stitching.
-    # def stitch_mode=(value)
-    #   @stitch_mode = if value.to_s.upcase == Applitools::STITCH_MODE[:css].to_s
-    #                    Applitools::STITCH_MODE[:css]
-    #                  else
-    #                    Applitools::STITCH_MODE[:scroll]
-    #                  end
-    #   unless driver.nil?
-    #     self.position_provider = self.class.position_provider(
-    #         stitch_mode, driver, disable_horizontal_scrolling, disable_vertical_scrolling, explicit_entire_size
-    #     )
-    #   end
-    #   if stitch_mode == Applitools::STITCH_MODE[:css]
-    #     @css_transition_original_hide_scrollbars = hide_scrollbars
-    #     self.hide_scrollbars = true
-    #   else
-    #     self.hide_scrollbars = @css_transition_original_hide_scrollbars || false
-    #   end
-    #   value
-    # end
-
-    # Takes a snapshot of the application under test and matches it with the expected output.
-    #
-    # @param [String] tag An optional tag to be assosiated with the snapshot.
-    # @param [Fixnum] match_timeout The amount of time to retry matching (seconds)
-    def check_window(tag = nil, match_timeout = USE_DEFAULT_MATCH_TIMEOUT)
-      target = Applitools::Selenium::Target.window.tap do |t|
-        t.timeout(match_timeout)
-        t.fully if force_full_page_screenshot
-      end
-      check(tag, target)
-    end
-
     # @!visibility private
     def title
       return driver.title unless dont_get_title
@@ -279,8 +239,8 @@ module Applitools::Selenium
 
       self.eyes_screenshot_factory = lambda do |image|
         Applitools::Selenium::ViewportScreenshot.new(
-            image,
-            region_provider: region_to_check
+          image,
+          region_provider: region_to_check
         )
       end
 
@@ -298,8 +258,10 @@ module Applitools::Selenium
           eyes_element = target_to_check.region_to_check.call(driver)
 
           unless force_full_page_screenshot
-            region_visibility_strategy.move_to_region original_position_provider,
-                                                      Applitools::Location.new(eyes_element.location.x.to_i, eyes_element.location.y.to_i)
+            region_visibility_strategy.move_to_region(
+              original_position_provider,
+              Applitools::Location.new(eyes_element.location.x.to_i, eyes_element.location.y.to_i)
+            )
             driver.find_element(:css, 'html').scroll_data_attribute = true
           end
 
@@ -315,10 +277,10 @@ module Applitools::Selenium
           inside_a_frame = !driver.frame_chain.empty?
 
           self.screenshot_type = self.class.obtain_screenshot_type(
-              is_element,
-              inside_a_frame,
-              target_to_check.options[:stitch_content],
-              force_full_page_screenshot
+            is_element,
+            inside_a_frame,
+            target_to_check.options[:stitch_content],
+            force_full_page_screenshot
           )
 
           case screenshot_type
@@ -329,14 +291,14 @@ module Applitools::Selenium
               eyes_element.scroll_data_attribute = true
               eyes_element.overflow_data_attribute = original_overflow
               self.position_provider = Applitools::Selenium::CssTranslateElementPositionProvider.new(
-                  driver,
-                  eyes_element
+                driver,
+                eyes_element
               )
             end
           end
 
           check_window_base(
-              region_provider, timeout, match_data
+            region_provider, timeout, match_data
           )
         ensure
           eyes_element.overflow = original_overflow unless original_overflow.nil?
@@ -352,38 +314,6 @@ module Applitools::Selenium
       self.prevent_dom_processing = false
     end
 
-    # Validates the contents of an iframe and matches it with the expected output.
-    #
-    # @param [Hash] options The specific parameters of the desired screenshot.
-    # @option options [Array] :target_frames The frames to check.
-    def check_in_frame(options)
-      frames = options.delete :target_frames
-
-      Applitools::ArgumentGuard.is_a? options, 'options', Hash
-      Applitools::ArgumentGuard.is_a? frames, 'target_frames: []', Array
-
-      return yield if block_given? && frames.empty?
-
-      original_frame_chain = driver.frame_chain
-
-      logger.info 'Switching to target frame according to frames path...'
-      driver.switch_to.frames(frames_path: frames)
-      frame_chain_to_reset = driver.frame_chain
-      logger.info 'Done!'
-
-      ensure_frame_visible
-
-      yield if block_given?
-
-      reset_frames_scroll_position(frame_chain_to_reset)
-
-      logger.info 'Switching back into top level frame...'
-      driver.switch_to.default_content
-      return unless original_frame_chain
-      logger.info 'Switching back into original frame...'
-      driver.switch_to.frames frame_chain: original_frame_chain
-    end
-
     # Creates a region instance.
     #
     # @param [Applitools::Element] element The element.
@@ -400,16 +330,16 @@ module Applitools::Selenium
       border_bottom_width = element.border_bottom_width
 
       Applitools::Region.new(
-          p.x.round + border_left_width,
-          p.y.round + border_top_width,
-          d.width - border_left_width - border_right_width,
-          d.height - border_top_width - border_bottom_width
+        p.x.round + border_left_width,
+        p.y.round + border_top_width,
+        d.width - border_left_width - border_right_width,
+        d.height - border_top_width - border_bottom_width
       ).tap do |r|
         border_padding = Applitools::PaddingBounds.new(
-            border_left_width,
-            border_top_width,
-            border_right_width,
-            border_bottom_width
+          border_left_width,
+          border_top_width,
+          border_right_width,
+          border_bottom_width
         )
         r.padding(border_padding)
       end
@@ -418,95 +348,6 @@ module Applitools::Selenium
     private :check_in_frame
     private :region_for_element
 
-    # Takes a snapshot of the application under test and matches a region of
-    # a specific element with the expected region output.
-    #
-    # @param [Applitools::Selenium::Element] element Represents a region to check.
-    # @param [Symbol] how a finder, such :css or :id. Selects a finder will be used to find an element
-    #   See Selenium::Webdriver::Element#find_element documentation for full list of possible finders.
-    # @param [String] what The value will be passed to a specified finder. If finder is :css it must be a css selector.
-    # @param [Hash] options
-    # @option options [String] :tag An optional tag to be associated with the snapshot.
-    # @option options [Fixnum] :match_timeout The amount of time to retry matching. (Seconds)
-    # @option options [Boolean] :stitch_content If set to true, will try to get full content of the element
-    #   (including hidden content due overflow settings) by scrolling the element,
-    #   taking and stitching partial screenshots.
-    # @example Check region by element
-    #   check_region(element, tag: 'Check a region by element', match_timeout: 3, stitch_content: false)
-    # @example Check region by css selector
-    #   check_region(:css, '.form-row .input#e_mail', tag: 'Check a region by element', match_timeout: 3,
-    #   stitch_content: false)
-    # @!parse def check_region(element, how=nil, what=nil, options = {}); end
-    def check_region(*args)
-      options = { timeout: USE_DEFAULT_MATCH_TIMEOUT, tag: nil }.merge! Applitools::Utils.extract_options!(args)
-      target = Applitools::Selenium::Target.new.region(*args).timeout(options[:match_timeout])
-      target.fully if options[:stitch_content]
-      check(options[:tag], target)
-    end
-
-    # Validates the contents of an iframe and matches it with the expected output.
-    #
-    # @param [Hash] options The specific parameters of the desired screenshot.
-    # @option options [Fixnum] :timeout The amount of time to retry matching. (Seconds)
-    # @option options [String] :tag An optional tag to be associated with the snapshot.
-    # @option options [String] :frame Frame element or frame name or frame id.
-    # @option options [String] :name_or_id The name or id of the target frame (deprecated. use :frame instead).
-    # @option options [String] :frame_element The frame element (deprecated. use :frame instead).
-    # @return [Applitools::MatchResult] The match results.
-
-    def check_frame(options = {})
-      options = { timeout: USE_DEFAULT_MATCH_TIMEOUT, tag: nil }.merge!(options)
-      frame = options[:frame] || options[:frame_element] || options[:name_or_id]
-      target = Applitools::Selenium::Target.frame(frame).timeout(options[:timeout]).fully
-      check(options[:tag], target)
-    end
-
-    # Validates the contents of a region in an iframe and matches it with the expected output.
-    #
-    # @param [Hash] options The specific parameters of the desired screenshot.
-    # @option options [String] :name_or_id The name or id of the target frame (deprecated. use :frame instead).
-    # @option options [String] :frame_element The frame element (deprecated. use :frame instead).
-    # @option options [String] :frame Frame element or frame name or frame id.
-    # @option options [String] :tag An optional tag to be associated with the snapshot.
-    # @option options [Symbol] :by By which identifier to find the region (e.g :css, :id).
-    # @option options [Fixnum] :timeout The amount of time to retry matching. (Seconds)
-    # @option options [Boolean] :stitch_content Whether to stitch the content or not.
-    # @return [Applitools::MatchResult] The match results.
-    def check_region_in_frame(options = {})
-      options = { timeout: USE_DEFAULT_MATCH_TIMEOUT, tag: nil, stitch_content: false }.merge!(options)
-      Applitools::ArgumentGuard.not_nil options[:by], 'options[:by]'
-      Applitools::ArgumentGuard.is_a? options[:by], 'options[:by]', Array
-
-      how_what = options.delete(:by)
-      frame = options[:frame] || options[:frame_element] || options[:name_or_id]
-
-      target = Applitools::Selenium::Target.new.timeout(options[:timeout])
-      target.frame(frame) if frame
-      target.fully if options[:stitch_content]
-      target.region(*how_what)
-
-      check(options[:tag], target)
-    end
-
-    # Use this method to perform seamless testing with selenium through eyes driver.
-    # It yields a block and passes to it an Applitools::Selenium::Driver instance, which wraps standard driver.
-    # Using Selenium methods inside the 'test' block will send the messages to Selenium
-    # after creating the Eyes triggers for them. Options are similar to {open}
-    # @yieldparam driver [Applitools::Selenium::Driver] Gives a driver to a block, which translates calls to a native
-    #   Selemium::Driver instance
-    # @example
-    #   eyes.test(app_name: 'my app', test_name: 'my test') do |driver|
-    #      driver.get "http://www.google.com"
-    #      driver.check_window("initial")
-    #   end
-    def test(options = {}, &_block)
-      open(options)
-      yield(driver)
-      close
-    ensure
-      abort_if_not_closed
-    end
-
     # @!visibility private
     def scroll_to_region
       region_visibility_strategy.is_a? Applitools::Selenium::MoveToRegionVisibilityStrategy
@@ -531,17 +372,21 @@ module Applitools::Selenium
       end
     end
 
+    def close_async
+      close(false)
+    end
+
     private
 
     attr_accessor :check_frame_or_element, :region_to_check, :dont_get_title,
-                  :device_pixel_ratio, :position_provider, :scale_provider, :tag_for_debug,
-                  :region_visibility_strategy, :eyes_screenshot_factory, :force_driver_resolution_as_viewport_size,
-                  :prevent_dom_processing
+      :device_pixel_ratio, :position_provider, :scale_provider, :tag_for_debug,
+      :region_visibility_strategy, :eyes_screenshot_factory, :force_driver_resolution_as_viewport_size,
+      :prevent_dom_processing
 
     def image_provider
       Applitools::Selenium::TakesScreenshotImageProvider.new(
-          driver,
-          debug_screenshot_provider: debug_screenshot_provider
+        driver,
+        debug_screenshot_provider: debug_screenshot_provider
       )
     end
 
@@ -561,7 +406,7 @@ module Applitools::Selenium
 
       begin
         algo = Applitools::Selenium::FullPageCaptureAlgorithm.new(
-            debug_screenshot_provider: debug_screenshot_provider
+          debug_screenshot_provider: debug_screenshot_provider
         )
         case screenshot_type
         when ENTIRE_ELEMENT_SCREENSHOT
@@ -587,15 +432,15 @@ module Applitools::Selenium
       region_provider = Applitools::Selenium::RegionProvider.new(driver, Applitools::Region::EMPTY)
 
       full_page_image = algo.get_stitched_region(
-          image_provider: image_provider,
-          region_to_check: region_provider,
-          origin_provider: Applitools::Selenium::ScrollPositionProvider.new(driver),
-          position_provider: position_provider,
-          scale_provider: scale_provider,
-          cut_provider: cut_provider,
-          wait_before_screenshots: wait_before_screenshots,
-          eyes_screenshot_factory: eyes_screenshot_factory,
-          stitching_overlap: stitching_overlap
+        image_provider: image_provider,
+        region_to_check: region_provider,
+        origin_provider: Applitools::Selenium::ScrollPositionProvider.new(driver),
+        position_provider: position_provider,
+        scale_provider: scale_provider,
+        cut_provider: cut_provider,
+        wait_before_screenshots: wait_before_screenshots,
+        eyes_screenshot_factory: eyes_screenshot_factory,
+        stitching_overlap: stitching_overlap
       )
 
       # binding.pry
@@ -606,8 +451,8 @@ module Applitools::Selenium
       end
       logger.info 'Creating EyesWebDriver screenshot instance..'
       result = Applitools::Selenium::FullpageScreenshot.new(
-          full_page_image,
-          region_provider: region_to_check
+        full_page_image,
+        region_provider: region_to_check
       )
       logger.info 'Done creating EyesWebDriver screenshot instance!'
       result
@@ -616,22 +461,22 @@ module Applitools::Selenium
     def entire_element_screenshot(algo)
       logger.info 'Entire element screenshot requested'
       entire_frame_or_element = algo.get_stitched_region(
-          image_provider: image_provider,
-          region_to_check: region_to_check,
-          origin_provider: position_provider,
-          position_provider: position_provider,
-          scale_provider: scale_provider,
-          cut_provider: cut_provider,
-          wait_before_screenshots: wait_before_screenshots,
-          eyes_screenshot_factory: eyes_screenshot_factory,
-          stitching_overlap: stitching_overlap,
-          top_left_position: full_page_capture_algorithm_left_top_offset
+        image_provider: image_provider,
+        region_to_check: region_to_check,
+        origin_provider: position_provider,
+        position_provider: position_provider,
+        scale_provider: scale_provider,
+        cut_provider: cut_provider,
+        wait_before_screenshots: wait_before_screenshots,
+        eyes_screenshot_factory: eyes_screenshot_factory,
+        stitching_overlap: stitching_overlap,
+        top_left_position: full_page_capture_algorithm_left_top_offset
       )
 
       logger.info 'Building screenshot object (EyesStitchedElementScreenshot)...'
       result = Applitools::Selenium::EntireElementScreenshot.new(
-          entire_frame_or_element,
-          region_provider: region_to_check
+        entire_frame_or_element,
+        region_provider: region_to_check
       )
       logger.info 'Done!'
       result
@@ -692,7 +537,7 @@ module Applitools::Selenium
 
       begin
         self.scale_provider = Applitools::Selenium::ContextBasedScaleProvider.new(position_provider.entire_size,
-                                                                                  viewport_size, device_pixel_ratio)
+          viewport_size, device_pixel_ratio)
       rescue StandardError
         logger.info 'Failed to set ContextBasedScaleProvider'
         logger.info 'Using FixedScaleProvider instead'
@@ -856,7 +701,7 @@ module Applitools::Selenium
 
     class << self
       def position_provider(stitch_mode, driver, disable_horizontal = false, disable_vertical = false,
-                            explicit_entire_size = nil)
+        explicit_entire_size = nil)
 
         max_width = nil
         max_height = nil
@@ -867,10 +712,10 @@ module Applitools::Selenium
         case stitch_mode
         when Applitools::Selenium::StitchModes::SCROLL
           Applitools::Selenium::ScrollPositionProvider.new(driver, disable_horizontal, disable_vertical,
-                                                           max_width, max_height)
+            max_width, max_height)
         when Applitools::Selenium::StitchModes::CSS
           Applitools::Selenium::CssTranslatePositionProvider.new(driver, disable_horizontal, disable_vertical,
-                                                                 max_width, max_height)
+            max_width, max_height)
         end
       end
     end