watir 1.4.1 → 7.3.0

data/spec/watirspec/elements/button_spec.rb

@@ -0,0 +1,265 @@
+# frozen_string_literal: true
+
+require 'watirspec_helper'
+
+module Watir
+  describe Button do
+    before do
+      browser.goto(WatirSpec.url_for('forms_with_input_elements.html'))
+    end
+
+    # Exists method
+    describe '#exists?' do
+      it 'returns true if the button exists (tag = :input)' do
+        expect(browser.button(id: 'new_user_submit')).to exist
+        expect(browser.button(id: /new_user_submit/)).to exist
+        expect(browser.button(name: 'new_user_reset')).to exist
+        expect(browser.button(name: /new_user_reset/)).to exist
+        expect(browser.button(value: 'Button')).to exist
+        expect(browser.button(value: /Button/)).to exist
+        expect(browser.button(src: 'images/button.png')).to exist
+        expect(browser.button(src: /button\.png/)).to exist
+        expect(browser.button(text: 'Button 2')).to exist
+        expect(browser.button(text: /Button 2/)).to exist
+        expect(browser.button(class: 'image')).to exist
+        expect(browser.button(class: /image/)).to exist
+        expect(browser.button(index: 0)).to exist
+        expect(browser.button(xpath: "//input[@id='new_user_submit']")).to exist
+        expect(browser.button(alt: 'Create a new user')).to exist
+        expect(browser.button(alt: /Create a/)).to exist
+      end
+
+      it 'returns true if the button exists (tag = :button)' do
+        expect(browser.button(name: 'new_user_button_2')).to exist
+        expect(browser.button(name: /new_user_button_2/)).to exist
+        expect(browser.button(value: 'button_2')).to exist
+        expect(browser.button(value: /button_2/)).to exist
+        expect(browser.button(text: 'Button 2')).to exist
+        expect(browser.button(text: /Button 2/)).to exist
+        expect(browser.button(value: 'Button 2')).to exist
+        expect(browser.button(value: /Button 2/)).to exist
+        expect(browser.button(value: 'Button 4 With Child Text')).to exist
+        expect(browser.button(value: /Button 4 With Child Text/)).to exist
+      end
+
+      it 'returns the first button if given no args' do
+        expect(browser.button).to exist
+      end
+
+      it 'returns true for element with upper case type' do
+        expect(browser.button(id: 'new_user_button_preview')).to exist
+      end
+
+      it "returns false if the button doesn't exist" do
+        expect(browser.button(id: 'no_such_id')).not_to exist
+        expect(browser.button(id: /no_such_id/)).not_to exist
+        expect(browser.button(name: 'no_such_name')).not_to exist
+        expect(browser.button(name: /no_such_name/)).not_to exist
+        expect(browser.button(value: 'no_such_value')).not_to exist
+        expect(browser.button(value: /no_such_value/)).not_to exist
+        expect(browser.button(src: 'no_such_src')).not_to exist
+        expect(browser.button(src: /no_such_src/)).not_to exist
+        expect(browser.button(text: 'no_such_text')).not_to exist
+        expect(browser.button(text: /no_such_text/)).not_to exist
+        expect(browser.button(class: 'no_such_class')).not_to exist
+        expect(browser.button(class: /no_such_class/)).not_to exist
+        expect(browser.button(index: 1337)).not_to exist
+        expect(browser.button(xpath: "//input[@id='no_such_id']")).not_to exist
+      end
+
+      it 'checks the tag name and type attribute when locating by xpath' do
+        expect(browser.button(xpath: "//input[@type='text']")).not_to exist
+        expect(browser.button(xpath: "//input[@type='button']")).to exist
+      end
+
+      it 'matches the specific type when locating by type' do
+        expect(browser.button(type: 'button').type).to eq 'button'
+        expect(browser.button(type: 'reset').type).to eq 'reset'
+        expect(browser.button(type: 'submit').type).to eq 'submit'
+        expect(browser.button(type: 'image').type).to eq 'image'
+      end
+
+      it 'matches valid input types when type is boolean' do
+        expect(browser.buttons(type: false).map(&:tag_name)).to all eq('button')
+
+        input_buttons = browser.buttons(type: true).select { |e| e.tag_name == 'input' }
+        expect(input_buttons.map(&:type).uniq).to match_array(Button::VALID_TYPES)
+      end
+
+      it "raises TypeError when 'what' argument is invalid" do
+        expect { browser.button(id: 3.14).exists? }.to raise_error(TypeError)
+      end
+    end
+
+    # Attribute methods
+    describe '#id' do
+      it 'returns the id if the button exists' do
+        expect(browser.button(index: 0).id).to eq 'new_user_submit'
+        expect(browser.button(index: 1).id).to eq 'new_user_reset'
+        expect(browser.button(index: 2).id).to eq 'new_user_button'
+      end
+
+      it 'raises UnknownObjectException if button does not exist' do
+        expect { browser.button(index: 1337).id }.to raise_unknown_object_exception
+      end
+    end
+
+    describe '#name' do
+      it 'returns the name if button exists' do
+        expect(browser.button(index: 0).name).to eq 'new_user_submit'
+        expect(browser.button(index: 1).name).to eq 'new_user_reset'
+        expect(browser.button(index: 2).name).to eq 'new_user_button'
+      end
+
+      it 'raises UnknownObjectException if the button does not exist' do
+        expect { browser.button(name: 'no_such_name').name }.to raise_unknown_object_exception
+      end
+    end
+
+    describe '#src' do
+      it 'returns the src attribute for the button image' do
+        # varies between browsers
+        expect(browser.button(name: 'new_user_image').src).to include('images/button.png')
+      end
+
+      it 'raises UnknownObjectException if the button does not exist' do
+        expect { browser.button(name: 'no_such_name').src }.to raise_unknown_object_exception
+      end
+    end
+
+    describe '#style' do
+      it 'returns the style attribute if the button exists' do
+        expect(browser.button(id: 'delete_user_submit').style).to include 'border: 4px solid red;'
+      end
+
+      it "returns an empty string if the element exists and the attribute doesn't exist" do
+        expect(browser.button(id: 'new_user_submit').style).to eq ''
+      end
+
+      it 'raises UnknownObjectException if the button does not exist' do
+        expect { browser.button(name: 'no_such_name').style }.to raise_unknown_object_exception
+      end
+    end
+
+    describe '#title' do
+      it 'returns the title of the button' do
+        expect(browser.button(index: 0).title).to eq 'Submit the form'
+      end
+
+      it 'returns an empty string for button without title' do
+        expect(browser.button(index: 1).title).to eq ''
+      end
+    end
+
+    describe '#type' do
+      it 'returns the type if button exists' do
+        expect(browser.button(index: 0).type).to eq 'submit'
+        expect(browser.button(index: 1).type).to eq 'reset'
+        expect(browser.button(index: 2).type).to eq 'button'
+      end
+
+      it 'raises UnknownObjectException if button does not exist' do
+        expect { browser.button(name: 'no_such_name').type }.to raise_unknown_object_exception
+      end
+    end
+
+    describe '#value' do
+      it 'returns the value if button exists' do
+        expect(browser.button(index: 0).value).to eq 'Submit'
+        expect(browser.button(index: 1).value).to eq 'Reset'
+        expect(browser.button(index: 2).value).to eq 'Button'
+      end
+
+      it 'raises UnknownObjectException if button does not exist' do
+        expect { browser.button(name: 'no_such_name').value }.to raise_unknown_object_exception
+      end
+    end
+
+    describe '#text' do
+      it 'returns the text of an input button' do
+        expect(browser.button(index: 0).text).to eq 'Submit'
+        expect(browser.button(index: 1).text).to eq 'Reset'
+        expect(browser.button(index: 2).text).to eq 'Button'
+        expect(browser.button(index: 3).text).to eq 'Preview'
+      end
+
+      it 'returns the text of a button element' do
+        expect(browser.button(name: 'new_user_button_2').text).to eq 'Button 2'
+      end
+
+      it 'raises UnknownObjectException if the element does not exist' do
+        expect { browser.button(id: 'no_such_id').text }.to raise_unknown_object_exception
+      end
+    end
+
+    describe '#respond_to?' do
+      it 'returns true for all attribute methods' do
+        expect(browser.button(index: 0)).to respond_to(:class_name)
+        expect(browser.button(index: 0)).to respond_to(:id)
+        expect(browser.button(index: 0)).to respond_to(:name)
+        expect(browser.button(index: 0)).to respond_to(:src)
+        expect(browser.button(index: 0)).to respond_to(:style)
+        expect(browser.button(index: 0)).to respond_to(:title)
+        expect(browser.button(index: 0)).to respond_to(:type)
+        expect(browser.button(index: 0)).to respond_to(:value)
+      end
+    end
+
+    # Access methods
+    describe '#enabled?' do
+      it 'returns true if the button is enabled' do
+        expect(browser.button(name: 'new_user_submit')).to be_enabled
+      end
+
+      it 'returns false if the button is disabled' do
+        expect(browser.button(name: 'new_user_submit_disabled')).not_to be_enabled
+      end
+
+      it "raises UnknownObjectException if the button doesn't exist" do
+        expect { browser.button(name: 'no_such_name').enabled? }.to raise_unknown_object_exception
+      end
+
+      it 'raises ObjectDisabledException if disabled button is clicked' do
+        expect { browser.button(name: 'new_user_submit_disabled').click }.to raise_object_disabled_exception
+      end
+    end
+
+    describe '#disabled?' do
+      it 'returns false when button is enabled' do
+        expect(browser.button(name: 'new_user_submit')).not_to be_disabled
+      end
+
+      it 'returns true when button is disabled' do
+        expect(browser.button(name: 'new_user_submit_disabled')).to be_disabled
+      end
+
+      it 'raises UnknownObjectException if button does not exist' do
+        expect { browser.button(name: 'no_such_name').disabled? }.to raise_unknown_object_exception
+      end
+    end
+
+    # Manipulation methods
+    describe '#click' do
+      it 'clicks the button if it exists' do
+        browser.goto(WatirSpec.url_for('forms_with_input_elements.html'))
+        browser.button(id: 'delete_user_submit').click
+        browser.wait_while(url: /forms_with_input_elements\.html$/)
+        expect(browser.text).to include('Semantic table')
+      end
+
+      it 'fires events' do
+        browser.button(id: 'new_user_button').click
+        expect(browser.button(id: 'new_user_button').value).to eq 'new_value_set_by_onclick_event'
+      end
+
+      it "raises UnknownObjectException when clicking a button that doesn't exist" do
+        expect { browser.button(value: 'no_such_value').click }.to raise_unknown_object_exception
+        expect { browser.button(id: 'no_such_id').click }.to raise_unknown_object_exception
+      end
+
+      it 'raises ObjectDisabledException when clicking a disabled button' do
+        expect { browser.button(value: 'Disabled').click }.to raise_object_disabled_exception
+      end
+    end
+  end
+end

data/spec/watirspec/elements/buttons_spec.rb

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+require 'watirspec_helper'
+
+module Watir
+  describe ButtonCollection do
+    before do
+      browser.goto(WatirSpec.url_for('forms_with_input_elements.html'))
+    end
+
+    describe 'with selectors' do
+      it 'returns the matching elements' do
+        expect(browser.buttons(name: 'new_user_button').to_a).to eq [browser.button(name: 'new_user_button')]
+      end
+    end
+
+    describe '#length' do
+      it 'returns the number of buttons' do
+        expect(browser.buttons.length).to eq 11
+      end
+    end
+
+    describe '#[]' do
+      it 'returns the button at the given index' do
+        expect(browser.buttons[0].title).to eq 'Submit the form'
+      end
+    end
+
+    describe '#first' do
+      it 'returns the first element in the collection' do
+        expect(browser.buttons.first.value).to eq browser.buttons[0].value
+      end
+    end
+
+    describe '#last' do
+      it 'returns the last element in the collection' do
+        expect(browser.buttons.last.value).to eq browser.buttons[-1].value
+      end
+    end
+
+    describe '#each' do
+      it 'iterates through buttons correctly' do
+        count = 0
+
+        browser.buttons.each_with_index do |b, index|
+          expect(b.name).to eq browser.button(index: index).name
+          expect(b.id).to eq browser.button(index: index).id
+          expect(b.value).to eq browser.button(index: index).value
+
+          count += 1
+        end
+
+        expect(count).to be > 0
+      end
+    end
+  end
+end

data/spec/watirspec/elements/checkbox_spec.rb

@@ -0,0 +1,290 @@
+# frozen_string_literal: true
+
+require 'watirspec_helper'
+
+describe 'CheckBox' do
+  before do
+    browser.goto(WatirSpec.url_for('forms_with_input_elements.html'))
+  end
+
+  # Exists method
+
+  describe '#exists?' do
+    it 'returns true if the checkbox button exists' do
+      expect(browser.checkbox(id: 'new_user_interests_books')).to exist
+      expect(browser.checkbox(id: /new_user_interests_books/)).to exist
+      expect(browser.checkbox(label: 'Cars')).to exist
+      expect(browser.checkbox(label: /Cars/)).to exist
+      expect(browser.checkbox(name: 'new_user_interests')).to exist
+      expect(browser.checkbox(name: /new_user_interests/)).to exist
+      expect(browser.checkbox(value: 'books')).to exist
+      expect(browser.checkbox(value: /books/)).to exist
+      # not sure what :text is supposed to represent here
+      # browser.checkbox(text: "books").to exist
+      # browser.checkbox(text: /books/).to exist
+      expect(browser.checkbox(class: 'fun')).to exist
+      expect(browser.checkbox(class: /fun/)).to exist
+      expect(browser.checkbox(index: 0)).to exist
+      expect(browser.checkbox(xpath: "//input[@id='new_user_interests_books']")).to exist
+    end
+
+    context 'when some text hidden' do
+      it 'locates matching hidden text' do
+        expect(browser.checkbox(label: /some visible/)).to exist
+        expect(browser.checkbox(label: /some (visible|Jeff)/)).to exist
+        expect(browser.checkbox(label: /none visible/)).to exist
+        expect(browser.checkbox(label: /some visible some hidden/)).to exist
+      end
+
+      it 'does not locate when matches without hidden text' do
+        expect(browser.checkbox(label: /some visible$/)).not_to exist
+      end
+    end
+
+    it 'returns true if the checkbox button exists (search by name and value)' do
+      expect(browser.checkbox(name: 'new_user_interests', value: 'cars')).to exist
+      browser.checkbox(xpath: "//input[@name='new_user_interests' and @value='cars']").set
+    end
+
+    it 'returns the first checkbox if given no args' do
+      expect(browser.checkbox).to exist
+    end
+
+    it 'returns false if the checkbox button does not exist' do
+      expect(browser.checkbox(id: 'no_such_id')).not_to exist
+      expect(browser.checkbox(id: /no_such_id/)).not_to exist
+      expect(browser.checkbox(name: 'no_such_name')).not_to exist
+      expect(browser.checkbox(name: /no_such_name/)).not_to exist
+      expect(browser.checkbox(value: 'no_such_value')).not_to exist
+      expect(browser.checkbox(value: /no_such_value/)).not_to exist
+      expect(browser.checkbox(text: 'no_such_text')).not_to exist
+      expect(browser.checkbox(text: /no_such_text/)).not_to exist
+      expect(browser.checkbox(class: 'no_such_class')).not_to exist
+      expect(browser.checkbox(class: /no_such_class/)).not_to exist
+      expect(browser.checkbox(index: 1337)).not_to exist
+      expect(browser.checkbox(xpath: "//input[@id='no_such_id']")).not_to exist
+    end
+
+    it 'returns false if the checkbox button does not exist (search by name and value)' do
+      expect(browser.checkbox(name: 'new_user_interests', value: 'no_such_value')).not_to exist
+      expect(browser.checkbox(xpath: "//input[@name='new_user_interests' and @value='no_such_value']")).not_to exist
+      expect(browser.checkbox(name: 'no_such_name', value: 'cars')).not_to exist
+      expect(browser.checkbox(xpath: "//input[@name='no_such_name' and @value='cars']")).not_to exist
+    end
+
+    it 'returns true for checkboxes with a string value' do
+      expect(browser.checkbox(name: 'new_user_interests', value: 'books')).to exist
+      expect(browser.checkbox(name: 'new_user_interests', value: 'cars')).to exist
+    end
+
+    it 'returns true for checkbox with upper case type' do
+      expect(browser.checkbox(id: 'new_user_interests_draw')).to exist
+    end
+
+    it "raises TypeError when 'what' argument is invalid" do
+      expect { browser.checkbox(id: 3.14).exists? }.to raise_error(TypeError)
+    end
+  end
+
+  # Attribute methods
+  describe '#id' do
+    it 'returns the id attribute if the checkbox exists and has an attribute' do
+      expect(browser.checkbox(index: 0).id).to eq 'new_user_interests_books'
+    end
+
+    it "returns an empty string if the checkbox exists and the attribute doesn't" do
+      expect(browser.checkbox(index: 1).id).to eq ''
+    end
+
+    it "raises UnknownObjectException if the checkbox doesn't exist" do
+      expect { browser.checkbox(index: 1337).id }.to raise_unknown_object_exception
+    end
+  end
+
+  describe '#name' do
+    it 'returns the name attribute if the checkbox exists' do
+      expect(browser.checkbox(id: 'new_user_interests_books').name).to eq 'new_user_interests'
+    end
+
+    it "returns an empty string if the checkbox exists and the attribute doesn't" do
+      expect(browser.checkbox(id: 'new_user_interests_food').name).to eq ''
+    end
+
+    it "raises UnknownObjectException if the checkbox doesn't exist" do
+      expect { browser.checkbox(index: 1337).name }.to raise_unknown_object_exception
+    end
+  end
+
+  describe '#title' do
+    it 'returns the title attribute if the checkbox exists' do
+      expect(browser.checkbox(id: 'new_user_interests_dancing').title).to eq 'Dancing is fun!'
+    end
+
+    it "returns an empty string if the checkbox exists and the attribute doesn't" do
+      expect(browser.checkbox(id: 'new_user_interests_books').title).to eq ''
+    end
+
+    it "raises UnknownObjectException if the checkbox doesn't exist" do
+      expect { browser.checkbox(index: 1337).title }.to raise_unknown_object_exception
+    end
+  end
+
+  describe '#type' do
+    it 'returns the type attribute if the checkbox exists' do
+      expect(browser.checkbox(index: 0).type).to eq 'checkbox'
+    end
+
+    it "raises UnknownObjectException if the checkbox doesn't exist" do
+      expect { browser.checkbox(index: 1337).type }.to raise_unknown_object_exception
+    end
+  end
+
+  describe '#value' do
+    it 'returns the value attribute if the checkbox exists' do
+      expect(browser.checkbox(id: 'new_user_interests_books').value).to eq 'books'
+    end
+
+    it "raises UnknownObjectException if the checkbox doesn't exist" do
+      expect { browser.checkbox(index: 1337).value }.to raise_unknown_object_exception
+    end
+  end
+
+  describe '#respond_to?' do
+    it 'returns true for all attribute methods' do
+      expect(browser.checkbox(index: 0)).to respond_to(:class_name)
+      expect(browser.checkbox(index: 0)).to respond_to(:id)
+      expect(browser.checkbox(index: 0)).to respond_to(:name)
+      expect(browser.checkbox(index: 0)).to respond_to(:title)
+      expect(browser.checkbox(index: 0)).to respond_to(:type)
+      expect(browser.checkbox(index: 0)).to respond_to(:value)
+    end
+  end
+
+  describe '#tabindex' do
+    it 'finds tab index' do
+      expect(browser.checkbox(tabindex: '4').tabindex).to eq 4
+    end
+
+    it 'finds element with boolean' do
+      expect(browser.checkbox(tabindex: false).id).to eq 'toggle_button_checkbox'
+      expect(browser.checkbox(tabindex: true).id).to eq 'new_user_interests_books'
+    end
+  end
+
+  # Access methods
+
+  describe '#enabled?' do
+    it 'returns true if the checkbox button is enabled' do
+      expect(browser.checkbox(id: 'new_user_interests_books')).to be_enabled
+      expect(browser.checkbox(xpath: "//input[@id='new_user_interests_books']")).to be_enabled
+    end
+
+    it 'returns false if the checkbox button is disabled' do
+      expect(browser.checkbox(id: 'new_user_interests_dentistry')).not_to be_enabled
+      expect(browser.checkbox(xpath: "//input[@id='new_user_interests_dentistry']")).not_to be_enabled
+    end
+
+    it "raises UnknownObjectException if the checkbox button doesn't exist" do
+      expect { browser.checkbox(id: 'no_such_id').enabled? }.to raise_unknown_object_exception
+      expect { browser.checkbox(xpath: "//input[@id='no_such_id']").enabled? }.to raise_unknown_object_exception
+    end
+  end
+
+  describe '#disabled?' do
+    it 'returns true if the checkbox is disabled' do
+      expect(browser.checkbox(id: 'new_user_interests_dentistry')).to be_disabled
+    end
+
+    it 'returns false if the checkbox is enabled' do
+      expect(browser.checkbox(id: 'new_user_interests_books')).not_to be_disabled
+    end
+
+    it "raises UnknownObjectException if the checkbox doesn't exist" do
+      expect { browser.checkbox(index: 1337).disabled? }.to raise_unknown_object_exception
+    end
+  end
+
+  # Manipulation methods
+
+  describe '#clear' do
+    it 'raises ObjectDisabledException if the checkbox is disabled' do
+      expect(browser.checkbox(id: 'new_user_interests_dentistry')).not_to be_set
+      expect { browser.checkbox(id: 'new_user_interests_dentistry').clear }
+        .to raise_object_disabled_exception
+      expect { browser.checkbox(xpath: "//input[@id='new_user_interests_dentistry']").clear }
+        .to raise_object_disabled_exception
+    end
+
+    it 'clears the checkbox button if it is set' do
+      browser.checkbox(id: 'new_user_interests_books').clear
+      expect(browser.checkbox(id: 'new_user_interests_books')).not_to be_set
+    end
+
+    it 'clears the checkbox button when found by :xpath' do
+      browser.checkbox(xpath: "//input[@id='new_user_interests_books']").clear
+      expect(browser.checkbox(xpath: "//input[@id='new_user_interests_books']")).not_to be_set
+    end
+
+    it "raises UnknownObjectException if the checkbox button doesn't exist" do
+      expect { browser.checkbox(name: 'no_such_id').clear }.to raise_unknown_object_exception
+      expect { browser.checkbox(xpath: "//input[@id='no_such_id']").clear }.to raise_unknown_object_exception
+    end
+  end
+
+  describe '#set' do
+    it 'sets the checkbox button' do
+      browser.checkbox(id: 'new_user_interests_cars').set
+      expect(browser.checkbox(id: 'new_user_interests_cars')).to be_set
+    end
+
+    it 'sets the checkbox button when found by :xpath' do
+      browser.checkbox(xpath: "//input[@id='new_user_interests_cars']").set
+      expect(browser.checkbox(xpath: "//input[@id='new_user_interests_cars']")).to be_set
+    end
+
+    it 'fires the onclick event' do
+      expect(browser.button(id: 'disabled_button')).to be_disabled
+      browser.checkbox(id: 'toggle_button_checkbox').set
+      expect(browser.button(id: 'disabled_button')).not_to be_disabled
+      browser.checkbox(id: 'toggle_button_checkbox').clear
+      expect(browser.button(id: 'disabled_button')).to be_disabled
+    end
+
+    it "raises UnknownObjectException if the checkbox button doesn't exist" do
+      expect { browser.checkbox(name: 'no_such_name').set }.to raise_unknown_object_exception
+      expect { browser.checkbox(xpath: "//input[@name='no_such_name']").set }.to raise_unknown_object_exception
+    end
+
+    it 'raises ObjectDisabledException if the checkbox is disabled' do
+      expect { browser.checkbox(id: 'new_user_interests_dentistry').set }
+        .to raise_object_disabled_exception
+      expect { browser.checkbox(xpath: "//input[@id='new_user_interests_dentistry']").set }
+        .to raise_object_disabled_exception
+    end
+  end
+
+  # Other
+
+  describe '#set?' do
+    it 'returns true if the checkbox button is set' do
+      expect(browser.checkbox(id: 'new_user_interests_books')).to be_set
+    end
+
+    it 'returns false if the checkbox button unset' do
+      expect(browser.checkbox(id: 'new_user_interests_cars')).not_to be_set
+    end
+
+    it 'returns the state for checkboxes with string values' do
+      expect(browser.checkbox(name: 'new_user_interests', value: 'cars')).not_to be_set
+      browser.checkbox(name: 'new_user_interests', value: 'cars').set
+      expect(browser.checkbox(name: 'new_user_interests', value: 'cars')).to be_set
+      browser.checkbox(name: 'new_user_interests', value: 'cars').clear
+      expect(browser.checkbox(name: 'new_user_interests', value: 'cars')).not_to be_set
+    end
+
+    it "raises UnknownObjectException if the checkbox button doesn't exist" do
+      expect { browser.checkbox(id: 'no_such_id').set? }.to raise_unknown_object_exception
+      expect { browser.checkbox(xpath: "//input[@id='no_such_id']").set? }.to raise_unknown_object_exception
+    end
+  end
+end

data/spec/watirspec/elements/checkboxes_spec.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+require 'watirspec_helper'
+
+module Watir
+  describe CheckBoxCollection do
+    before do
+      browser.goto(WatirSpec.url_for('forms_with_input_elements.html'))
+    end
+
+    describe 'with selectors' do
+      it 'returns the matching elements' do
+        expect(browser.checkboxes(value: 'books').to_a).to eq [browser.checkbox(value: 'books')]
+      end
+    end
+
+    describe '#length' do
+      it 'returns the number of checkboxes' do
+        expect(browser.checkboxes.length).to eq 11
+      end
+    end
+
+    describe '#[]' do
+      it 'returns the checkbox at the given index' do
+        expect(browser.checkboxes[0].id).to eq 'new_user_interests_books'
+      end
+    end
+
+    describe '#each' do
+      it 'iterates through checkboxes correctly' do
+        count = 0
+
+        browser.checkboxes.each_with_index do |c, index|
+          expect(c).to be_instance_of(CheckBox)
+          expect(c.name).to eq browser.checkbox(index: index).name
+          expect(c.id).to eq browser.checkbox(index: index).id
+          expect(c.value).to eq browser.checkbox(index: index).value
+
+          count += 1
+        end
+
+        expect(count).to be > 0
+      end
+    end
+  end
+end