watir 6.1.0 → 6.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 97b12fa8cee06abcdffeeefdb6a8455ad6abfdb2
-  data.tar.gz: 661c429b9dcf2eb4fe1ee856a7938c93ff3582d0
+  metadata.gz: c7a75c3cb00c09caec743b797d7b5590fc81938c
+  data.tar.gz: a0d2f54bca3c49c1b9c893e0f767f3015f4b00e4
 SHA512:
-  metadata.gz: 69f706e5998202121957302950f0c71e14359032160924f066474c680f766635de7018f8eb470d6171e7993593c88beb883f1092ebe8fe3014d4d720e29d5cf9
-  data.tar.gz: d85aec3e1d158e6fd19ba5f176ce7711d762e7f2748faa686e4de8e28a8a687271efe711feee5fd2ac4e3fa26b6ded54c2cbfbdd46bd76695d443370a3ea8793
+  metadata.gz: 3600748e11ba3740795eb9d80292d4b71ed0fa2798806f27c9e2a2fcf97308a4024fb231a36ba91e2a58de50852ede60b152d51449b97f754276e316d2a8f525
+  data.tar.gz: ca859e2face12ccdfa90cd4935a00b196ef6b8f4555e28f71f1abaffd6f054416a7d5f8d49c218eb9635e4ab936657c0aee080f9b9948bdadcf1375070c088d7

data/.travis.yml

@@ -1,4 +1,5 @@
-sudo: false
+dist: trusty
+sudo: require
 rvm:
   - 2.2.6
   - 2.3.3
@@ -9,6 +10,7 @@ addons:
     packages:
       - unzip
       - libxss1
+      - google-chrome-stable
 cache: bundler
 notifications:
   recipients:

data/CHANGES.md

@@ -1,3 +1,11 @@
+### 6.2.0 (2017-02-20)
+
+* `Element#wait_while_present` exits when locator no longer matches
+* Element Collections store specific element types rather than just `HTMLElement`
+* Implement adjacent element location for parent, siblings and children
+* Add support for assigning keywords to `Element` for better error messaging
+* Update actions implementation to work with selenium-webdriver > 3.0.5
+
 ### 6.1.0 (2017-01-04)
 
 * Add Ruby 2.4.0 support (thanks Robert MacCracken)

data/lib/watir.rb

@@ -6,6 +6,7 @@ require 'watir/exception'
 require 'watir/xpath_support'
 require 'watir/window'
 require 'watir/has_window'
+require 'watir/adjacent'
 require 'watir/alert'
 require 'watir/atoms'
 require 'watir/container'

data/lib/watir/adjacent.rb

@@ -0,0 +1,120 @@
+module Watir
+  module Adjacent
+
+    #
+    # Returns parent element of current element.
+    #
+    # @example
+    #   browser.text_field(name: "new_user_first_name").parent == browser.fieldset
+    #   #=> true
+    #
+
+    def parent(opt = {})
+      opt[:index] ||= 0
+      xpath_adjacent("ancestor::", opt)
+    end
+
+    #
+    # Returns preceding sibling element of current element.
+    #
+    # @example
+    #   browser.text_field(name: "new_user_first_name").preceding_sibling(index: 1) == browser.legend
+    #   #=> true
+    #
+
+    def preceding_sibling(opt = {})
+      opt[:index] ||= 0
+      xpath_adjacent("preceding-sibling::", opt)
+    end
+    alias_method :previous_sibling, :preceding_sibling
+
+    #
+    # Returns collection of preceding sibling elements of current element.
+    #
+    # @example
+    #   browser.text_field(name: "new_user_first_name").preceding_siblings.size
+    #   #=> 3
+    #
+
+    def preceding_siblings(opt = {})
+      raise ArgumentError, "#previous_siblings can not take an index value" if opt[:index]
+      xpath_adjacent("preceding-sibling::", opt)
+    end
+    alias_method :previous_siblings, :preceding_siblings
+
+    #
+    # Returns following sibling element of current element.
+    #
+    # @example
+    #   browser.text_field(name: "new_user_first_name").following_sibling(index: 2) == browser.text_field(id: "new_user_last_name")
+    #   #=> true
+    #
+
+    def following_sibling(opt = {})
+      opt[:index] ||= 0
+      xpath_adjacent("following-sibling::", opt)
+    end
+    alias_method :next_sibling, :following_sibling
+
+    #
+    # Returns collection of following sibling elements of current element.
+    #
+    # @example
+    #   browser.text_field(name: "new_user_first_name").following_siblings.size
+    #   #=> 52
+    #
+
+    def following_siblings(opt = {})
+      raise ArgumentError, "#next_siblings can not take an index value" if opt[:index]
+      xpath_adjacent("following-sibling::", opt)
+    end
+    alias_method :next_siblings, :following_siblings
+
+    #
+    # Returns element of direct child of current element.
+    #
+    # @example
+    #   browser.form(id: "new_user").child == browser.fieldset
+    #   #=> true
+    #
+
+    def child(opt = {})
+      opt[:index] ||= 0
+      xpath_adjacent('', opt)
+    end
+
+    #
+    # Returns collection of elements of direct children of current element.
+    #
+    # @example
+    #   browser.select_list(id: "new_user_languages").children == browser.select_list(id: "new_user_languages").options.to_a
+    #   #=> true
+    #
+
+    def children(opt = {})
+      raise ArgumentError, "#children can not take an index value" if opt[:index]
+      xpath_adjacent('', opt)
+    end
+
+    private
+
+    def xpath_adjacent(direction = '', opt = {})
+      opt = opt.dup
+      index = opt.delete :index
+      tag_name = opt.delete :tag_name
+      unless opt.empty?
+        caller = caller_locations(1, 1)[0].label
+        raise ArgumentError, "unsupported locators: #{opt.inspect} for ##{caller} method"
+      end
+
+      if index
+        klass = tag_name ? self.send(tag_name).class : HTMLElement
+        klass.new(self, xpath: "./#{direction}#{tag_name || '*'}[#{index + 1}]")
+      else
+        klass = tag_name ? Object.const_get("#{self.send(tag_name).class}Collection") : HTMLElementCollection
+        klass.new(self, xpath: "./#{direction}#{tag_name || '*'}")
+      end
+    end
+
+  end # Adjacent
+end # Watir

data/lib/watir/atoms.rb

@@ -10,7 +10,6 @@ module Watir
     load :fireEvent
     load :getOuterHtml
     load :getInnerHtml
-    load :getParentElement
 
     private
 

data/lib/watir/element_collection.rb

@@ -35,7 +35,7 @@ module Watir
     #
 
     def length
-      elements.length
+      to_a.length
     end
     alias_method :size, :length
 
@@ -80,12 +80,37 @@ module Watir
     #
 
     def to_a
-      # TODO: optimize - lazy element_class instance?
       @to_a ||= elements.map.with_index do |e, idx|
-        element_class.new(@query_scope, @selector.merge(element: e, index: idx))
+        element = element_class.new(@query_scope, @selector.merge(element: e, index: idx))
+        element_class == Watir::HTMLElement ? element.to_subtype : element
       end
     end
 
+    #
+    # Returns true if two element collections are equal.
+    #
+    # @example
+    #   browser.select_list(name: "new_user_languages").options == browser.select_list(id: "new_user_languages").options
+    #   #=> true
+    #
+    # @example
+    #   browser.select_list(name: "new_user_role").options == browser.select_list(id: "new_user_languages").options
+    #   #=> false
+    #
+
+    def ==(other)
+      to_a == other.to_a
+    end
+    alias_method :eql?, :==
+
+    #
+    # Creates a Collection containing elements of two collections.
+    #
+    # @example
+    #   (browser.select_list(name: "new_user_languages").options + browser.select_list(id: "new_user_role").options).size
+    #   #=> 8
+    #
+
     private
 
     def elements

data/lib/watir/elements/element.rb

@@ -11,6 +11,9 @@ module Watir
     include Container
     include EventuallyPresent
     include Waitable
+    include Adjacent
+
+    attr_accessor :keyword
 
     #
     # temporarily add :id and :class_name manually since they're no longer specified in the HTML spec.
@@ -49,11 +52,16 @@ module Watir
     alias_method :exist?, :exists?
 
     def inspect
+      string = "#<#{self.class}: "
+      string << "keyword: #{keyword} " if keyword
+      string << "located: #{!!@element}; "
       if @selector.empty?
-        '#<%s:0x%x located=%s selector=%s>' % [self.class, hash*2, !!@element, '{element: (selenium element)}']
+        string << '{element: (selenium element)}'
       else
-        '#<%s:0x%x located=%s selector=%s>' % [self.class, hash*2, !!@element, selector_string]
+        string << selector_string
       end
+      string << '>'
+      string
     end
 
     #
@@ -113,8 +121,6 @@ module Watir
     def click(*modifiers)
       element_call(:wait_for_enabled) do
         if modifiers.any?
-          assert_has_input_devices_for "click(#{modifiers.join ', '})"
-
           action = driver.action
           modifiers.each { |mod| action.key_down mod }
           action.click @element
@@ -138,8 +144,6 @@ module Watir
     #
 
     def double_click
-      assert_has_input_devices_for :double_click
-
       element_call(:wait_for_present) { driver.action.double_click(@element).perform }
       browser.after_hooks.run
     end
@@ -153,8 +157,6 @@ module Watir
     #
 
     def right_click
-      assert_has_input_devices_for :right_click
-
       element_call(:wait_for_present) { driver.action.context_click(@element).perform }
       browser.after_hooks.run
     end
@@ -168,8 +170,6 @@ module Watir
     #
 
     def hover
-      assert_has_input_devices_for :hover
-
       element_call(:wait_for_present) { driver.action.move_to(@element).perform }
     end
 
@@ -185,7 +185,6 @@ module Watir
 
     def drag_and_drop_on(other)
       assert_is_element other
-      assert_has_input_devices_for :drag_and_drop_on
 
       element_call(:wait_for_present) do
         driver.action.
@@ -206,8 +205,6 @@ module Watir
     #
 
     def drag_and_drop_by(right_by, down_by)
-      assert_has_input_devices_for :drag_and_drop_by
-
       element_call(:wait_for_present) do
         driver.action.
                drag_and_drop_by(@element, right_by, down_by).
@@ -345,18 +342,6 @@ module Watir
       element_call { execute_atom :fireEvent, @element, event_name }
     end
 
-    #
-    # Returns parent element of current element.
-    #
-
-    def parent
-      e = element_call { execute_atom :getParentElement, @element }
-
-      if e.kind_of?(Selenium::WebDriver::Element)
-        Watir.element_class_for(e.tag_name.downcase).new(@query_scope, element: e)
-      end
-    end
-
     #
     # @api private
     #
@@ -488,6 +473,10 @@ module Watir
       true
     end
 
+    def reset!
+      @element = nil
+    end
+
     protected
 
     def wait_for_exists
@@ -505,7 +494,7 @@ module Watir
           warn message
         end
         raise unknown_exception, "timed out after #{Watir.default_timeout} seconds, "\
-                                         "waiting for #{selector_string} to be located"
+                                         "waiting for #{inspect} to be located"
       end
     end
 
@@ -534,7 +523,7 @@ module Watir
       begin
         wait_until(&:enabled?)
       rescue Watir::Wait::TimeoutError
-        message = "element present, but timed out after #{Watir.default_timeout} seconds, waiting for #{selector_string} to be enabled"
+        message = "element present, but timed out after #{Watir.default_timeout} seconds, waiting for #{inspect} to be enabled"
         raise ObjectDisabledException, message
       end
     end
@@ -546,7 +535,7 @@ module Watir
       begin
         wait_until { !respond_to?(:readonly?) || !readonly? }
       rescue Watir::Wait::TimeoutError
-        message = "element present and enabled, but timed out after #{Watir.default_timeout} seconds, waiting for #{selector_string} to not be readonly"
+        message = "element present and enabled, but timed out after #{Watir.default_timeout} seconds, waiting for #{inspect} to not be readonly"
         raise ObjectReadOnlyException, message
       end
     end
@@ -555,7 +544,7 @@ module Watir
     def assert_exists
       if @element && @selector.empty?
         ensure_context
-        @element = nil if stale?
+        @element.reset! if stale?
       elsif @element && !stale?
         return
       else
@@ -567,7 +556,7 @@ module Watir
 
     def assert_element_found
       unless @element
-        raise unknown_exception, "unable to locate element, using #{selector_string}"
+        raise unknown_exception, "unable to locate element: #{inspect}"
       end
     end
 
@@ -625,7 +614,7 @@ module Watir
 
     def assert_enabled
       unless element_call { @element.enabled? }
-        raise ObjectDisabledException, "object is disabled #{selector_string}"
+        raise ObjectDisabledException, "object is disabled #{inspect}"
       end
     end
 
@@ -633,13 +622,7 @@ module Watir
       assert_enabled
 
       if respond_to?(:readonly?) && readonly?
-        raise ObjectReadOnlyException, "object is read only #{selector_string}"
-      end
-    end
-
-    def assert_has_input_devices_for(name)
-      unless driver.kind_of? Selenium::WebDriver::DriverExtensions::HasInputDevices
-        raise NotImplementedError, "#{self.class}##{name} is not supported by this driver"
+        raise ObjectReadOnlyException, "object is read only #{inspect}"
       end
     end
 

data/lib/watir/wait.rb

@@ -121,7 +121,7 @@ module Watir
         timeout = deprecated_timeout
         message = deprecated_message
       end
-      message ||= "waiting for true condition on #{selector_string}"
+      message ||= "waiting for true condition on #{inspect}"
       Wait.until(timeout: timeout, message: message, interval: interval, object: self, &blk)
 
       self
@@ -147,7 +147,7 @@ module Watir
         timeout = deprecated_timeout
         message = deprecated_message
       end
-      message ||= "waiting for false condition on #{selector_string}"
+      message ||= "waiting for false condition on #{inspect}"
       Wait.while(timeout: timeout, message: message, interval: interval, object: self, &blk)
 
       self
@@ -190,7 +190,10 @@ module Watir
         warn "Instead of passing arguments into #wait_while_present method, use keywords"
         timeout = deprecated_timeout
       end
-      wait_while(timeout: timeout, &:present?)
+      wait_while(timeout: timeout) do
+        self.reset! if self.is_a? Watir::Element
+        self.present?
+      end
     end
 
   end # Waitable

data/spec/element_spec.rb

@@ -76,7 +76,7 @@ describe Watir::Element do
 
       watir_element = browser.div(id: "text")
 
-        # simulate element going stale after assert_exists and before action taken, but not when block retried
+      # simulate element going stale after assert_exists and before action taken, but not when block retried
       allow(watir_element).to receive(:text) do
         watir_element.send(:element_call) do
           @already_stale ||= false
@@ -106,33 +106,54 @@ describe Watir::Element do
     end
   end
 
-  describe "#selector_string" do
-    it "displays selector string for regular element" do
-      browser.goto(WatirSpec.url_for("wait.html"))
+  describe "#inspect" do
+    before(:each) { browser.goto(WatirSpec.url_for("nested_iframes.html")) }
+
+    it "does displays specified element type" do
+      expect(browser.div.inspect).to include('Watir::Div')
+    end
+
+    it "does not display element type if not specified" do
+      element = browser.element(index: 4)
+      expect(element.inspect).to include('Watir::HTMLElement')
+    end
+
+    it "displays keyword if specified" do
+      element = browser.h3
+      element.keyword = 'foo'
+      expect(element.inspect).to include('keyword: foo')
+    end
+
+    it "does not display keyword if not specified" do
+      element = browser.h3
+      expect(element.inspect).to_not include('keyword')
+    end
+
+    it "locate is false when not located" do
       element = browser.div(:id, 'not_present')
-      error = 'timed out after 0 seconds, waiting for true condition on {:id=>"not_present", :tag_name=>"div"}'
-      expect { element.wait_until_present(timeout: 0) }.to raise_exception(Watir::Wait::TimeoutError, error)
+      expect(element.inspect).to include('located: false')
+    end
+
+    it "locate is true when located" do
+      element = browser.h3
+      element.exists?
+      expect(element.inspect).to include('located: true')
     end
 
     it "displays selector string for element from colection" do
-      browser.goto(WatirSpec.url_for("wait.html"))
-      element = browser.divs.last
-      error = 'timed out after 0 seconds, waiting for true condition on {:tag_name=>"div", :index=>5}'
-      expect { element.wait_until_present(timeout: 0) }.to raise_exception(Watir::Wait::TimeoutError, error)
+      elements = browser.frames
+      expect(elements.last.inspect).to include '{:tag_name=>"frame", :index=>-1}'
     end
 
     it "displays selector string for nested element" do
       browser.goto(WatirSpec.url_for("wait.html"))
-      element = browser.div(index: -1).div(:id, 'foo')
-      error = 'timed out after 0 seconds, waiting for true condition on {:index=>-1, :tag_name=>"div"} --> {:id=>"foo", :tag_name=>"div"}'
-      expect { element.wait_until_present(timeout: 0) }.to raise_exception(Watir::Wait::TimeoutError, error)
+      element = browser.div(index: 1).div(id: 'div2')
+      expect(element.inspect).to include '{:index=>1, :tag_name=>"div"} --> {:id=>"div2", :tag_name=>"div"}'
     end
 
     it "displays selector string for nested element under frame" do
-      browser.goto(WatirSpec.url_for("nested_iframes.html"))
-      element = browser.iframe(id: 'one').iframe(:id, 'three')
-      error = 'unable to locate iframe using {:id=>"one", :tag_name=>"iframe"} --> {:id=>"three", :tag_name=>"iframe"}'
-      expect { element.wait_until_present(timeout: 0) }.to raise_exception(Watir::Exception::UnknownFrameException, error)
+      element = browser.iframe(id: 'one').iframe(id: 'three')
+      expect(element.inspect).to include '{:id=>"one", :tag_name=>"iframe"} --> {:id=>"three", :tag_name=>"iframe"}'
     end
   end
 end

data/spec/spec_helper.rb

@@ -14,14 +14,7 @@ if ENV['RELAXED_LOCATE'] == "false"
   Watir.relaxed_locate = false
 end
 
-if ENV['TRAVIS']
-  ENV['DISPLAY'] = ":99.0"
-
-  if ENV['WATIR_BROWSER'] == "chrome"
-    ENV['WATIR_CHROME_BINARY'] = File.expand_path "chrome-linux/chrome"
-    ENV['WATIR_CHROME_DRIVER'] = File.expand_path "chrome-linux/chromedriver"
-  end
-end
+ENV['DISPLAY'] = ':99.0' if ENV['TRAVIS']
 
 if Selenium::WebDriver::Platform.linux? && ENV['DISPLAY'].nil?
   raise "DISPLAY not set"

data/spec/watirspec/adjacent_spec.rb

@@ -0,0 +1,164 @@
+require "watirspec_helper"
+
+describe "Adjacent Elements" do
+  before(:all) do
+    browser.goto(WatirSpec.url_for("nested_elements.html"))
+  end
+
+  describe "#parent" do
+    it "gets immediate parent of an element by default" do
+      expect(browser.div(id: "first_sibling").parent.id).to eq 'parent'
+      expect(browser.div(id: "first_sibling").parent).to be_a Watir::HTMLElement
+    end
+
+    it "accepts index argument" do
+      expect(browser.div(id: "first_sibling").parent(index: 2).id).to eq 'grandparent'
+      expect(browser.div(id: "first_sibling").parent(index: 2)).to be_a Watir::HTMLElement
+    end
+
+    it "accepts tag_name argument" do
+      expect(browser.div(id: "first_sibling").parent(tag_name: :div).id).to eq 'parent'
+      expect(browser.div(id: "first_sibling").parent(tag_name: :div)).to be_a Watir::Div
+    end
+
+    it "accepts index and tag_name arguments" do
+      expect(browser.div(id: "first_sibling").parent(tag_name: :div, index: 1).id).to eq 'grandparent'
+      expect(browser.div(id: "first_sibling").parent(tag_name: :div, index: 1)).to be_a Watir::Div
+    end
+
+    it "does not error when no parent element of an index exists" do
+      expect(browser.body.parent(index: 2)).to_not exist
+    end
+
+    it "does not error when no parent element of a tag_name exists" do
+      expect(browser.div(id: "first_sibling").parent(tag_name: :table)).to_not exist
+    end
+  end
+
+  describe "#following_sibling" do
+    it "gets immediate following sibling of an element by default" do
+      expect(browser.div(id: "first_sibling").following_sibling.id).to eq 'between_siblings1'
+      expect(browser.div(id: "first_sibling").following_sibling).to be_a Watir::HTMLElement
+    end
+
+    it "accepts index argument" do
+      expect(browser.div(id: "first_sibling").following_sibling(index: 2).id).to eq 'between_siblings2'
+      expect(browser.div(id: "first_sibling").following_sibling(index: 2)).to be_a Watir::HTMLElement
+    end
+
+    it "accepts tag_name argument" do
+      expect(browser.div(id: "first_sibling").following_sibling(tag_name: :div).id).to eq 'second_sibling'
+      expect(browser.div(id: "first_sibling").following_sibling(tag_name: :div)).to be_a Watir::Div
+    end
+
+    it "accepts index and tag_name arguments" do
+      expect(browser.div(id: "first_sibling").following_sibling(tag_name: :div, index: 1).id).to eq 'third_sibling'
+      expect(browser.div(id: "first_sibling").following_sibling(tag_name: :div, index: 1)).to be_a Watir::Div
+    end
+
+    it "does not error when no next sibling of an index exists" do
+      expect(browser.body.following_sibling(index: 1)).to_not exist
+    end
+
+    it "does not error when no next sibling of a tag_name exists" do
+      expect(browser.div(id: "first_sibling").following_sibling(tag_name: :table)).to_not exist
+    end
+  end
+
+  describe "#following_siblings" do
+    it "gets collection of subsequent siblings of an element by default" do
+      expect(browser.div(id: "second_sibling").following_siblings).to be_a Watir::HTMLElementCollection
+      expect(browser.div(id: "second_sibling").following_siblings.size).to eq 2
+    end
+
+    it "accepts tag_name argument" do
+      expect(browser.div(id: "second_sibling").following_siblings(tag_name: :div).size).to eq 1
+      expect(browser.div(id: "second_sibling").following_siblings(tag_name: :div).first).to be_a Watir::Div
+    end
+  end
+
+  describe "#previous_sibling" do
+    it "gets immediate preceeding sibling of an element by default" do
+      expect(browser.div(id: "third_sibling").previous_sibling.id).to eq 'between_siblings2'
+      expect(browser.div(id: "third_sibling").previous_sibling).to be_a Watir::HTMLElement
+    end
+
+    it "accepts index argument" do
+      expect(browser.div(id: "third_sibling").previous_sibling(index: 2).id).to eq 'between_siblings1'
+      expect(browser.div(id: "third_sibling").previous_sibling(index: 2)).to be_a Watir::HTMLElement
+    end
+
+    it "accepts tag_name argument" do
+      expect(browser.div(id: "third_sibling").previous_sibling(tag_name: :div).id).to eq 'second_sibling'
+      expect(browser.div(id: "third_sibling").previous_sibling(tag_name: :div)).to be_a Watir::Div
+    end
+
+    it "accepts index and tag_name arguments" do
+      expect(browser.div(id: "third_sibling").previous_sibling(tag_name: :div, index: 1).id).to eq 'first_sibling'
+      expect(browser.div(id: "third_sibling").previous_sibling(tag_name: :div, index: 1)).to be_a Watir::Div
+    end
+
+    it "does not error when no next sibling of an index exists" do
+      expect(browser.body.previous_sibling(index: 1)).to_not exist
+    end
+
+    it "does not error when no next sibling of a tag_name exists" do
+      expect(browser.div(id: "third_sibling").previous_sibling(tag_name: :table)).to_not exist
+    end
+  end
+
+  describe "#previous_siblings" do
+    it "gets collection of previous siblings of an element by default" do
+      expect(browser.div(id: "second_sibling").previous_siblings).to be_a Watir::HTMLElementCollection
+      expect(browser.div(id: "second_sibling").previous_siblings.size).to eq 2
+    end
+
+    it "accepts tag_name argument" do
+      expect(browser.div(id: "second_sibling").previous_siblings(tag_name: :div).size).to eq 1
+      expect(browser.div(id: "second_sibling").previous_siblings(tag_name: :div).first).to be_a Watir::Div
+    end
+  end
+
+  describe "#child" do
+    it "gets immediate child of an element by default" do
+      expect(browser.div(id: "parent").child.id).to eq 'first_sibling'
+      expect(browser.div(id: "parent").child).to be_a Watir::HTMLElement
+    end
+
+    it "accepts index argument" do
+      expect(browser.div(id: "parent").child(index: 2).id).to eq 'second_sibling'
+      expect(browser.div(id: "parent").child(index: 2)).to be_a Watir::HTMLElement
+    end
+
+    it "accepts tag_name argument" do
+      expect(browser.div(id: "parent").child(tag_name: :span).id).to eq 'between_siblings1'
+      expect(browser.div(id: "parent").child(tag_name: :span)).to be_a Watir::Span
+    end
+
+    it "accepts index and tag_name arguments" do
+      expect(browser.div(id: "parent").child(tag_name: :div, index: 1).id).to eq 'second_sibling'
+      expect(browser.div(id: "parent").child(tag_name: :div, index: 1)).to be_a Watir::Div
+    end
+
+    it "does not error when no next sibling of an index exists" do
+      expect(browser.div(id: "second_sibling").child(index: 1)).to_not exist
+    end
+
+    it "does not error when no next sibling of a tag_name exists" do
+      expect(browser.div(id: "parent").child(tag_name: :table)).to_not exist
+    end
+  end
+
+  describe "#children" do
+    it "gets collection of children of an element by default" do
+      expect(browser.div(id: "parent").children).to be_a Watir::HTMLElementCollection
+      expect(browser.div(id: "parent").children.size).to eq 5
+    end
+
+    it "accepts tag_name argument" do
+      children = browser.div(id: "parent").children(tag_name: :div)
+      expect(children.size).to eq 3
+      expect(children.all? { |child| child.is_a? Watir::Div }).to eq true
+    end
+  end
+end

data/spec/watirspec/elements/collections_spec.rb

@@ -2,15 +2,26 @@ require "watirspec_helper"
 
 describe "Collections" do
 
-  before :each do
-    browser.goto(WatirSpec.url_for("collections.html"))
-  end
-
   it "returns inner elements of parent element having different html tag" do
+    browser.goto(WatirSpec.url_for("collections.html"))
     expect(browser.span(id: "a_span").divs.size).to eq 2
   end
 
   it "returns inner elements of parent element having same html tag" do
+    browser.goto(WatirSpec.url_for("collections.html"))
     expect(browser.span(id: "a_span").spans.size).to eq 2
   end
+
+  it "returns correct subtype of elements" do
+    browser.goto(WatirSpec.url_for("collections.html"))
+    collection = browser.span(id: "a_span").spans.to_a
+    expect(collection.all? { |el| el.is_a? Watir::Span}).to eq true
+  end
+
+  it "can contain more than one type of element" do
+    browser.goto(WatirSpec.url_for("nested_elements.html"))
+    collection = browser.div(id: "parent").children
+    expect(collection.any? { |el| el.is_a? Watir::Span}).to eq true
+    expect(collection.any? { |el| el.is_a? Watir::Div}).to eq true
+  end
 end

data/spec/watirspec/elements/element_spec.rb

@@ -182,23 +182,13 @@ describe "Element" do
     end
   end
 
-  describe "#parent" do
-    it "gets the parent of this element" do
-      expect(browser.text_field(id: "new_user_email").parent).to be_instance_of(Watir::FieldSet)
-    end
-
-    it "returns nil if the element has no parent" do
-      expect(browser.body.parent.parent).to be_nil
-    end
-  end
-
   describe "#visible?" do
     it "returns true if the element is visible" do
       expect(browser.text_field(id: "new_user_email")).to be_visible
     end
 
     it "raises UnknownObjectException exception if the element does not exist" do
-      expect {browser.text_field(id: "no_such_id").visible?}.to raise_unknown_object_exception
+      expect { browser.text_field(id: "no_such_id").visible? }.to raise_unknown_object_exception
     end
 
     it "raises UnknownObjectException exception if the element is stale" do

data/spec/watirspec/elements/elements_spec.rb

@@ -12,4 +12,25 @@ describe "Elements" do
       end
     end
   end
+
+  describe "#eq and #eql?" do
+    before { browser.goto WatirSpec.url_for("forms_with_input_elements.html") }
+
+    it "returns true if the two collections have the same Watir Elements" do
+      a = browser.select_list(name: "new_user_languages").options
+      b = browser.select_list(id: "new_user_languages").options
+
+      expect(a).to eq b
+      expect(a).to eql(b)
+    end
+
+    it "returns false if the two collections are not the same" do
+      a = browser.select_list(name: "new_user_languages").options
+      b = browser.select_list(id: "new_user_role").options
+
+      expect(a).to_not eq b
+      expect(a).to_not eql(b)
+    end
+  end
+
 end

data/spec/watirspec/html/nested_elements.html

@@ -0,0 +1,34 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html lang="en">
+<head>
+    <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
+    <title>Nested Elements</title>
+</head>
+
+<body>
+<span id="grandparent_span">
+        <div id="grandparent">
+            <span id="parent_span">
+                <div id="parent">
+                    <div id="first_sibling">
+                        <span id="child_span">
+                            <div id="oldest_child">
+                                <span id="grandson_span">
+                                    <div id="first_grandson"></div>
+                                    <div id="second_grandson"></div>
+                                </span>
+                            </div>
+                            <div id="middle_child"></div>
+                            <div id="youngest_child"></div>
+                        </span>
+                    </div>
+                    <span id="between_siblings1"></span>
+                    <div id="second_sibling"></div>
+                    <span id="between_siblings2"></span>
+                    <div id="third_sibling"></div>
+                </div>
+            </span>
+        </div>
+    </span>
+</body>
+</html>

data/spec/watirspec/html/nested_iframes.html

@@ -6,4 +6,8 @@
   <h3>Top Layer</h3>
   <iframe id="one" src="nested_frame_1.html"></iframe>
   <iframe id="two" src="nested_iframe_2.html"></iframe>
+
+  <div id="div1">
+    <div id="div2"></div>
+  </div>
 </html>

data/spec/watirspec/html/wait.html

@@ -40,6 +40,10 @@
           document.getElementById(id).disabled = disabled;
         }, timeout);
       }
+
+      function changeName(id) {
+          document.getElementById(id).name = 'different';
+      }
     </script>
   </head>
 
@@ -59,7 +63,8 @@
       </a>
     </div>
     <div>
-      <a id="add_select" href="#" onclick="setTimeoutDisplay('languages', 'block', 500);">show select list</a>
+      <a id="change_select" href="#" onclick="changeName('add_select');">change select list</a>
+      <a id="add_select" name="add_select" href="#" onclick="setTimeoutDisplay('languages', 'block', 500);">show select list</a>
     </div>
     <form>
       <fieldset>

data/spec/watirspec/relaxed_locate_spec.rb

@@ -54,10 +54,10 @@ describe 'Watir#relaxed_locate?' do
         it 'fails first for parent not existing' do
           begin
             Watir.default_timeout = 0
-            selector = "{:id=>\"no_parent\", :tag_name=>\"div\"}"
+            inspected = '#<Watir::Div: located: false; {:id=>"no_parent", :tag_name=>"div"}>'
             element = browser.div(id: 'no_parent').div(id: 'no_child')
             error = Watir::Exception::UnknownObjectException
-            message = "timed out after #{Watir.default_timeout} seconds, waiting for #{selector} to be located"
+            message = "timed out after #{Watir.default_timeout} seconds, waiting for #{inspected} to be located"
             expect { element.click }.to raise_exception(error, message)
           ensure
             Watir.default_timeout = 30
@@ -67,10 +67,10 @@ describe 'Watir#relaxed_locate?' do
         it 'fails for child not existing if parent exists' do
           begin
             Watir.default_timeout = 0
-            selector = "{:id=>\"buttons\", :tag_name=>\"div\"} --> {:id=>\"no_child\", :tag_name=>\"div\"}"
+            inspected = '#<Watir::Div: located: false; {:id=>"buttons", :tag_name=>"div"} --> {:id=>"no_child", :tag_name=>"div"}>'
             element = browser.div(id: 'buttons').div(id: 'no_child')
             error = Watir::Exception::UnknownObjectException
-            message = "timed out after #{Watir.default_timeout} seconds, waiting for #{selector} to be located"
+            message = "timed out after #{Watir.default_timeout} seconds, waiting for #{inspected} to be located"
             expect { element.click }.to raise_exception(error, message)
           ensure
             Watir.default_timeout = 30
@@ -80,10 +80,10 @@ describe 'Watir#relaxed_locate?' do
         it 'fails for parent not present if child exists' do
           begin
             Watir.default_timeout = 0.5
-            selector = "{:id=>\"also_hidden\", :tag_name=>\"div\"}"
+            inspected = '#<Watir::Div: located: true; {:id=>"also_hidden", :tag_name=>"div"}>'
             element = browser.div(id: 'also_hidden').div(id: 'hidden_child')
             error = Watir::Exception::UnknownObjectException
-            message = "element located, but timed out after #{Watir.default_timeout} seconds, waiting for true condition on #{selector}"
+            message = "element located, but timed out after #{Watir.default_timeout} seconds, waiting for true condition on #{inspected}"
             allow($stderr).to receive(:write).twice
             expect { element.click }.to raise_exception(error, message)
           ensure
@@ -94,10 +94,10 @@ describe 'Watir#relaxed_locate?' do
         it 'fails for child not present if parent is present' do
           begin
             Watir.default_timeout = 0.5
-            selector = "{:id=>\"buttons\", :tag_name=>\"div\"} --> {:id=>\"btn2\", :tag_name=>\"button\"}"
+            inspected = '#<Watir::Button: located: true; {:id=>"buttons", :tag_name=>"div"} --> {:id=>"btn2", :tag_name=>"button"}>'
             element = browser.div(id: 'buttons').button(id: 'btn2')
             error = Watir::Exception::UnknownObjectException
-            message = "element located, but timed out after #{Watir.default_timeout} seconds, waiting for true condition on #{selector}"
+            message = "element located, but timed out after #{Watir.default_timeout} seconds, waiting for true condition on #{inspected}"
             allow($stderr).to receive(:write).twice
             expect { element.click }.to raise_exception(error, message)
           ensure
@@ -109,10 +109,10 @@ describe 'Watir#relaxed_locate?' do
           browser.goto(WatirSpec.url_for("forms_with_input_elements.html"))
           begin
             Watir.default_timeout = 0.5
-            selector = "{:id=>\"new_user\", :tag_name=>\"form\"} --> {:id=>\"good_luck\", :tag_name=>\"input or textarea\", :type=>\"(any text type)\"}"
+            inspected = '#<Watir::TextField: located: true; {:id=>"new_user", :tag_name=>"form"} --> {:id=>"good_luck", :tag_name=>"input or textarea", :type=>"(any text type)"}>'
             element = browser.form(id: 'new_user').text_field(id: 'good_luck')
             error = Watir::Exception::ObjectDisabledException
-            message = "element present, but timed out after #{Watir.default_timeout} seconds, waiting for #{selector} to be enabled"
+            message = "element present, but timed out after #{Watir.default_timeout} seconds, waiting for #{inspected} to be enabled"
             expect { element.set('foo') }.to raise_exception(error, message)
           ensure
             Watir.default_timeout = 30
@@ -123,10 +123,10 @@ describe 'Watir#relaxed_locate?' do
           browser.goto(WatirSpec.url_for("forms_with_input_elements.html"))
           begin
             Watir.default_timeout = 0.5
-            selector = "{:id=>\"new_user\", :tag_name=>\"form\"} --> {:id=>\"new_user_code\", :tag_name=>\"input or textarea\", :type=>\"(any text type)\"}"
+            inspected = '#<Watir::TextField: located: true; {:id=>"new_user", :tag_name=>"form"} --> {:id=>"new_user_code", :tag_name=>"input or textarea", :type=>"(any text type)"}>'
             element = browser.form(id: 'new_user').text_field(id: 'new_user_code')
             error = Watir::Exception::ObjectReadOnlyException
-            message = "element present and enabled, but timed out after #{Watir.default_timeout} seconds, waiting for #{selector} to not be readonly"
+            message = "element present and enabled, but timed out after #{Watir.default_timeout} seconds, waiting for #{inspected} to not be readonly"
             expect { element.set('foo') }.to raise_exception(error, message)
           ensure
             Watir.default_timeout = 30

data/spec/watirspec/support/raise_exception_matchers.rb

@@ -9,14 +9,15 @@ if defined?(RSpec)
   }.freeze
 
   TIMING_EXCEPTIONS.each do |matcher, exception|
-    RSpec::Matchers.define matcher do |_expected|
+    RSpec::Matchers.define matcher do |message|
       match do |actual|
         original_timeout = Watir.default_timeout
         Watir.default_timeout = 0
         begin
           actual.call
           false
-        rescue exception
+        rescue exception => ex
+          raise exception, "expected '#{message}' to be included in: '#{ex.message}'" unless message.nil? || ex.message.include?(message)
           true
         ensure
           Watir.default_timeout = original_timeout

data/spec/watirspec/wait_spec.rb

@@ -167,8 +167,11 @@ not_compliant_on :safari do
         end
 
         it "times out" do
-          message = /^timed out after 1 seconds, waiting for true condition on (\{:id=>"btn", :tag_name=>"button"\}|\{:tag_name=>"button", :id=>"btn"\})$/
-          expect { browser.button(id: 'btn').wait_until(timeout: 1, &:enabled?).click }.to raise_error(Watir::Wait::TimeoutError, message)
+          error = Watir::Wait::TimeoutError
+          inspected = '#<Watir::Button: located: false; {:id=>"btn", :tag_name=>"button"}>'
+          message = "timed out after 1 seconds, waiting for true condition on #{inspected}"
+          element = browser.button(id: 'btn')
+          expect { element.wait_until(timeout: 1, &:enabled?).click }.to raise_error(error, message)
         end
 
         it "responds to Element methods" do
@@ -196,8 +199,11 @@ not_compliant_on :safari do
       end
 
       it "times out if the element doesn't appear" do
-        message = /^timed out after 1 seconds, waiting for true condition on (\{:id=>"bar", :tag_name=>"div"\}|\{:tag_name=>"div", :id=>"bar"\})$/
-        expect { browser.div(id: 'bar').wait_until_present(timeout: 1) }.to raise_error(Watir::Wait::TimeoutError, message)
+        inspected = '#<Watir::Div: located: false; {:id=>"bar", :tag_name=>"div"}>'
+        error = Watir::Wait::TimeoutError
+        message = "timed out after 1 seconds, waiting for true condition on #{inspected}"
+
+        expect { browser.div(id: 'bar').wait_until_present(timeout: 1) }.to raise_error(error, message)
       end
 
       it "uses provided interval" do
@@ -225,7 +231,7 @@ not_compliant_on :safari do
           expect { select_list.select('No') }.to raise_error Watir::Exception::NoValueFoundException
           expect(::Time.now - start_time).to be > 1
         ensure
-          Watir.default_timeout = 1
+          Watir.default_timeout = 30
         end
       end
     end
@@ -237,8 +243,10 @@ not_compliant_on :safari do
       end
 
       it "times out if the element doesn't disappear" do
-        message = /^timed out after 1 seconds, waiting for false condition on (\{:id=>"foo", :tag_name=>"div"\}|\{:tag_name=>"div", :id=>"foo"\})$/
-        expect { browser.div(id: 'foo').wait_while_present(timeout: 1) }.to raise_error(Watir::Wait::TimeoutError, message)
+        error = Watir::Wait::TimeoutError
+        inspected = '#<Watir::Div: located: false; {:id=>"foo", :tag_name=>"div"}>'
+        message = "timed out after 1 seconds, waiting for false condition on #{inspected}"
+        expect { browser.div(id: 'foo').wait_while_present(timeout: 1) }.to raise_error(error, message)
       end
 
       it "uses provided interval" do
@@ -267,6 +275,17 @@ not_compliant_on :safari do
         expect { element.wait_while_present(timeout: 1) }.to_not raise_exception
       end
 
+      it "waits until the selector no longer matches" do
+        Watir.default_timeout = 1
+        element = browser.link(name: 'add_select').wait_until(&:exists?)
+        begin
+          start_time = ::Time.now
+          browser.link(id: 'change_select').click
+          expect { element.wait_while_present }.not_to raise_error
+        ensure
+          Watir.default_timeout = 30
+        end
+      end
     end
 
     describe "#wait_until" do

data/support/doctest_helper.rb

@@ -74,9 +74,4 @@ YARD::Doctest.configure do |doctest|
   end
 end
 
-if ENV['TRAVIS']
-  ENV['DISPLAY'] = ':99.0'
-
-  Selenium::WebDriver::Chrome.path = File.expand_path 'chrome-linux/chrome'
-  Selenium::WebDriver::Chrome.driver_path = File.expand_path 'chrome-linux/chromedriver'
-end
+ENV['DISPLAY'] = ':99.0' if ENV['TRAVIS']

data/support/travis.sh

@@ -11,20 +11,12 @@ if [[ "$RAKE_TASK" = "yard:doctest" ]]; then
 fi
 
 if [[ "$RAKE_TASK" = "spec:chrome" ]] || [[ "$RAKE_TASK" = "yard:doctest" ]]; then
-  # https://omahaproxy.appspot.com
-  # https://commondatastorage.googleapis.com/chromium-browser-snapshots/index.html?prefix=Linux_x64/
-  # CHROME_REVISION=`curl -s http://commondatastorage.googleapis.com/chromium-browser-snapshots/Linux_x64/LAST_CHANGE`
-  CHROME_REVISION=417841
-
-  curl -L -O "http://commondatastorage.googleapis.com/chromium-browser-snapshots/Linux_x64/${CHROME_REVISION}/chrome-linux.zip"
-  unzip chrome-linux.zip
-
   CHROMEDRIVER_VERSION=$(curl -s http://chromedriver.storage.googleapis.com/LATEST_RELEASE)
   curl -L -O "http://chromedriver.storage.googleapis.com/${CHROMEDRIVER_VERSION}/chromedriver_linux64.zip"
   unzip chromedriver_linux64.zip
 
-  mv chromedriver chrome-linux/chromedriver
-  chmod +x chrome-linux/chromedriver
+  mv chromedriver travis-drivers/chromedriver
+  chmod +x travis-drivers/chromedriver
 fi
 
 if [[ "$RAKE_TASK" = "spec:firefox" ]]; then

data/watir.gemspec

@@ -2,7 +2,7 @@
 
 Gem::Specification.new do |s|
   s.name        = 'watir'
-  s.version     = '6.1.0'
+  s.version     = '6.2.0'
   s.platform    = Gem::Platform::RUBY
   s.authors     = ['Alex Rodionov', 'Titus Fortner']
   s.email       = ['p0deje@gmail.com', 'titusfortner@gmail.com']

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: watir
 version: !ruby/object:Gem::Version
-  version: 6.1.0
+  version: 6.2.0
 platform: ruby
 authors:
 - Alex Rodionov
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-01-04 00:00:00.000000000 Z
+date: 2017-02-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: selenium-webdriver
@@ -186,6 +186,7 @@ files:
 - appveyor.yml
 - lib/watir-webdriver.rb
 - lib/watir.rb
+- lib/watir/adjacent.rb
 - lib/watir/after_hooks.rb
 - lib/watir/alert.rb
 - lib/watir/aliases.rb
@@ -194,7 +195,6 @@ files:
 - lib/watir/atoms/fireEvent.js
 - lib/watir/atoms/getInnerHtml.js
 - lib/watir/atoms/getOuterHtml.js
-- lib/watir/atoms/getParentElement.js
 - lib/watir/atoms/selectText.js
 - lib/watir/attribute_helper.rb
 - lib/watir/browser.rb
@@ -291,6 +291,7 @@ files:
 - spec/locator_spec_helper.rb
 - spec/spec_helper.rb
 - spec/special_chars_spec.rb
+- spec/watirspec/adjacent_spec.rb
 - spec/watirspec/after_hooks_spec.rb
 - spec/watirspec/alert_spec.rb
 - spec/watirspec/browser_spec.rb
@@ -417,6 +418,7 @@ files:
 - spec/watirspec/html/keylogger.html
 - spec/watirspec/html/modal_dialog.html
 - spec/watirspec/html/multiple_ids.html
+- spec/watirspec/html/nested_elements.html
 - spec/watirspec/html/nested_frame_1.html
 - spec/watirspec/html/nested_frame_2.html
 - spec/watirspec/html/nested_frame_3.html
@@ -480,6 +482,7 @@ test_files:
 - spec/locator_spec_helper.rb
 - spec/spec_helper.rb
 - spec/special_chars_spec.rb
+- spec/watirspec/adjacent_spec.rb
 - spec/watirspec/after_hooks_spec.rb
 - spec/watirspec/alert_spec.rb
 - spec/watirspec/browser_spec.rb
@@ -606,6 +609,7 @@ test_files:
 - spec/watirspec/html/keylogger.html
 - spec/watirspec/html/modal_dialog.html
 - spec/watirspec/html/multiple_ids.html
+- spec/watirspec/html/nested_elements.html
 - spec/watirspec/html/nested_frame_1.html
 - spec/watirspec/html/nested_frame_2.html
 - spec/watirspec/html/nested_frame_3.html

data/lib/watir/atoms/getParentElement.js

@@ -1,17 +0,0 @@
-// Copyright 2011 Software Freedom Conservatory
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
-//
-//     http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
-
-function(){return function(){var d=this;function e(a,b){function c(){}c.prototype=b.prototype;a.g=b.prototype;a.prototype=new c};function g(a){for(var b=1;b<arguments.length;b++)var c=String(arguments[b]).replace(/\$/g,"$$$$"),a=a.replace(/\%s/,c);return a}function h(a,b){if(a<b)return-1;else if(a>b)return 1;return 0};var i,l,m,n;function o(){return d.navigator?d.navigator.userAgent:null}n=m=l=i=!1;var p;if(p=o()){var q=d.navigator;i=p.indexOf("Opera")==0;l=!i&&p.indexOf("MSIE")!=-1;m=!i&&p.indexOf("WebKit")!=-1;n=!i&&!m&&q.product=="Gecko"}var r=l,s=n,v=m,w;
-a:{var x="",y;if(i&&d.opera)var z=d.opera.version,x=typeof z=="function"?z():z;else if(s?y=/rv\:([^\);]+)(\)|;)/:r?y=/MSIE\s+([^\);]+)(\)|;)/:v&&(y=/WebKit\/(\S+)/),y)var A=y.exec(o()),x=A?A[1]:"";if(r){var B,C=d.document;B=C?C.documentMode:void 0;if(B>parseFloat(x)){w=String(B);break a}}w=x}var D={};
-function E(a){var b;if(!(b=D[a])){b=0;for(var c=String(w).replace(/^[\s\xa0]+|[\s\xa0]+$/g,"").split("."),f=String(a).replace(/^[\s\xa0]+|[\s\xa0]+$/g,"").split("."),t=Math.max(c.length,f.length),u=0;b==0&&u<t;u++){var L=c[u]||"",M=f[u]||"",N=RegExp("(\\d*)(\\D*)","g"),O=RegExp("(\\d*)(\\D*)","g");do{var j=N.exec(L)||["","",""],k=O.exec(M)||["","",""];if(j[0].length==0&&k[0].length==0)break;b=h(j[1].length==0?0:parseInt(j[1],10),k[1].length==0?0:parseInt(k[1],10))||h(j[2].length==0,k[2].length==0)||
-h(j[2],k[2])}while(b==0)}b=D[a]=b>=0}return b};function F(a){this.stack=Error().stack||"";if(a)this.message=String(a)}e(F,Error);e(function(a,b){b.unshift(a);F.call(this,g.apply(null,b));b.shift();this.f=a},F);!r||E("9");!s&&!r||r&&E("9")||s&&E("1.9.1");r&&E("9");function G(a,b,c,f,t){this.b=!!b;if(a&&(this.a=a))this.c=typeof f=="number"?f:this.a.nodeType!=1?0:this.b?-1:1;this.d=t!=void 0?t:this.c||0;this.b&&(this.d*=-1);this.e=!c}e(G,function(){});G.prototype.a=null;G.prototype.c=0;e(function(a,b,c,f){G.call(this,a,b,c,null,f)},G);function H(a){for(a=a.parentNode;a&&a.nodeType!=1&&a.nodeType!=9&&a.nodeType!=11;)a=a.parentNode;return a&&a.nodeType==1?a:null}var I="_".split("."),J=d;!(I[0]in J)&&J.execScript&&J.execScript("var "+I[0]);for(var K;I.length&&(K=I.shift());)!I.length&&H!==void 0?J[K]=H:J=J[K]?J[K]:J[K]={};; return this._.apply(null,arguments);}.apply({navigator:typeof window!='undefined'?window.navigator:null}, arguments);}