watir-webdriver 0.0.1.dev

data/spec/watirspec/dt_spec.rb

@@ -0,0 +1,136 @@
+# encoding: utf-8
+require File.dirname(__FILE__) + '/spec_helper'
+
+describe "Dt" do
+
+  before :each do
+    browser.goto(WatirSpec.files + "/definition_lists.html")
+  end
+
+  # Exists method
+  describe "#exists?" do
+    it "returns true if the element exists" do
+      browser.dt(:id, "experience").should exist
+      browser.dt(:class, "current-industry").should exist
+      browser.dt(:xpath, "//dt[@id='experience']").should exist
+      browser.dt(:index, 0).should exist
+    end
+
+    it "returns false if the element does not exist" do
+      browser.dt(:id, "no_such_id").should_not exist
+    end
+
+    it "raises TypeError when 'what' argument is invalid" do
+      lambda { browser.dt(:id, 3.14).exists? }.should raise_error(TypeError)
+    end
+
+    it "raises MissingWayOfFindingObjectException when 'how' argument is invalid" do
+      lambda { browser.dt(:no_such_how, 'some_value').exists? }.should raise_error(MissingWayOfFindingObjectException)
+    end
+  end
+
+  # Attribute methods
+  describe "#class_name" do
+    it "returns the class attribute if the element exists" do
+      browser.dt(:id , "experience").class_name.should == "industry"
+    end
+
+    it "returns an empty string if the element exists but the attribute doesn't" do
+      browser.dt(:id , "education").class_name.should == ""
+    end
+
+    it "raises UnknownObjectException if the element does not exist" do
+      lambda { browser.dt(:id, "no_such_id").class_name }.should raise_error(UnknownObjectException)
+      lambda { browser.dt(:title, "no_such_title").class_name }.should raise_error(UnknownObjectException)
+      lambda { browser.dt(:index, 1337).class_name }.should raise_error(UnknownObjectException)
+      lambda { browser.dt(:xpath, "//dt[@id='no_such_id']").class_name }.should raise_error(UnknownObjectException)
+    end
+  end
+
+  describe "#id" do
+    it "returns the id attribute if the element exists" do
+      browser.dt(:class, 'industry').id.should == "experience"
+    end
+
+    it "returns an empty string if the element exists, but the attribute doesn't" do
+      browser.dt(:class, 'current-industry').id.should == ""
+    end
+
+    it "raises UnknownObjectException if the element does not exist" do
+      lambda {browser.dt(:id, "no_such_id").id }.should raise_error(UnknownObjectException)
+      lambda {browser.dt(:title, "no_such_id").id }.should raise_error(UnknownObjectException)
+      lambda {browser.dt(:index, 1337).id }.should raise_error(UnknownObjectException)
+    end
+  end
+
+  describe "#title" do
+    it "returns the title of the element" do
+      browser.dt(:id, "experience").title.should == "experience"
+    end
+  end
+
+  describe "#text" do
+    it "returns the text of the element" do
+      browser.dt(:id, "experience").text.should == "Experience"
+    end
+
+    it "returns an empty string if the element exists but contains no text" do
+      browser.dt(:class, 'noop').text.should == ""
+    end
+
+    it "raises UnknownObjectException if the element does not exist" do
+      lambda { browser.dt(:id, "no_such_id").text }.should raise_error(UnknownObjectException)
+      lambda { browser.dt(:title, "no_such_title").text }.should raise_error(UnknownObjectException)
+      lambda { browser.dt(:index, 1337).text }.should raise_error(UnknownObjectException)
+      lambda { browser.dt(:xpath, "//dt[@id='no_such_id']").text }.should raise_error(UnknownObjectException)
+    end
+  end
+
+  describe "#respond_to?" do
+    it "returns true for all attribute methods" do
+      browser.dt(:index, 0).should respond_to(:id)
+      browser.dt(:index, 0).should respond_to(:class_name)
+      browser.dt(:index, 0).should respond_to(:style)
+      browser.dt(:index, 0).should respond_to(:text)
+      browser.dt(:index, 0).should respond_to(:title)
+    end
+  end
+
+  # Manipulation methods
+  describe "#click" do
+    it "fires events when clicked" do
+      browser.dt(:id, 'education').text.should_not == 'changed'
+      browser.dt(:id, 'education').click
+      browser.dt(:id, 'education').text.should == 'changed'
+    end
+
+    it "raises UnknownObjectException if the element does not exist" do
+      lambda { browser.dt(:id, "no_such_id").click }.should raise_error(UnknownObjectException)
+      lambda { browser.dt(:title, "no_such_title").click }.should raise_error(UnknownObjectException)
+      lambda { browser.dt(:index, 1337).click }.should raise_error(UnknownObjectException)
+      lambda { browser.dt(:xpath, "//dt[@id='no_such_id']").click }.should raise_error(UnknownObjectException)
+    end
+  end
+
+  describe "#html" do
+    it "returns the HTML of the element" do
+      html = browser.dt(:id, 'name').html
+      html.should =~ %r"<div>.*Name.*</div>"m
+      html.should_not include('</body>')
+    end
+  end
+
+  describe "#to_s" do
+    bug "WTR-350", :watir do
+      it "returns a human readable representation of the element" do
+        browser.dt(:id, 'experience').to_s.should ==
+%q{tag:          dt
+  id:           experience
+  class:        industry
+  title:        experience
+  text:         Experience}
+      end
+    end
+  end
+
+end

data/spec/watirspec/dts_spec.rb

@@ -0,0 +1,31 @@
+# encoding: utf-8
+require File.dirname(__FILE__) + '/spec_helper'
+
+describe "Dts" do
+
+  before :each do
+    browser.goto(WatirSpec.files + "/definition_lists.html")
+  end
+
+  describe "#length" do
+    it "returns the number of dts" do
+      browser.dts.length.should == 11
+    end
+  end
+
+  describe "#[]" do
+    it "returns the dt at the given index" do
+      browser.dts[0].id.should == "experience"
+    end
+  end
+
+  describe "#each" do
+    it "iterates through dts correctly" do
+      browser.dts.each_with_index do |d, index|
+        d.id.should == browser.dt(:index, index).id
+        d.class_name.should == browser.dt(:index, index).class_name
+      end
+    end
+  end
+
+end

data/spec/watirspec/element_spec.rb

@@ -0,0 +1,87 @@
+# encoding: utf-8
+require File.dirname(__FILE__) + '/spec_helper'
+
+describe "Element" do
+
+  Element = BaseElement if WatirSpec.implementation = :webdriver # hack
+
+  before :each do
+    browser.goto(WatirSpec.files + "/forms_with_input_elements.html")
+  end
+
+  describe ".new" do
+    it "finds elements matching the conditions when given a hash of :how => 'what' arguments" do
+      browser.checkbox(:name => 'new_user_interests', :title => 'Dancing is fun!').value.should == 'dancing'
+      browser.text_field(:class_name => 'name', :index => 1).id.should == 'new_user_last_name'
+    end
+
+    it "raises UnknownObjectException with a sane error message when given a hash of :how => 'what' arguments (non-existing object)" do
+      conditions = {:index => 100, :name => "foo"}
+      lambda { browser.text_field(conditions).id }.should raise_error(UnknownObjectException)
+    end
+
+    bug "WTR-351", :watir do
+      it "raises ArgumentError if given the wrong number of arguments" do
+        container = mock("container", :null_object => true)
+        lambda { Element.new(container, 1,2,3,4) }.should raise_error(ArgumentError)
+        lambda { Element.new(container, "foo") }.should raise_error(ArgumentError)
+      end
+    end
+  end
+
+  describe "#focus" do
+    it "fires the onfocus event for the given element" do
+      tf = browser.text_field(:id, "new_user_occupation")
+      tf.value.should == "Developer"
+      tf.focus
+      browser.div(:id, "onfocus_test").text.should == "changed by onfocus event"
+    end
+  end
+
+  describe "#fire_event" do
+    it "should fire the given event" do
+      browser.div(:id, "onfocus_test").text.should be_empty
+      browser.text_field(:id, "new_user_occupation").fire_event('onfocus')
+      browser.div(:id, "onfocus_test").text.should == "changed by onfocus event"
+    end
+  end
+
+  describe "#parent" do
+    bug "WTR-352", :watir do
+      it "gets the parent of this element" do
+        browser.text_field(:id, "new_user_email").parent.should be_instance_of(FieldSet)
+      end
+    end
+  end
+
+  describe "#visible?" do
+    it "returns true if the element is visible" do
+      browser.text_field(:id, "new_user_email").should be_visible
+    end
+
+    it "returns false if the element is input element where type == 'hidden'" do
+      browser.text_field(:id, "new_user_interests_dolls").should_not be_visible
+    end
+
+    bug "WTR-336", :watir do
+      it "returns false if the element has style='display: none;'" do
+        browser.div(:id, 'changed_language').should_not be_visible
+      end
+    end
+
+    it "returns false if the element has style='visibility: hidden;" do
+      browser.div(:id, 'wants_newsletter').should_not be_visible
+    end
+
+    it "returns false if one of the parent elements is hidden" do
+      browser.div(:id, 'hidden_parent').should_not be_visible
+    end
+  end
+
+  describe "#exist?" do
+    it "doesn't raise when called on nested elements" do
+      browser.div(:id, 'no_such_div').link(:id, 'no_such_id').should_not exist
+    end
+  end
+
+end

data/spec/watirspec/em_spec.rb

@@ -0,0 +1,110 @@
+# encoding: utf-8
+require File.dirname(__FILE__) + '/spec_helper'
+
+describe "Em" do
+
+  before :each do
+    browser.goto(WatirSpec.files + "/non_control_elements.html")
+  end
+
+  # Exists method
+  describe "#exists?" do
+    it "returns true if the element exists" do
+      browser.em(:id, "important-id").should exist
+      browser.em(:class, "important-class").should exist
+      browser.em(:xpath, "//em[@id='important-id']").should exist
+      browser.em(:index, 0).should exist
+    end
+
+    it "returns false if the element does not exist" do
+      browser.em(:id, "no_such_id").should_not exist
+    end
+
+    it "raises TypeError when 'what' argument is invalid" do
+      lambda { browser.em(:id, 3.14).exists? }.should raise_error(TypeError)
+    end
+
+    it "raises MissingWayOfFindingObjectException when 'how' argument is invalid" do
+      lambda { browser.em(:no_such_how, 'some_value').exists? }.should raise_error(MissingWayOfFindingObjectException)
+    end
+  end
+
+  # Attribute methods
+  describe "#class_name" do
+    it "returns the class attribute if the element exists" do
+      browser.em(:id, "important-id").class_name.should == "important-class"
+    end
+
+    it "raises UnknownObjectException if the element does not exist" do
+      lambda { browser.em(:id, "no_such_id").class_name }.should raise_error(UnknownObjectException)
+      lambda { browser.em(:title, "no_such_title").class_name }.should raise_error(UnknownObjectException)
+      lambda { browser.em(:index, 1337).class_name }.should raise_error(UnknownObjectException)
+      lambda { browser.em(:xpath, "//em[@id='no_such_id']").class_name }.should raise_error(UnknownObjectException)
+    end
+  end
+
+  describe "#id" do
+    it "returns the id attribute if the element exists" do
+      browser.em(:class, 'important-class').id.should == "important-id"
+    end
+
+    it "raises UnknownObjectException if the element does not exist" do
+      lambda {browser.em(:id, "no_such_id").id }.should raise_error(UnknownObjectException)
+      lambda {browser.em(:title, "no_such_id").id }.should raise_error(UnknownObjectException)
+      lambda {browser.em(:index, 1337).id }.should raise_error(UnknownObjectException)
+    end
+  end
+
+  describe "#title" do
+    it "returns the title of the element" do
+      browser.em(:class, "important-class").title.should == "ergo cogito"
+    end
+  end
+
+  describe "#text" do
+    it "returns the text of the element" do
+      browser.em(:id, "important-id").text.should == "ergo cogito"
+    end
+
+    it "raises UnknownObjectException if the element does not exist" do
+      lambda { browser.em(:id, "no_such_id").text }.should raise_error(UnknownObjectException)
+      lambda { browser.em(:title, "no_such_title").text }.should raise_error(UnknownObjectException)
+      lambda { browser.em(:index, 1337).text }.should raise_error(UnknownObjectException)
+      lambda { browser.em(:xpath, "//em[@id='no_such_id']").text }.should raise_error(UnknownObjectException)
+    end
+  end
+
+  describe "#respond_to?" do
+    it "returns true for all attribute methods" do
+      browser.em(:index, 0).should respond_to(:id)
+      browser.em(:index, 0).should respond_to(:class_name)
+      browser.em(:index, 0).should respond_to(:style)
+      browser.em(:index, 0).should respond_to(:text)
+      browser.em(:index, 0).should respond_to(:title)
+    end
+  end
+
+  # Manipulation methods
+  describe "#click" do
+    it "raises UnknownObjectException if the element does not exist" do
+      lambda { browser.em(:id, "no_such_id").click }.should raise_error(UnknownObjectException)
+      lambda { browser.em(:title, "no_such_title").click }.should raise_error(UnknownObjectException)
+      lambda { browser.em(:index, 1337).click }.should raise_error(UnknownObjectException)
+      lambda { browser.em(:xpath, "//em[@id='no_such_id']").click }.should raise_error(UnknownObjectException)
+    end
+  end
+
+  describe "#to_s" do
+    bug "WTR-350", :watir do
+      it "returns a human readable representation of the element" do
+        browser.em(:id, 'important-id').to_s.should ==
+%q{tag:          em
+  class:        important-class
+  id:           important-id
+  title:        ergo cogito
+  text:         ergo cogito}
+      end
+    end
+  end
+
+end

data/spec/watirspec/ems_spec.rb

@@ -0,0 +1,32 @@
+# encoding: utf-8
+require File.dirname(__FILE__) + '/spec_helper'
+
+describe "Ems" do
+
+  before :each do
+    browser.goto(WatirSpec.files + "/non_control_elements.html")
+  end
+
+  describe "#length" do
+    it "returns the number of ems" do
+      browser.ems.length.should == 1
+    end
+  end
+
+  describe "#[]" do
+    it "returns the em at the given index" do
+      browser.ems[0].id.should == "important-id"
+    end
+  end
+
+  describe "#each" do
+    it "iterates through ems correctly" do
+      browser.ems.each_with_index do |e, index|
+        e.text.should == browser.em(:index, index).text
+        e.id.should == browser.em(:index, index).id
+        e.class_name.should == browser.em(:index, index).class_name
+      end
+    end
+  end
+
+end

data/spec/watirspec/filefield_spec.rb

@@ -0,0 +1,119 @@
+# encoding: utf-8
+require File.dirname(__FILE__) + '/spec_helper'
+
+describe "FileField" do
+
+  before :each do
+    browser.goto(WatirSpec.files + "/forms_with_input_elements.html")
+  end
+
+  describe "#exist?" do
+    it "returns true if the file field exists" do
+      browser.file_field(:id, 'new_user_portrait').should exist
+      browser.file_field(:id, /new_user_portrait/).should exist
+      browser.file_field(:name, 'new_user_portrait').should exist
+      browser.file_field(:name, /new_user_portrait/).should exist
+      browser.file_field(:class, 'portrait').should exist
+      browser.file_field(:class, /portrait/).should exist
+      browser.file_field(:index, 0).should exist
+      browser.file_field(:xpath, "//input[@id='new_user_portrait']").should exist
+    end
+
+    it "returns false if the file field doesn't exist" do
+      browser.file_field(:id, 'no_such_id').should_not exist
+      browser.file_field(:id, /no_such_id/).should_not exist
+      browser.file_field(:name, 'no_such_name').should_not exist
+      browser.file_field(:name, /no_such_name/).should_not exist
+      browser.file_field(:class, 'no_such_class').should_not exist
+      browser.file_field(:class, /no_such_class/).should_not exist
+      browser.file_field(:index, 1337).should_not exist
+      browser.file_field(:xpath, "//input[@id='no_such_id']").should_not exist
+    end
+
+    it "raises TypeError when 'what' argument is invalid" do
+      lambda { browser.file_field(:id, 3.14).exists? }.should raise_error(TypeError)
+    end
+
+    it "raises MissingWayOfFindingObjectException when 'how' argument is invalid" do
+      lambda { browser.file_field(:no_such_how, 'some_value').exists? }.should raise_error(MissingWayOfFindingObjectException)
+    end
+  end
+
+  # Attribute methods
+
+  describe "#class_name" do
+    it "returns the class attribute if the text field exists" do
+      browser.file_field(:index, 0).class_name.should == "portrait"
+    end
+
+    it "raises UnknownObjectException if the text field doesn't exist" do
+      lambda { browser.file_field(:index, 1337).class_name }.should raise_error(UnknownObjectException)
+    end
+  end
+
+  describe "#id" do
+    it "returns the id attribute if the text field exists" do
+      browser.file_field(:index, 0).id.should == "new_user_portrait"
+    end
+
+    it "raises UnknownObjectException if the text field doesn't exist" do
+      lambda { browser.file_field(:index, 1337).id }.should raise_error(UnknownObjectException)
+    end
+  end
+
+  describe "#name" do
+    it "returns the name attribute if the text field exists" do
+      browser.file_field(:index, 0).name.should == "new_user_portrait"
+    end
+
+    it "raises UnknownObjectException if the text field doesn't exist" do
+      lambda { browser.file_field(:index, 1337).name }.should raise_error(UnknownObjectException)
+    end
+  end
+
+  describe "#title" do
+    it "returns the title attribute if the text field exists" do
+      browser.file_field(:id, "new_user_portrait").title.should == "Smile!"
+    end
+  end
+
+  describe "#type" do
+    it "returns the type attribute if the text field exists" do
+      browser.file_field(:index, 0).type.should == "file"
+    end
+
+    it "raises UnknownObjectException if the text field doesn't exist" do
+      lambda { browser.file_field(:index, 1337).type }.should raise_error(UnknownObjectException)
+    end
+  end
+
+  describe "#respond_to?" do
+    it "returns true for all attribute methods" do
+      browser.file_field(:index, 0).should respond_to(:class_name)
+      browser.file_field(:index, 0).should respond_to(:id)
+      browser.file_field(:index, 0).should respond_to(:name)
+      browser.file_field(:index, 0).should respond_to(:title)
+      browser.file_field(:index, 0).should respond_to(:type)
+      browser.file_field(:index, 0).should respond_to(:value)
+    end
+  end
+
+  # Manipulation methods
+
+  describe "#set" do
+    bug "WTR-336", :watir do
+      it "is able to set a file path in the field and click the upload button and fire the onchange event" do
+        browser.goto("#{WatirSpec.host}/forms_with_input_elements.html")
+
+        path = File.expand_path(__FILE__)
+
+        browser.file_field(:name, "new_user_portrait").set path
+        browser.file_field(:name, "new_user_portrait").value.should == path
+        messages.first.should == path
+        browser.button(:name, "new_user_submit").click
+      end
+    end
+
+  end
+
+end