button_spec.rb

# encoding: utf-8
require File.expand_path("../spec_helper", __FILE__)

describe "Button" do

  before :each 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
      not_compliant_on :internet_explorer do
        expect(browser.button(src: "images/button.png")).to exist
      end
      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
    end

    it "returns true if the button exists (how = :caption)" do
      expect(browser.button(caption: "Button 2")).to exist
      expect(browser.button(caption: /Button 2/)).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")).to_not exist
      expect(browser.button(id: /no_such_id/)).to_not exist
      expect(browser.button(name: "no_such_name")).to_not exist
      expect(browser.button(name: /no_such_name/)).to_not exist
      expect(browser.button(value: "no_such_value")).to_not exist
      expect(browser.button(value: /no_such_value/)).to_not exist
      expect(browser.button(src: "no_such_src")).to_not exist
      expect(browser.button(src: /no_such_src/)).to_not exist
      expect(browser.button(text: "no_such_text")).to_not exist
      expect(browser.button(text: /no_such_text/)).to_not exist
      expect(browser.button(class: "no_such_class")).to_not exist
      expect(browser.button(class: /no_such_class/)).to_not exist
      expect(browser.button(index: 1337)).to_not exist
      expect(browser.button(xpath: "//input[@id='no_such_id']")).to_not exist
    end

    it "checks the tag name and type attribute when locating by xpath" do
      expect(browser.button(xpath: "//input[@type='text']")).to_not exist
      expect(browser.button(xpath: "//input[@type='button']")).to exist
    end


    it "raises TypeError when 'what' argument is invalid" do
      expect { browser.button(id: 3.14).exists? }.to raise_error(TypeError)
    end

    it "raises MissingWayOfFindingObjectException when 'how' argument is invalid" do
      expect { browser.button(no_such_how: 'some_value').exists? }.to raise_error(Watir::Exception::MissingWayOfFindingObjectException)
    end
  end

  # Attribute methods
  describe "#class_name" do
    it "returns the class name of the button" do
      expect(browser.button(name: "new_user_image").class_name).to eq "image"
    end

    it "returns an empty string if the button has no class name" do
      expect(browser.button(name: "new_user_submit").class_name).to eq ""
    end
  end

  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_error(Watir::Exception::UnknownObjectException)
    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_error(Watir::Exception::UnknownObjectException)
    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_error(Watir::Exception::UnknownObjectException)
    end
  end

  describe "#style" do
    not_compliant_on :internet_explorer, :safari do
      it "returns the style attribute if the button exists" do
        expect(browser.button(id: 'delete_user_submit').style).to eq "border: 4px solid red;"
      end
    end

    deviates_on :safari do
      it "returns the style attribute if the button exists" do
        expect(browser.button(id: 'delete_user_submit').style).to eq "border: 4px solid red;"
      end
    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_error(Watir::Exception::UnknownObjectException)
    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_error(Watir::Exception::UnknownObjectException)
    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_error(Watir::Exception::UnknownObjectException)
    end
  end

  describe "#text" do
    it "returns the text of the 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 "raises UnknownObjectException if the element does not exist" do
      expect { browser.button(id: "no_such_id").text }.to raise_error(Watir::Exception::UnknownObjectException)
    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')).to_not be_enabled
    end

    it "raises UnknownObjectException if the button doesn't exist" do
      expect { browser.button(name: "no_such_name").enabled? }.to raise_error(Watir::Exception::UnknownObjectException)
    end
  end

  describe "#disabled?" do
    it "returns false when button is enabled" do
      expect(browser.button(name: 'new_user_submit')).to_not 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_error(Watir::Exception::UnknownObjectException)
    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
      Watir::Wait.until { !browser.url.include? '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_error(Watir::Exception::UnknownObjectException)
      expect { browser.button(id: "no_such_id").click }.to raise_error(Watir::Exception::UnknownObjectException)
    end

    it "raises ObjectDisabledException when clicking a disabled button" do
      expect { browser.button(value: "Disabled").click }.to raise_error(Watir::Exception::ObjectDisabledException)
    end
  end


end