div_spec.rb

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

describe "Div" do

  before :each do
    browser.goto(WatirSpec.url_for("non_control_elements.html"))
  end

  # Exists method
  describe "#exists?" do
    it "returns true if the element exists" do
      expect(browser.div(id: "header")).to exist
      expect(browser.div(id: /header/)).to exist
      expect(browser.div(title: "Header and primary navigation")).to exist
      expect(browser.div(title: /Header and primary navigation/)).to exist
      expect(browser.div(text: "This is a footer.")).to exist
      expect(browser.div(text: /This is a footer\./)).to exist
      expect(browser.div(class: "profile")).to exist
      expect(browser.div(class: /profile/)).to exist
      expect(browser.div(index: 0)).to exist
      expect(browser.div(xpath: "//div[@id='header']")).to exist
    end

    it "returns the first div if given no args" do
      expect(browser.div).to exist
    end

    it "returns false if the element does not exist" do
      expect(browser.div(id: "no_such_id")).to_not exist
      expect(browser.div(id: /no_such_id/)).to_not exist
      expect(browser.div(title: "no_such_title")).to_not exist
      expect(browser.div(title: /no_such_title/)).to_not exist
      expect(browser.div(text: "no_such_text")).to_not exist
      expect(browser.div(text: /no_such_text/)).to_not exist
      expect(browser.div(class: "no_such_class")).to_not exist
      expect(browser.div(class: /no_such_class/)).to_not exist
      expect(browser.div(index: 1337)).to_not exist
      expect(browser.div(xpath: "//div[@id='no_such_id']")).to_not exist
    end

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

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

  end

  # Attribute methods
  describe "#class_name" do
    it "returns the class attribute if the element exists" do
      expect(browser.div(id: "footer").class_name).to eq "profile"
    end

    it "returns an empty string if the element exists but the attribute doesn't" do
      expect(browser.div(id: "content").class_name).to eq ""
    end

    it "raises UnknownObjectException if the element does not exist" do
      expect { browser.div(id: "no_such_id").class_name }.to raise_error(Watir::Exception::UnknownObjectException)
      expect { browser.div(title: "no_such_title").class_name }.to raise_error(Watir::Exception::UnknownObjectException)
      expect { browser.div(index: 1337).class_name }.to raise_error(Watir::Exception::UnknownObjectException)
      expect { browser.div(xpath: "//div[@id='no_such_id']").class_name }.to raise_error(Watir::Exception::UnknownObjectException)
    end
  end

  describe "#id" do
    it "returns the id attribute if the element exists" do
      expect(browser.div(index: 1).id).to eq "outer_container"
    end

    it "returns an empty string if the element exists, but the attribute doesn't" do
      expect(browser.div(index: 0).id).to eq ""
    end

    it "raises UnknownObjectException if the element does not exist" do
      expect { browser.div(id: "no_such_id").id }.to raise_error(Watir::Exception::UnknownObjectException)
      expect { browser.div(title: "no_such_id").id }.to raise_error(Watir::Exception::UnknownObjectException)
      expect { browser.div(index: 1337).id }.to raise_error(Watir::Exception::UnknownObjectException)
    end

    it "should take all conditions into account when locating by id" do
      browser.goto WatirSpec.url_for "multiple_ids.html"
      expect(browser.div(id: "multiple", class: "bar").class_name).to eq "bar"
    end
  end

  describe "#style" do
    not_compliant_on :internet_explorer do
      it "returns the style attribute if the element exists" do
        expect(browser.div(id: 'best_language').style).to eq "color: red; text-decoration: underline; cursor: pointer;"
      end
    end

    it "returns an empty string if the element exists but the attribute doesn't" do
      expect(browser.div(id: 'promo').style).to eq ""
    end

    it "raises UnknownObjectException if the element does not exist" do
      expect {browser.div(id: "no_such_id").style }.to raise_error(Watir::Exception::UnknownObjectException)
    end
  end

  describe "#text" do
    it "returns the text of the div" do
      expect(browser.div(id: "footer").text.strip).to eq "This is a footer."
      expect(browser.div(title: "Closing remarks").text.strip).to eq "This is a footer."
      expect(browser.div(xpath: "//div[@id='footer']").text.strip).to eq "This is a footer."
    end

    it "returns an empty string if the element exists but contains no text" do
      expect(browser.div(index: 0).text.strip).to eq ""
    end

    it "returns an empty string if the div is hidden" do
      expect(browser.div(id: 'hidden').text).to eq ""
    end

    it "raises UnknownObjectException if the element does not exist" do
      expect { browser.div(id: "no_such_id").text }.to raise_error(Watir::Exception::UnknownObjectException)
      expect { browser.div(title: "no_such_title").text }.to raise_error(Watir::Exception::UnknownObjectException)
      expect { browser.div(index: 1337).text }.to raise_error(Watir::Exception::UnknownObjectException)
      expect { browser.div(xpath: "//div[@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.div(index: 0)).to respond_to(:class_name)
      expect(browser.div(index: 0)).to respond_to(:id)
      expect(browser.div(index: 0)).to respond_to(:style)
      expect(browser.div(index: 0)).to respond_to(:text)
    end
  end

  # Manipulation methods
  describe "#click" do
    it "fires events when clicked" do
      expect(browser.div(id: 'best_language').text).to_not eq 'Ruby!'
      browser.div(id: 'best_language').click
      expect(browser.div(id: 'best_language').text).to eq 'Ruby!'
    end

    it "raises UnknownObjectException if the element does not exist" do
      expect { browser.div(id: "no_such_id").click }.to raise_error(Watir::Exception::UnknownObjectException)
      expect { browser.div(title: "no_such_title").click }.to raise_error(Watir::Exception::UnknownObjectException)
      expect { browser.div(index: 1337).click }.to raise_error(Watir::Exception::UnknownObjectException)
      expect { browser.div(xpath: "//div[@id='no_such_id']").click }.to raise_error(Watir::Exception::UnknownObjectException)
    end
  end

  not_compliant_on :safari do
    bug "Actions Endpoint Not Yet Implemented", :firefox do
      describe "#double_click" do
        it "fires the ondblclick event" do
          browser.div(id: 'html_test').double_click
          expect(messages).to include('double clicked')
        end
      end
    end

    bug "Actions Endpoint Not Yet Implemented", :firefox do
      describe "#right_click" do
        it "fires the oncontextmenu event" do
          browser.goto(WatirSpec.url_for("right_click.html"))
          browser.div(id: "click").right_click
          bug "https://github.com/detro/ghostdriver/issues/125", :phantomjs do
            expect(messages.first).to eq 'right-clicked'
          end
        end
      end
    end
  end

  describe "#html" do
    not_compliant_on :internet_explorer do
      it "returns the HTML of the element" do
        html = browser.div(id: 'footer').html.downcase
        expect(html).to include('id="footer"')
        expect(html).to include('title="closing remarks"')
        expect(html).to include('class="profile"')

        expect(html).to_not include('<div id="content">')
        expect(html).to_not include('</body>')
      end
    end

    deviates_on :internet_explorer do
      it "returns the HTML of the element" do
        html = browser.div(id: 'footer').html.downcase
        expect(html).to include('title="closing remarks"')
        expect(html).to_not include('</body>')
      end
    end
  end

end