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(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(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(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(UnknownObjectException)
    end
  end

  describe "#style" do
    not_compliant_on :internet_explorer,
                    [:webdriver, :iphone],
                    [:webdriver, :safari],
                    [:webdriver, :phantomjs] 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 :internet_explorer8 do
      it "returns the style attribute if the button exists" do
        expect(browser.button(:id, 'delete_user_submit').style).to eq "BORDER-BOTTOM: red 4px solid; BORDER-LEFT: red 4px solid; BORDER-TOP: red 4px solid; BORDER-RIGHT: red 4px solid"
      end
    end
    deviates_on :internet_explorer9 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 [:webdriver, :iphone], [:webdriver, :safari], [:webdriver, :phantomjs] do
      it "returns the style attribute if the button exists" do
        style = browser.button(:id, 'delete_user_submit').style
        expect(style).to include("border-top-width: 4px;")
        expect(style).to include("border-left-style: solid;")
        expect(style).to include("border-right-color: 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(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(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(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(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(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(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", :needs_server => true))
      browser.button(:id, 'delete_user_submit').click
      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(UnknownObjectException)
      expect { browser.button(:id, "no_such_id").click }.to raise_error(UnknownObjectException)
    end

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


end