watir 6.0.0.beta5 → 6.0.0

data/spec/watirspec/alert_spec.rb

@@ -0,0 +1,101 @@
+require "watirspec_helper"
+
+describe 'Alert API' do
+  bug "https://github.com/detro/ghostdriver/issues/20", :phantomjs do
+    not_compliant_on :safari do
+      before do
+        browser.goto WatirSpec.url_for("alerts.html")
+      end
+
+      after do
+        browser.alert.ok if browser.alert.exists?
+      end
+
+      context 'alert' do
+        describe '#text' do
+          it 'returns text of alert' do
+            browser.button(id: 'alert').click
+            expect(browser.alert.text).to include('ok')
+          end
+        end
+
+        describe '#exists?' do
+          it 'returns false if alert is not present' do
+            expect(browser.alert).to_not exist
+          end
+
+          it 'returns true if alert is present' do
+            browser.button(id: 'alert').click
+            browser.wait_until(timeout: 10) { browser.alert.exists? }
+          end
+        end
+
+        describe '#ok' do
+          it 'closes alert' do
+            browser.button(id: 'alert').click
+            browser.alert.ok
+            expect(browser.alert).to_not exist
+          end
+        end
+
+        bug "https://code.google.com/p/chromedriver/issues/detail?id=26", [:chrome, :macosx] do
+          describe '#close' do
+            it 'closes alert' do
+              browser.button(id: 'alert').click
+              browser.alert.close
+              expect(browser.alert).to_not exist
+            end
+          end
+        end
+
+        not_compliant_on :relaxed_locate do
+          describe 'wait_until_present' do
+            it 'waits until alert is present and goes on' do
+              browser.button(id: 'timeout-alert').click
+              browser.alert.wait_until_present.ok
+
+              expect(browser.alert).to_not exist
+            end
+
+            it 'raises error if alert is not present after timeout' do
+              expect {
+                browser.alert.wait_until_present.ok
+              }.to raise_error(Watir::Wait::TimeoutError)
+            end
+          end
+        end
+      end
+
+      context 'confirm' do
+        describe '#ok' do
+          it 'accepts confirm' do
+            browser.button(id: 'confirm').click
+            browser.alert.ok
+            expect(browser.button(id: 'confirm').value).to eq "true"
+          end
+        end
+
+        describe '#close' do
+          it 'cancels confirm' do
+            browser.button(id: 'confirm').click
+            browser.alert.close
+            expect(browser.button(id: 'confirm').value).to eq "false"
+          end
+        end
+      end
+
+      context 'prompt' do
+        describe '#set' do
+          bug "https://bugzilla.mozilla.org/show_bug.cgi?id=1255906", :firefox do
+            it 'enters text to prompt' do
+              browser.button(id: 'prompt').click
+              browser.alert.set 'My Name'
+              browser.alert.ok
+              expect(browser.button(id: 'prompt').value).to eq 'My Name'
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/spec/watirspec/browser_spec.rb

@@ -0,0 +1,291 @@
+require "watirspec_helper"
+
+describe "Browser" do
+
+  describe "#exists?" do
+    after do
+      browser.window(index: 0).use
+      browser.windows[1..-1].each(&:close)
+    end
+
+    it "returns true if we are at a page" do
+      browser.goto(WatirSpec.url_for("non_control_elements.html"))
+      expect(browser).to exist
+    end
+
+    bug "https://bugzilla.mozilla.org/show_bug.cgi?id=1223277", :firefox do
+      it "returns false if window is closed" do
+        browser.goto WatirSpec.url_for("window_switching.html")
+        browser.a(id: "open").click
+        Watir::Wait.until { browser.windows.size == 2 }
+        browser.window(title: "closeable window").use
+        browser.a(id: "close").click
+        Watir::Wait.until { browser.windows.size == 1 }
+        expect(browser.exists?).to be false
+      end
+    end
+
+    bug "https://bugzilla.mozilla.org/show_bug.cgi?id=1290814", :firefox do
+      it "returns false after Browser#close" do
+        b = WatirSpec.new_browser
+        b.close
+        expect(b).to_not exist
+      end
+    end
+  end
+
+  # this should be rewritten - the actual string returned varies a lot between implementations
+  describe "#html" do
+    it "returns the DOM of the page as an HTML string" do
+      browser.goto(WatirSpec.url_for("right_click.html"))
+      html = browser.html.downcase # varies between browsers
+
+      expect(html).to match(/^<html/)
+      expect(html).to include('<meta ')
+      expect(html).to include(' content="text/html; charset=utf-8"')
+
+      not_compliant_on :internet_explorer do
+        expect(html).to include(' http-equiv="content-type"')
+      end
+
+      deviates_on :internet_explorer do
+        expect(html).to include(' http-equiv=content-type')
+      end
+    end
+  end
+
+  describe "#title" do
+    it "returns the current page title" do
+      browser.goto(WatirSpec.url_for("non_control_elements.html"))
+      expect(browser.title).to eq "Non-control elements"
+    end
+  end
+
+  describe "#status" do
+    # for Firefox, this needs to be enabled in
+    # Preferences -> Content -> Advanced -> Change status bar text
+    #
+    # for IE9, this needs to be enabled in
+    # View => Toolbars -> Status bar
+    it "returns the current value of window.status" do
+      browser.goto(WatirSpec.url_for("non_control_elements.html"))
+
+      browser.execute_script "window.status = 'All done!';"
+      expect(browser.status).to eq "All done!"
+    end
+  end
+
+  bug "Capitalization bug fixed in upcoming release", %i(remote firefox) do
+    describe "#name" do
+      it "returns browser name" do
+        expect(browser.name).to eq WatirSpec.implementation.browser_args[1][:desired_capabilities].browser_name.to_sym
+      end
+    end
+  end
+
+  describe "#text" do
+    it "returns the text of the page" do
+      browser.goto(WatirSpec.url_for("non_control_elements.html"))
+      expect(browser.text).to include("Dubito, ergo cogito, ergo sum.")
+    end
+
+    it "returns the text also if the content-type is text/plain" do
+      # more specs for text/plain? what happens if we call other methods?
+      browser.goto(WatirSpec.url_for("plain_text"))
+      expect(browser.text.strip).to eq 'This is text/plain'
+    end
+
+    it "returns text of top most browsing context" do
+      browser.goto(WatirSpec.url_for("nested_iframes.html"))
+      browser.iframe(id: 'two').h3.exists?
+      expect(browser.text).to eq 'Top Layer'
+    end
+  end
+
+  describe "#url" do
+    it "returns the current url" do
+      browser.goto(WatirSpec.url_for("non_control_elements.html"))
+      expect(browser.url.casecmp(WatirSpec.url_for("non_control_elements.html"))).to eq 0
+    end
+
+    it "always returns top url" do
+      browser.goto(WatirSpec.url_for("frames.html"))
+      browser.frame.body.exists? # switches to frame
+      expect(browser.url.casecmp(WatirSpec.url_for("frames.html"))).to eq 0
+    end
+  end
+
+  describe "#title" do
+    it "returns the current title" do
+      browser.goto(WatirSpec.url_for("non_control_elements.html"))
+      expect(browser.title).to eq "Non-control elements"
+    end
+
+    it "always returns top title" do
+      browser.goto(WatirSpec.url_for("frames.html"))
+      browser.element(tag_name: 'title').text
+      browser.frame.body.exists? # switches to frame
+      expect(browser.title).to eq "Frames"
+    end
+  end
+
+  describe ".start" do
+    bug "https://bugzilla.mozilla.org/show_bug.cgi?id=1290814", :firefox do
+      it "goes to the given URL and return an instance of itself" do
+        driver, args = WatirSpec.implementation.browser_args
+        browser = Watir::Browser.start(WatirSpec.url_for("non_control_elements.html"), driver, args)
+
+        expect(browser).to be_instance_of(Watir::Browser)
+        expect(browser.title).to eq "Non-control elements"
+        browser.close
+      end
+    end
+  end
+
+  describe "#goto" do
+    not_compliant_on :internet_explorer do
+      it "adds http:// to URLs with no URL scheme specified" do
+        url = WatirSpec.host[%r{http://(.*)}, 1]
+        expect(url).to_not be_nil
+        browser.goto(url)
+        expect(browser.url).to match(%r[http://#{url}/?])
+      end
+    end
+
+    it "goes to the given url without raising errors" do
+      expect { browser.goto(WatirSpec.url_for("non_control_elements.html")) }.to_not raise_error
+    end
+
+    it "goes to the url 'about:blank' without raising errors" do
+      expect { browser.goto("about:blank") }.to_not raise_error
+    end
+
+    not_compliant_on :internet_explorer, :safari do
+      it "goes to a data URL scheme address without raising errors" do
+        expect { browser.goto("data:text/html;content-type=utf-8,foobar") }.to_not raise_error
+      end
+    end
+
+    compliant_on :ff_legacy do
+      it "goes to internal Firefox URL 'about:mozilla' without raising errors" do
+        expect { browser.goto("about:mozilla") }.to_not raise_error
+      end
+    end
+
+    compliant_on :opera do
+      it "goes to internal Opera URL 'opera:config' without raising errors" do
+        expect { browser.goto("opera:config") }.to_not raise_error
+      end
+    end
+
+    compliant_on :chrome do
+      it "goes to internal Chrome URL 'chrome://settings/browser' without raising errors" do
+        expect { browser.goto("chrome://settings/browser") }.to_not raise_error
+      end
+    end
+
+    it "updates the page when location is changed with setTimeout + window.location" do
+      browser.goto(WatirSpec.url_for("timeout_window_location.html"))
+      Watir::Wait.while { browser.url.include? 'timeout_window_location.html' }
+      expect(browser.url).to include("non_control_elements.html")
+    end
+  end
+
+  describe "#refresh" do
+    it "refreshes the page" do
+      browser.goto(WatirSpec.url_for("non_control_elements.html"))
+      browser.span(class: 'footer').click
+      expect(browser.span(class: 'footer').text).to include('Javascript')
+      browser.refresh
+      browser.span(class: 'footer').wait_until_present
+      expect(browser.span(class: 'footer').text).to_not include('Javascript')
+    end
+  end
+
+  describe "#execute_script" do
+    before { browser.goto(WatirSpec.url_for("non_control_elements.html")) }
+
+    it "executes the given JavaScript on the current page" do
+      expect(browser.pre(id: 'rspec').text).to_not eq "javascript text"
+      browser.execute_script("document.getElementById('rspec').innerHTML = 'javascript text'")
+      expect(browser.pre(id: 'rspec').text).to eq "javascript text"
+    end
+
+    it "executes the given JavaScript in the context of an anonymous function" do
+      expect(browser.execute_script("1 + 1")).to be_nil
+      expect(browser.execute_script("return 1 + 1")).to eq 2
+    end
+
+    it "returns correct Ruby objects" do
+      expect(browser.execute_script("return {a: 1, \"b\": 2}")).to eq Hash["a" => 1, "b" => 2]
+      expect(browser.execute_script("return [1, 2, \"3\"]")).to match_array([1, 2, "3"])
+      expect(browser.execute_script("return 1.2 + 1.3")).to eq 2.5
+      expect(browser.execute_script("return 2 + 2")).to eq 4
+      expect(browser.execute_script("return \"hello\"")).to eq "hello"
+      expect(browser.execute_script("return")).to be_nil
+      expect(browser.execute_script("return null")).to be_nil
+      expect(browser.execute_script("return undefined")).to be_nil
+      expect(browser.execute_script("return true")).to be true
+      expect(browser.execute_script("return false")).to be false
+    end
+
+    it "works correctly with multi-line strings and special characters" do
+      expect(browser.execute_script("//multiline rocks!
+                            var a = 22; // comment on same line
+                            /* more
+                            comments */
+                            var b = '33';
+                            var c = \"44\";
+                            return a + b + c")).to eq "223344"
+    end
+  end
+
+  not_compliant_on :safari do
+    describe "#back and #forward" do
+      it "goes to the previous page" do
+        browser.goto WatirSpec.url_for("non_control_elements.html")
+        orig_url = browser.url
+        browser.goto WatirSpec.url_for("tables.html")
+        new_url = browser.url
+        expect(orig_url).to_not eq new_url
+        browser.back
+        expect(orig_url).to eq browser.url
+      end
+
+      it "goes to the next page" do
+        urls = []
+        browser.goto WatirSpec.url_for("non_control_elements.html")
+        urls << browser.url
+        browser.goto WatirSpec.url_for("tables.html")
+        urls << browser.url
+
+        browser.back
+        expect(browser.url).to eq urls.first
+        browser.forward
+        expect(browser.url).to eq urls.last
+      end
+
+      it "navigates between several history items" do
+        urls = ["non_control_elements.html",
+                "tables.html",
+                "forms_with_input_elements.html",
+                "definition_lists.html"
+        ].map do |page|
+          browser.goto WatirSpec.url_for(page)
+          browser.url
+        end
+
+        3.times { browser.back }
+        expect(browser.url).to eq urls.first
+        2.times { browser.forward }
+        expect(browser.url).to eq urls[2]
+      end
+    end
+  end
+
+  it "raises UnknownObjectException when trying to access DOM elements on plain/text-page" do
+    browser.goto(WatirSpec.url_for("plain_text"))
+    expect { browser.div(id: 'foo').id }.to raise_unknown_object_exception
+  end
+
+end

data/spec/watirspec/cookies_spec.rb

@@ -0,0 +1,147 @@
+require "watirspec_helper"
+
+bug "https://github.com/ariya/phantomjs/issues/13115", :phantomjs do
+  describe "Browser#cookies" do
+    after { browser.cookies.clear }
+
+    it 'gets an empty list of cookies' do
+      browser.goto WatirSpec.url_for 'collections.html' # no cookie set.
+      expect(browser.cookies.to_a).to eq []
+    end
+
+    it "gets any cookies set" do
+      browser.goto set_cookie_url
+
+      verify_cookies_count 1
+
+      cookie = browser.cookies.to_a.first
+      expect(cookie[:name]).to eq 'monster'
+      expect(cookie[:value]).to eq '1'
+    end
+
+    describe '#[]' do
+      before do
+        browser.goto set_cookie_url
+        verify_cookies_count 1
+      end
+
+      it 'returns cookie by symbol name' do
+        cookie = browser.cookies[:monster]
+        expect(cookie[:name]).to eq('monster')
+        expect(cookie[:value]).to eq('1')
+      end
+
+      it 'returns cookie by string name' do
+        cookie = browser.cookies['monster']
+        expect(cookie[:name]).to eq('monster')
+        expect(cookie[:value]).to eq('1')
+      end
+
+      it 'returns nil if there is no cookie with such name' do
+        expect(browser.cookies[:non_monster]).to eq(nil)
+      end
+    end
+
+    not_compliant_on :internet_explorer do
+      it 'adds a cookie' do
+        browser.goto set_cookie_url
+        verify_cookies_count 1
+
+        browser.cookies.add 'foo', 'bar'
+        verify_cookies_count 2
+
+        compliant_on :safari do
+          $browser.close
+          $browser = WatirSpec.new_browser
+        end
+      end
+    end
+
+    # TODO - Split this up into multiple tests or figure out which parts are not compliant
+    not_compliant_on :chrome, :internet_explorer, :safari, :firefox do
+      it 'adds a cookie with options' do
+        browser.goto set_cookie_url
+
+        expires = Time.now + 10000
+        options = {path: "/set_cookie",
+                   secure: true,
+                   expires: expires}
+
+        browser.cookies.add 'a', 'b', options
+        cookie = browser.cookies.to_a.find { |e| e[:name] == 'a' }
+        expect(cookie).to_not be_nil
+
+        expect(cookie[:name]).to eq 'a'
+        expect(cookie[:value]).to eq 'b'
+
+        expect(cookie[:path]).to eq "/set_cookie"
+        expect(cookie[:secure]).to be true
+
+        expect(cookie[:expires]).to be_kind_of(Time)
+        # a few ms slack
+        expect((cookie[:expires]).to_i).to be_within(2).of(expires.to_i)
+      end
+    end
+
+    not_compliant_on :internet_explorer do
+      it 'removes a cookie' do
+        browser.goto set_cookie_url
+        verify_cookies_count 1
+
+        browser.cookies.delete 'monster'
+        verify_cookies_count 0
+      end
+
+      bug "https://code.google.com/p/selenium/issues/detail?id=5487", :safari do
+        it 'clears all cookies' do
+          browser.goto set_cookie_url
+          browser.cookies.add 'foo', 'bar'
+          verify_cookies_count 2
+
+          browser.cookies.clear
+          verify_cookies_count 0
+        end
+      end
+    end
+
+    not_compliant_on :internet_explorer do
+      let(:file) { "#{Dir.tmpdir}/cookies" }
+
+      before do
+        browser.goto set_cookie_url
+        browser.cookies.save file
+      end
+
+      describe '#save' do
+        it 'saves cookies to file' do
+          expect(IO.read(file)).to eq(browser.cookies.to_a.to_yaml)
+        end
+      end
+
+      describe '#load' do
+        it 'loads cookies from file' do
+          browser.cookies.clear
+          browser.cookies.load file
+          expected = browser.cookies.to_a
+          actual = YAML.load(IO.read(file))
+
+          # https://code.google.com/p/selenium/issues/detail?id=6834
+          expected.each { |cookie| cookie.delete(:expires) }
+          actual.each { |cookie| cookie.delete(:expires) }
+
+          expect(actual).to eq(expected)
+        end
+      end
+    end
+
+    def set_cookie_url
+      # add timestamp to url to avoid caching in IE8
+      WatirSpec.url_for('set_cookie/index.html') + "?t=#{Time.now.to_i + Time.now.usec}"
+    end
+
+    def verify_cookies_count expected_size
+      cookies = browser.cookies.to_a
+      expect(cookies.size).to eq(expected_size), "expected #{expected_size} cookies, got #{cookies.size}: #{cookies.inspect}"
+    end
+  end
+end