doc/classes/SeleniumOnRails/TestBuilderAccessors.html
doc/files/lib/selenium_on_rails/test_builder_accessors_rb.html
doc/files/lib/selenium_on_rails/test_builder_actions_rb.html
lib/selenium_on_rails/test_builder_accessors.rb
lib/selenium_on_rails/test_builder_actions.rb
@@ -3,17 +3,17 @@
== Overview
Selenium on Rails provides an easy way to test Rails application with
-Selenium[http://www.openqa.org/selenium/].
+SeleniumCore[http://www.openqa.org/selenium-core/].
This plugin does four things:
-1. The Selenium files don't have to pollute <tt>/public</tt>, they can stay in the Selenium gem or in <tt>/vendor/selenium</tt>.
+1. The Selenium Core files don't have to pollute <tt>/public</tt>, they can stay in the Selenium gem or in <tt>/vendor/selenium</tt>.
2. No need to create suite files, they are generated on the fly -- one suite per directory in <tt>/test/selenium</tt> (suites can be nested).
3. Instead of writing the test cases in HTML you can use a number of better formats (see <tt>Formats</tt>).
4. Loading of fixtures and wiping of session (<tt>/selenium/setup</tt>).
== Installation
-1. Selenium needs to be available. It could either be installed as a gem (<tt>gem install selenium</tt>) or in <tt>/vendor/selenium/</tt>.
+1. Selenium Core needs to be available. It could either be installed as a gem (<tt>gem install selenium</tt>) or in <tt>/vendor/selenium/</tt>.
2. Install Selenium on Rails: <tt>script/plugin install http://andthennothing.net/svn/public/selenium_on_rails/</tt>
3. <i>If RedCloth is available the Selenese test cases can use it for better markup.</i>
4. Run the Rakefile in the plugin's directory to run the tests in order to see that everything works. (If RedCloth isn't installed a few tests will fail since they assume RedCloth is installed.)
@@ -149,8 +149,8 @@ the server when needed.
=== user_extension.js
Selenium has support for <tt>user_extension.js</tt> which is a way to extend the
-functionality of Selenium. However there is currently no easy way to add such a
-file in Selenium on Rails.
+functionality of Selenium Core. However there is currently no easy way to add
+such a file in Selenium on Rails.
=== More setup/teardown support?
README
@@ -17,3 +17,11 @@ task :rdoc do
rm_rf 'doc'
RDoc::RDoc.new.document(%w(--line-numbers --inline-source --title SeleniumOnRails README lib))
end
+
+begin
+ require 'rcov/rcovtask'
+ Rcov::RcovTask.new do |t|
+ t.test_files = FileList['test/*_test.rb']
+ end
+rescue LoadError #if rcov isn't available, ignore
+end
Rakefile
@@ -193,7 +193,7 @@
<span class="ruby-comment cmt"># File lib/controllers/selenium_controller.rb, line 31</span>
31: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">support_file</span>
32: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">params</span>[<span class="ruby-identifier">:filename</span>].<span class="ruby-identifier">empty?</span>
-33: <span class="ruby-identifier">redirect_to</span> <span class="ruby-identifier">:filename</span> =<span class="ruby-operator">></span> <span class="ruby-value str">'TestRunner.html'</span>
+33: <span class="ruby-identifier">redirect_to</span> <span class="ruby-identifier">:filename</span> =<span class="ruby-operator">></span> <span class="ruby-value str">'TestRunner.html'</span>, <span class="ruby-identifier">:test</span> =<span class="ruby-operator">></span> <span class="ruby-value str">'tests'</span>
34: <span class="ruby-keyword kw">return</span>
35: <span class="ruby-keyword kw">end</span>
36:
doc/classes/SeleniumController.html
@@ -96,8 +96,8 @@ Module <a href="SeleniumOnRails/PartialsSupport.html" class="link">SeleniumOnRai
Module <a href="SeleniumOnRails/Paths.html" class="link">SeleniumOnRails::Paths</a><br />
Module <a href="SeleniumOnRails/Renderer.html" class="link">SeleniumOnRails::Renderer</a><br />
Module <a href="SeleniumOnRails/SuiteRenderer.html" class="link">SeleniumOnRails::SuiteRenderer</a><br />
+Module <a href="SeleniumOnRails/TestBuilderAccessors.html" class="link">SeleniumOnRails::TestBuilderAccessors</a><br />
Module <a href="SeleniumOnRails/TestBuilderActions.html" class="link">SeleniumOnRails::TestBuilderActions</a><br />
-Module <a href="SeleniumOnRails/TestBuilderChecks.html" class="link">SeleniumOnRails::TestBuilderChecks</a><br />
Class <a href="SeleniumOnRails/RSelenese.html" class="link">SeleniumOnRails::RSelenese</a><br />
Class <a href="SeleniumOnRails/Selenese.html" class="link">SeleniumOnRails::Selenese</a><br />
Class <a href="SeleniumOnRails/TestBuilder.html" class="link">SeleniumOnRails::TestBuilder</a><br />
doc/classes/SeleniumOnRails.html
@@ -80,8 +80,8 @@
<h3 class="section-bar">Methods</h3>
<div class="name-list">
- <a href="#M000076">available_fixtures</a>
- <a href="#M000077">load_fixtures</a>
+ <a href="#M000048">available_fixtures</a>
+ <a href="#M000049">load_fixtures</a>
</div>
</div>
@@ -110,43 +110,43 @@
<div id="methods">
<h3 class="section-bar">Public Instance methods</h3>
- <div id="method-M000076" class="method-detail">
- <a name="M000076"></a>
+ <div id="method-M000048" class="method-detail">
+ <a name="M000048"></a>
<div class="method-heading">
- <a href="#M000076" class="method-signature">
+ <a href="#M000048" class="method-signature">
<span class="method-name">available_fixtures</span><span class="method-args">()</span>
</a>
</div>
<div class="method-description">
<p><a class="source-toggle" href="#"
- onclick="toggleCode('M000076-source');return false;">[Source]</a></p>
- <div class="method-source-code" id="M000076-source">
+ onclick="toggleCode('M000048-source');return false;">[Source]</a></p>
+ <div class="method-source-code" id="M000048-source">
<pre>
<span class="ruby-comment cmt"># File lib/selenium_on_rails/fixture_loader.rb, line 6</span>
6: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">available_fixtures</span>
-7: <span class="ruby-identifier">files</span> = <span class="ruby-constant">Dir</span>.<span class="ruby-identifier">entries</span>(<span class="ruby-identifier">fixtures_path</span>).<span class="ruby-identifier">reject</span> {<span class="ruby-operator">|</span><span class="ruby-identifier">f</span><span class="ruby-operator">|</span> <span class="ruby-keyword kw">not</span> <span class="ruby-constant">File</span>.<span class="ruby-identifier">file?</span>(<span class="ruby-constant">File</span>.<span class="ruby-identifier">join</span>(<span class="ruby-identifier">fixtures_path</span>, <span class="ruby-identifier">f</span>))}
-8: <span class="ruby-identifier">files</span>.<span class="ruby-identifier">collect</span> {<span class="ruby-operator">|</span><span class="ruby-identifier">f</span><span class="ruby-operator">|</span> <span class="ruby-identifier">f</span>.<span class="ruby-identifier">sub</span>(<span class="ruby-regexp re">/\.[^.]*$/</span>, <span class="ruby-value str">''</span>)}
+7: <span class="ruby-identifier">files</span> = <span class="ruby-constant">Dir</span>[<span class="ruby-node">"#{fixtures_path}/*.{yml,csv}"</span>]
+8: <span class="ruby-identifier">files</span>.<span class="ruby-identifier">collect</span> {<span class="ruby-operator">|</span><span class="ruby-identifier">f</span><span class="ruby-operator">|</span> <span class="ruby-constant">File</span>.<span class="ruby-identifier">basename</span>(<span class="ruby-identifier">f</span>).<span class="ruby-identifier">sub</span>(<span class="ruby-regexp re">/\.[^.]*$/</span>, <span class="ruby-value str">''</span>)}
9: <span class="ruby-keyword kw">end</span>
</pre>
</div>
</div>
</div>
- <div id="method-M000077" class="method-detail">
- <a name="M000077"></a>
+ <div id="method-M000049" class="method-detail">
+ <a name="M000049"></a>
<div class="method-heading">
- <a href="#M000077" class="method-signature">
+ <a href="#M000049" class="method-signature">
<span class="method-name">load_fixtures</span><span class="method-args">(fixtures)</span>
</a>
</div>
<div class="method-description">
<p><a class="source-toggle" href="#"
- onclick="toggleCode('M000077-source');return false;">[Source]</a></p>
- <div class="method-source-code" id="M000077-source">
+ onclick="toggleCode('M000049-source');return false;">[Source]</a></p>
+ <div class="method-source-code" id="M000049-source">
<pre>
<span class="ruby-comment cmt"># File lib/selenium_on_rails/fixture_loader.rb, line 11</span>
11: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">load_fixtures</span> <span class="ruby-identifier">fixtures</span>
doc/classes/SeleniumOnRails/FixtureLoader.html
@@ -80,12 +80,12 @@
<h3 class="section-bar">Methods</h3>
<div class="name-list">
- <a href="#M000070">fixtures_path</a>
- <a href="#M000069">layout_path</a>
- <a href="#M000071">log_path</a>
- <a href="#M000066">selenium_path</a>
- <a href="#M000067">selenium_tests_path</a>
- <a href="#M000068">view_path</a>
+ <a href="#M000042">fixtures_path</a>
+ <a href="#M000041">layout_path</a>
+ <a href="#M000043">log_path</a>
+ <a href="#M000038">selenium_path</a>
+ <a href="#M000039">selenium_tests_path</a>
+ <a href="#M000040">view_path</a>
</div>
</div>
@@ -107,19 +107,19 @@
<div id="methods">
<h3 class="section-bar">Public Instance methods</h3>
- <div id="method-M000070" class="method-detail">
- <a name="M000070"></a>
+ <div id="method-M000042" class="method-detail">
+ <a name="M000042"></a>
<div class="method-heading">
- <a href="#M000070" class="method-signature">
+ <a href="#M000042" class="method-signature">
<span class="method-name">fixtures_path</span><span class="method-args">()</span>
</a>
</div>
<div class="method-description">
<p><a class="source-toggle" href="#"
- onclick="toggleCode('M000070-source');return false;">[Source]</a></p>
- <div class="method-source-code" id="M000070-source">
+ onclick="toggleCode('M000042-source');return false;">[Source]</a></p>
+ <div class="method-source-code" id="M000042-source">
<pre>
<span class="ruby-comment cmt"># File lib/selenium_on_rails/paths.rb, line 25</span>
25: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">fixtures_path</span>
@@ -130,11 +130,11 @@
</div>
</div>
- <div id="method-M000069" class="method-detail">
- <a name="M000069"></a>
+ <div id="method-M000041" class="method-detail">
+ <a name="M000041"></a>
<div class="method-heading">
- <a href="#M000069" class="method-signature">
+ <a href="#M000041" class="method-signature">
<span class="method-name">layout_path</span><span class="method-args">()</span>
</a>
</div>
@@ -146,8 +146,8 @@ to the app/views/ directory since Rails doesn’t support absolute
paths to layout templates.
</p>
<p><a class="source-toggle" href="#"
- onclick="toggleCode('M000069-source');return false;">[Source]</a></p>
- <div class="method-source-code" id="M000069-source">
+ onclick="toggleCode('M000041-source');return false;">[Source]</a></p>
+ <div class="method-source-code" id="M000041-source">
<pre>
<span class="ruby-comment cmt"># File lib/selenium_on_rails/paths.rb, line 19</span>
19: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">layout_path</span>
@@ -160,19 +160,19 @@ paths to layout templates.
</div>
</div>
- <div id="method-M000071" class="method-detail">
- <a name="M000071"></a>
+ <div id="method-M000043" class="method-detail">
+ <a name="M000043"></a>
<div class="method-heading">
- <a href="#M000071" class="method-signature">
+ <a href="#M000043" class="method-signature">
<span class="method-name">log_path</span><span class="method-args">(log_file)</span>
</a>
</div>
<div class="method-description">
<p><a class="source-toggle" href="#"
- onclick="toggleCode('M000071-source');return false;">[Source]</a></p>
- <div class="method-source-code" id="M000071-source">
+ onclick="toggleCode('M000043-source');return false;">[Source]</a></p>
+ <div class="method-source-code" id="M000043-source">
<pre>
<span class="ruby-comment cmt"># File lib/selenium_on_rails/paths.rb, line 29</span>
29: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">log_path</span> <span class="ruby-identifier">log_file</span>
@@ -183,19 +183,19 @@ paths to layout templates.
</div>
</div>
- <div id="method-M000066" class="method-detail">
- <a name="M000066"></a>
+ <div id="method-M000038" class="method-detail">
+ <a name="M000038"></a>
<div class="method-heading">
- <a href="#M000066" class="method-signature">
+ <a href="#M000038" class="method-signature">
<span class="method-name">selenium_path</span><span class="method-args">()</span>
</a>
</div>
<div class="method-description">
<p><a class="source-toggle" href="#"
- onclick="toggleCode('M000066-source');return false;">[Source]</a></p>
- <div class="method-source-code" id="M000066-source">
+ onclick="toggleCode('M000038-source');return false;">[Source]</a></p>
+ <div class="method-source-code" id="M000038-source">
<pre>
<span class="ruby-comment cmt"># File lib/selenium_on_rails/paths.rb, line 3</span>
3: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">selenium_path</span>
@@ -207,19 +207,19 @@ paths to layout templates.
</div>
</div>
- <div id="method-M000067" class="method-detail">
- <a name="M000067"></a>
+ <div id="method-M000039" class="method-detail">
+ <a name="M000039"></a>
<div class="method-heading">
- <a href="#M000067" class="method-signature">
+ <a href="#M000039" class="method-signature">
<span class="method-name">selenium_tests_path</span><span class="method-args">()</span>
</a>
</div>
<div class="method-description">
<p><a class="source-toggle" href="#"
- onclick="toggleCode('M000067-source');return false;">[Source]</a></p>
- <div class="method-source-code" id="M000067-source">
+ onclick="toggleCode('M000039-source');return false;">[Source]</a></p>
+ <div class="method-source-code" id="M000039-source">
<pre>
<span class="ruby-comment cmt"># File lib/selenium_on_rails/paths.rb, line 8</span>
8: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">selenium_tests_path</span>
@@ -230,19 +230,19 @@ paths to layout templates.
</div>
</div>
- <div id="method-M000068" class="method-detail">
- <a name="M000068"></a>
+ <div id="method-M000040" class="method-detail">
+ <a name="M000040"></a>
<div class="method-heading">
- <a href="#M000068" class="method-signature">
+ <a href="#M000040" class="method-signature">
<span class="method-name">view_path</span><span class="method-args">(view)</span>
</a>
</div>
<div class="method-description">
<p><a class="source-toggle" href="#"
- onclick="toggleCode('M000068-source');return false;">[Source]</a></p>
- <div class="method-source-code" id="M000068-source">
+ onclick="toggleCode('M000040-source');return false;">[Source]</a></p>
+ <div class="method-source-code" id="M000040-source">
<pre>
<span class="ruby-comment cmt"># File lib/selenium_on_rails/paths.rb, line 12</span>
12: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">view_path</span> <span class="ruby-identifier">view</span>
doc/classes/SeleniumOnRails/Paths.html
@@ -192,10 +192,10 @@ Render <em>template</em> using <em>local_assigns</em>.
24: <span class="ruby-identifier">title</span> = (<span class="ruby-ivar">@view</span>.<span class="ruby-identifier">assigns</span>[<span class="ruby-value str">'page_title'</span>] <span class="ruby-keyword kw">or</span> <span class="ruby-identifier">local_assigns</span>[<span class="ruby-value str">'page_title'</span>])
25: <span class="ruby-identifier">table</span>(<span class="ruby-identifier">title</span>) <span class="ruby-keyword kw">do</span>
26: <span class="ruby-identifier">test</span> = <span class="ruby-keyword kw">self</span> <span class="ruby-comment cmt">#to enable test.command</span>
-27:
+27:
28: <span class="ruby-identifier">assign_locals_code</span> = <span class="ruby-value str">''</span>
29: <span class="ruby-identifier">local_assigns</span>.<span class="ruby-identifier">each_key</span> {<span class="ruby-operator">|</span><span class="ruby-identifier">key</span><span class="ruby-operator">|</span> <span class="ruby-identifier">assign_locals_code</span> <span class="ruby-operator"><<</span> <span class="ruby-node">"#{key} = local_assigns[#{key.inspect}];"</span>}
-30:
+30:
31: <span class="ruby-identifier">eval</span> <span class="ruby-identifier">assign_locals_code</span> <span class="ruby-operator">+</span> <span class="ruby-value str">"\n"</span> <span class="ruby-operator">+</span> <span class="ruby-identifier">template</span>
32: <span class="ruby-keyword kw">end</span>
33: <span class="ruby-keyword kw">end</span>
doc/classes/SeleniumOnRails/RSelenese.html
@@ -80,7 +80,7 @@
<h3 class="section-bar">Methods</h3>
<div class="name-list">
- <a href="#M000065">render_test_case</a>
+ <a href="#M000037">render_test_case</a>
</div>
</div>
@@ -110,19 +110,19 @@
<div id="methods">
<h3 class="section-bar">Public Instance methods</h3>
- <div id="method-M000065" class="method-detail">
- <a name="M000065"></a>
+ <div id="method-M000037" class="method-detail">
+ <a name="M000037"></a>
<div class="method-heading">
- <a href="#M000065" class="method-signature">
+ <a href="#M000037" class="method-signature">
<span class="method-name">render_test_case</span><span class="method-args">(filename)</span>
</a>
</div>
<div class="method-description">
<p><a class="source-toggle" href="#"
- onclick="toggleCode('M000065-source');return false;">[Source]</a></p>
- <div class="method-source-code" id="M000065-source">
+ onclick="toggleCode('M000037-source');return false;">[Source]</a></p>
+ <div class="method-source-code" id="M000037-source">
<pre>
<span class="ruby-comment cmt"># File lib/selenium_on_rails/renderer.rb, line 5</span>
5: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">render_test_case</span> <span class="ruby-identifier">filename</span>
doc/classes/SeleniumOnRails/Renderer.html
@@ -80,10 +80,10 @@
<h3 class="section-bar">Methods</h3>
<div class="name-list">
- <a href="#M000075">link_to_test_case</a>
- <a href="#M000074">test_cases</a>
- <a href="#M000072">test_suite_name</a>
- <a href="#M000073">test_suites</a>
+ <a href="#M000047">link_to_test_case</a>
+ <a href="#M000046">test_cases</a>
+ <a href="#M000044">test_suite_name</a>
+ <a href="#M000045">test_suites</a>
</div>
</div>
@@ -105,19 +105,19 @@
<div id="methods">
<h3 class="section-bar">Public Instance methods</h3>
- <div id="method-M000075" class="method-detail">
- <a name="M000075"></a>
+ <div id="method-M000047" class="method-detail">
+ <a name="M000047"></a>
<div class="method-heading">
- <a href="#M000075" class="method-signature">
+ <a href="#M000047" class="method-signature">
<span class="method-name">link_to_test_case</span><span class="method-args">(suite_name, filename)</span>
</a>
</div>
<div class="method-description">
<p><a class="source-toggle" href="#"
- onclick="toggleCode('M000075-source');return false;">[Source]</a></p>
- <div class="method-source-code" id="M000075-source">
+ onclick="toggleCode('M000047-source');return false;">[Source]</a></p>
+ <div class="method-source-code" id="M000047-source">
<pre>
<span class="ruby-comment cmt"># File lib/selenium_on_rails/suite_renderer.rb, line 24</span>
24: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">link_to_test_case</span> <span class="ruby-identifier">suite_name</span>, <span class="ruby-identifier">filename</span>
@@ -129,19 +129,19 @@
</div>
</div>
- <div id="method-M000074" class="method-detail">
- <a name="M000074"></a>
+ <div id="method-M000046" class="method-detail">
+ <a name="M000046"></a>
<div class="method-heading">
- <a href="#M000074" class="method-signature">
+ <a href="#M000046" class="method-signature">
<span class="method-name">test_cases</span><span class="method-args">(path)</span>
</a>
</div>
<div class="method-description">
<p><a class="source-toggle" href="#"
- onclick="toggleCode('M000074-source');return false;">[Source]</a></p>
- <div class="method-source-code" id="M000074-source">
+ onclick="toggleCode('M000046-source');return false;">[Source]</a></p>
+ <div class="method-source-code" id="M000046-source">
<pre>
<span class="ruby-comment cmt"># File lib/selenium_on_rails/suite_renderer.rb, line 18</span>
18: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">test_cases</span> <span class="ruby-identifier">path</span>
@@ -154,19 +154,19 @@
</div>
</div>
- <div id="method-M000072" class="method-detail">
- <a name="M000072"></a>
+ <div id="method-M000044" class="method-detail">
+ <a name="M000044"></a>
<div class="method-heading">
- <a href="#M000072" class="method-signature">
+ <a href="#M000044" class="method-signature">
<span class="method-name">test_suite_name</span><span class="method-args">(path)</span>
</a>
</div>
<div class="method-description">
<p><a class="source-toggle" href="#"
- onclick="toggleCode('M000072-source');return false;">[Source]</a></p>
- <div class="method-source-code" id="M000072-source">
+ onclick="toggleCode('M000044-source');return false;">[Source]</a></p>
+ <div class="method-source-code" id="M000044-source">
<pre>
<span class="ruby-comment cmt"># File lib/selenium_on_rails/suite_renderer.rb, line 2</span>
2: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">test_suite_name</span> <span class="ruby-identifier">path</span>
@@ -178,19 +178,19 @@
</div>
</div>
- <div id="method-M000073" class="method-detail">
- <a name="M000073"></a>
+ <div id="method-M000045" class="method-detail">
+ <a name="M000045"></a>
<div class="method-heading">
- <a href="#M000073" class="method-signature">
+ <a href="#M000045" class="method-signature">
<span class="method-name">test_suites</span><span class="method-args">(path)</span>
</a>
</div>
<div class="method-description">
<p><a class="source-toggle" href="#"
- onclick="toggleCode('M000073-source');return false;">[Source]</a></p>
- <div class="method-source-code" id="M000073-source">
+ onclick="toggleCode('M000045-source');return false;">[Source]</a></p>
+ <div class="method-source-code" id="M000045-source">
<pre>
<span class="ruby-comment cmt"># File lib/selenium_on_rails/suite_renderer.rb, line 7</span>
7: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">test_suites</span> <span class="ruby-identifier">path</span>
doc/classes/SeleniumOnRails/SuiteRenderer.html
@@ -87,14 +87,14 @@ invoked through <a href="RSelenese.html">SeleniumOnRails::RSelenese</a>.
See <a
href="TestBuilderActions.html">SeleniumOnRails::TestBuilderActions</a> for
the available actions and <a
-href="TestBuilderChecks.html">SeleniumOnRails::TestBuilderChecks</a> for
-the available checks.
+href="TestBuilderAccessors.html">SeleniumOnRails::TestBuilderAccessors</a>
+for the available checks.
</p>
<p>
For more information on the commands supported by <a
href="TestBuilder.html">TestBuilder</a>, see the Selenium Commands
Documentation at <a
-href="http://www.openqa.org/selenium/seleniumReference.html">www.openqa.org/selenium/seleniumReference.html</a>.
+href="http://release.openqa.org/selenium-core/nightly/reference.html">release.openqa.org/selenium-core/nightly/reference.html</a>.
</p>
</div>
@@ -106,10 +106,14 @@ href="http://www.openqa.org/selenium/seleniumReference.html">www.openqa.org/sele
<h3 class="section-bar">Methods</h3>
<div class="name-list">
- <a href="#M000087">command</a>
- <a href="#M000085">new</a>
+ <a href="#M000088">command</a>
+ <a href="#M000090">command_and_wait</a>
+ <a href="#M000089">command_verbatim</a>
+ <a href="#M000085">exactize</a>
+ <a href="#M000091">make_command_waiting</a>
+ <a href="#M000086">new</a>
<a href="#M000084">selenize</a>
- <a href="#M000086">table</a>
+ <a href="#M000087">table</a>
</div>
</div>
@@ -122,7 +126,7 @@ href="http://www.openqa.org/selenium/seleniumReference.html">www.openqa.org/sele
<div id="includes-list">
<span class="include-name"><a href="TestBuilderActions.html">SeleniumOnRails::TestBuilderActions</a></span>
- <span class="include-name"><a href="TestBuilderChecks.html">SeleniumOnRails::TestBuilderChecks</a></span>
+ <span class="include-name"><a href="TestBuilderAccessors.html">SeleniumOnRails::TestBuilderAccessors</a></span>
</div>
</div>
@@ -139,11 +143,11 @@ href="http://www.openqa.org/selenium/seleniumReference.html">www.openqa.org/sele
<div id="methods">
<h3 class="section-bar">Public Class methods</h3>
- <div id="method-M000085" class="method-detail">
- <a name="M000085"></a>
+ <div id="method-M000086" class="method-detail">
+ <a name="M000086"></a>
<div class="method-heading">
- <a href="#M000085" class="method-signature">
+ <a href="#M000086" class="method-signature">
<span class="method-name">new</span><span class="method-args">(view)</span>
</a>
</div>
@@ -153,15 +157,15 @@ href="http://www.openqa.org/selenium/seleniumReference.html">www.openqa.org/sele
Create a new <a href="TestBuilder.html">TestBuilder</a> for <em>view</em>.
</p>
<p><a class="source-toggle" href="#"
- onclick="toggleCode('M000085-source');return false;">[Source]</a></p>
- <div class="method-source-code" id="M000085-source">
+ onclick="toggleCode('M000086-source');return false;">[Source]</a></p>
+ <div class="method-source-code" id="M000086-source">
<pre>
- <span class="ruby-comment cmt"># File lib/selenium_on_rails/test_builder.rb, line 346</span>
-346: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">initialize</span> <span class="ruby-identifier">view</span>
-347: <span class="ruby-ivar">@view</span> = <span class="ruby-identifier">view</span>
-348: <span class="ruby-ivar">@output</span> = <span class="ruby-value str">''</span>
-349: <span class="ruby-ivar">@xml</span> = <span class="ruby-constant">Builder</span><span class="ruby-operator">::</span><span class="ruby-constant">XmlMarkup</span>.<span class="ruby-identifier">new</span> <span class="ruby-identifier">:indent</span> =<span class="ruby-operator">></span> <span class="ruby-value">2</span>, <span class="ruby-identifier">:target</span> =<span class="ruby-operator">></span> <span class="ruby-ivar">@output</span>
-350: <span class="ruby-keyword kw">end</span>
+ <span class="ruby-comment cmt"># File lib/selenium_on_rails/test_builder.rb, line 26</span>
+26: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">initialize</span> <span class="ruby-identifier">view</span>
+27: <span class="ruby-ivar">@view</span> = <span class="ruby-identifier">view</span>
+28: <span class="ruby-ivar">@output</span> = <span class="ruby-value str">''</span>
+29: <span class="ruby-ivar">@xml</span> = <span class="ruby-constant">Builder</span><span class="ruby-operator">::</span><span class="ruby-constant">XmlMarkup</span>.<span class="ruby-identifier">new</span> <span class="ruby-identifier">:indent</span> =<span class="ruby-operator">></span> <span class="ruby-value">2</span>, <span class="ruby-identifier">:target</span> =<span class="ruby-operator">></span> <span class="ruby-ivar">@output</span>
+30: <span class="ruby-keyword kw">end</span>
</pre>
</div>
</div>
@@ -184,10 +188,10 @@ Convert <em>str</em> to a Selenium command name.
onclick="toggleCode('M000084-source');return false;">[Source]</a></p>
<div class="method-source-code" id="M000084-source">
<pre>
- <span class="ruby-comment cmt"># File lib/selenium_on_rails/test_builder.rb, line 341</span>
-341: <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">selenize</span>(<span class="ruby-identifier">str</span>)
-342: <span class="ruby-identifier">str</span>.<span class="ruby-identifier">camelize</span>.<span class="ruby-identifier">gsub</span>(<span class="ruby-regexp re">/^[A-Z]/</span>) {<span class="ruby-operator">|</span><span class="ruby-identifier">s</span><span class="ruby-operator">|</span> <span class="ruby-identifier">s</span>.<span class="ruby-identifier">downcase</span> }
-343: <span class="ruby-keyword kw">end</span>
+ <span class="ruby-comment cmt"># File lib/selenium_on_rails/test_builder.rb, line 15</span>
+15: <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">selenize</span> <span class="ruby-identifier">str</span>
+16: <span class="ruby-identifier">str</span>.<span class="ruby-identifier">camelize</span>.<span class="ruby-identifier">gsub</span>(<span class="ruby-regexp re">/^[A-Z]/</span>) {<span class="ruby-operator">|</span><span class="ruby-identifier">s</span><span class="ruby-operator">|</span> <span class="ruby-identifier">s</span>.<span class="ruby-identifier">downcase</span> }
+17: <span class="ruby-keyword kw">end</span>
</pre>
</div>
</div>
@@ -195,11 +199,11 @@ Convert <em>str</em> to a Selenium command name.
<h3 class="section-bar">Public Instance methods</h3>
- <div id="method-M000087" class="method-detail">
- <a name="M000087"></a>
+ <div id="method-M000088" class="method-detail">
+ <a name="M000088"></a>
<div class="method-heading">
- <a href="#M000087" class="method-signature">
+ <a href="#M000088" class="method-signature">
<span class="method-name">command</span><span class="method-args">(cmd, target=nil, value=nil)</span>
</a>
</div>
@@ -210,27 +214,125 @@ Add a new test command using <em>cmd</em>, <em>target</em> and
<em>value</em>.
</p>
<p><a class="source-toggle" href="#"
- onclick="toggleCode('M000087-source');return false;">[Source]</a></p>
- <div class="method-source-code" id="M000087-source">
+ onclick="toggleCode('M000088-source');return false;">[Source]</a></p>
+ <div class="method-source-code" id="M000088-source">
<pre>
- <span class="ruby-comment cmt"># File lib/selenium_on_rails/test_builder.rb, line 361</span>
-361: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">command</span> <span class="ruby-identifier">cmd</span>, <span class="ruby-identifier">target</span>=<span class="ruby-keyword kw">nil</span>, <span class="ruby-identifier">value</span>=<span class="ruby-keyword kw">nil</span>
-362: <span class="ruby-ivar">@xml</span>.<span class="ruby-identifier">tr</span> <span class="ruby-keyword kw">do</span>
-363: <span class="ruby-identifier">_tdata</span> <span class="ruby-identifier">cmd</span>
-364: <span class="ruby-identifier">_tdata</span> <span class="ruby-identifier">target</span>
-365: <span class="ruby-identifier">_tdata</span> <span class="ruby-identifier">value</span>
-366: <span class="ruby-keyword kw">end</span>
-367: <span class="ruby-keyword kw">end</span>
+ <span class="ruby-comment cmt"># File lib/selenium_on_rails/test_builder.rb, line 41</span>
+41: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">command</span> <span class="ruby-identifier">cmd</span>, <span class="ruby-identifier">target</span>=<span class="ruby-keyword kw">nil</span>, <span class="ruby-identifier">value</span>=<span class="ruby-keyword kw">nil</span>
+42: <span class="ruby-ivar">@xml</span>.<span class="ruby-identifier">tr</span> <span class="ruby-keyword kw">do</span>
+43: <span class="ruby-identifier">_tdata</span> <span class="ruby-identifier">cmd</span>
+44: <span class="ruby-identifier">_tdata</span> <span class="ruby-identifier">target</span>
+45: <span class="ruby-identifier">_tdata</span> <span class="ruby-identifier">value</span>
+46: <span class="ruby-keyword kw">end</span>
+47: <span class="ruby-keyword kw">end</span>
</pre>
</div>
</div>
</div>
- <div id="method-M000086" class="method-detail">
- <a name="M000086"></a>
+ <div id="method-M000090" class="method-detail">
+ <a name="M000090"></a>
<div class="method-heading">
- <a href="#M000086" class="method-signature">
+ <a href="#M000090" class="method-signature">
+ <span class="method-name">command_and_wait</span><span class="method-args">(cmd, target=nil, value=nil)</span>
+ </a>
+ </div>
+
+ <div class="method-description">
+ <p>
+Same as <em>command</em> but add <em>AndWait</em> to the name of
+<em>cmd</em>.
+</p>
+ <p><a class="source-toggle" href="#"
+ onclick="toggleCode('M000090-source');return false;">[Source]</a></p>
+ <div class="method-source-code" id="M000090-source">
+<pre>
+ <span class="ruby-comment cmt"># File lib/selenium_on_rails/test_builder.rb, line 52</span>
+52: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">command_and_wait</span> <span class="ruby-identifier">cmd</span>, <span class="ruby-identifier">target</span>=<span class="ruby-keyword kw">nil</span>, <span class="ruby-identifier">value</span>=<span class="ruby-keyword kw">nil</span>
+53: <span class="ruby-identifier">command_verbatim</span> <span class="ruby-identifier">cmd</span>.<span class="ruby-identifier">to_s</span> <span class="ruby-operator">+</span> <span class="ruby-value str">'AndWait'</span>, <span class="ruby-identifier">target</span>, <span class="ruby-identifier">value</span>
+54: <span class="ruby-keyword kw">end</span>
+</pre>
+ </div>
+ </div>
+ </div>
+
+ <div id="method-M000089" class="method-detail">
+ <a name="M000089"></a>
+
+ <div class="method-heading">
+ <span class="method-name">command_verbatim</span><span class="method-args">(cmd, target=nil, value=nil)</span>
+ </div>
+
+ <div class="method-description">
+ <p>
+Alias for <a href="TestBuilder.html#M000088">command</a>
+</p>
+ </div>
+ </div>
+
+ <div id="method-M000085" class="method-detail">
+ <a name="M000085"></a>
+
+ <div class="method-heading">
+ <a href="#M000085" class="method-signature">
+ <span class="method-name">exactize</span><span class="method-args">(pattern)</span>
+ </a>
+ </div>
+
+ <div class="method-description">
+ <p>
+Prepends <em>pattern</em> with ‘exact:’ if it would be
+considered containing string-match pattern otherwise.
+</p>
+ <p><a class="source-toggle" href="#"
+ onclick="toggleCode('M000085-source');return false;">[Source]</a></p>
+ <div class="method-source-code" id="M000085-source">
+<pre>
+ <span class="ruby-comment cmt"># File lib/selenium_on_rails/test_builder.rb, line 21</span>
+21: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">exactize</span> <span class="ruby-identifier">pattern</span>
+22: <span class="ruby-identifier">pattern</span>.<span class="ruby-identifier">include?</span>(<span class="ruby-value str">':'</span>) <span class="ruby-operator">?</span> <span class="ruby-node">"exact:#{pattern}"</span> <span class="ruby-operator">:</span> <span class="ruby-identifier">pattern</span>
+23: <span class="ruby-keyword kw">end</span>
+</pre>
+ </div>
+ </div>
+ </div>
+
+ <div id="method-M000091" class="method-detail">
+ <a name="M000091"></a>
+
+ <div class="method-heading">
+ <a href="#M000091" class="method-signature">
+ <span class="method-name">make_command_waiting</span><span class="method-args">() {|| ...}</span>
+ </a>
+ </div>
+
+ <div class="method-description">
+ <p>
+Re routes commands in the provided block to <a
+href="TestBuilder.html#M000090">command_and_wait</a> instead of <a
+href="TestBuilder.html#M000088">command</a>.
+</p>
+ <p><a class="source-toggle" href="#"
+ onclick="toggleCode('M000091-source');return false;">[Source]</a></p>
+ <div class="method-source-code" id="M000091-source">
+<pre>
+ <span class="ruby-comment cmt"># File lib/selenium_on_rails/test_builder.rb, line 58</span>
+58: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">make_command_waiting</span>
+59: <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">class</span>.<span class="ruby-identifier">send</span> <span class="ruby-identifier">:alias_method</span>, <span class="ruby-identifier">:command</span>, <span class="ruby-identifier">:command_and_wait</span>
+60: <span class="ruby-keyword kw">yield</span>
+61: <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">class</span>.<span class="ruby-identifier">send</span> <span class="ruby-identifier">:alias_method</span>, <span class="ruby-identifier">:command</span>, <span class="ruby-identifier">:command_verbatim</span>
+62: <span class="ruby-keyword kw">end</span>
+</pre>
+ </div>
+ </div>
+ </div>
+
+ <div id="method-M000087" class="method-detail">
+ <a name="M000087"></a>
+
+ <div class="method-heading">
+ <a href="#M000087" class="method-signature">
<span class="method-name">table</span><span class="method-args">(title) {|self| ...}</span>
</a>
</div>
@@ -240,16 +342,16 @@ Add a new test command using <em>cmd</em>, <em>target</em> and
Add a new table of tests, and return the HTML.
</p>
<p><a class="source-toggle" href="#"
- onclick="toggleCode('M000086-source');return false;">[Source]</a></p>
- <div class="method-source-code" id="M000086-source">
+ onclick="toggleCode('M000087-source');return false;">[Source]</a></p>
+ <div class="method-source-code" id="M000087-source">
<pre>
- <span class="ruby-comment cmt"># File lib/selenium_on_rails/test_builder.rb, line 353</span>
-353: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">table</span> <span class="ruby-identifier">title</span>
-354: <span class="ruby-ivar">@xml</span>.<span class="ruby-identifier">table</span> <span class="ruby-keyword kw">do</span>
-355: <span class="ruby-ivar">@xml</span>.<span class="ruby-identifier">tr</span> <span class="ruby-keyword kw">do</span> <span class="ruby-ivar">@xml</span>.<span class="ruby-identifier">th</span>(<span class="ruby-identifier">title</span>, <span class="ruby-identifier">:colspan</span> =<span class="ruby-operator">></span> <span class="ruby-value">3</span>) <span class="ruby-keyword kw">end</span>
-356: <span class="ruby-keyword kw">yield</span> <span class="ruby-keyword kw">self</span>
-357: <span class="ruby-keyword kw">end</span>
-358: <span class="ruby-keyword kw">end</span>
+ <span class="ruby-comment cmt"># File lib/selenium_on_rails/test_builder.rb, line 33</span>
+33: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">table</span> <span class="ruby-identifier">title</span>
+34: <span class="ruby-ivar">@xml</span>.<span class="ruby-identifier">table</span> <span class="ruby-keyword kw">do</span>
+35: <span class="ruby-ivar">@xml</span>.<span class="ruby-identifier">tr</span> <span class="ruby-keyword kw">do</span> <span class="ruby-ivar">@xml</span>.<span class="ruby-identifier">th</span>(<span class="ruby-identifier">title</span>, <span class="ruby-identifier">:colspan</span> =<span class="ruby-operator">></span> <span class="ruby-value">3</span>) <span class="ruby-keyword kw">end</span>
+36: <span class="ruby-keyword kw">yield</span> <span class="ruby-keyword kw">self</span>
+37: <span class="ruby-keyword kw">end</span>
+38: <span class="ruby-keyword kw">end</span>
</pre>
</div>
</div>
doc/classes/SeleniumOnRails/TestBuilder.html
@@ -55,8 +55,8 @@
<tr class="top-aligned-row">
<td><strong>In:</strong></td>
<td>
- <a href="../../files/lib/selenium_on_rails/test_builder_rb.html">
- lib/selenium_on_rails/test_builder.rb
+ <a href="../../files/lib/selenium_on_rails/test_builder_actions_rb.html">
+ lib/selenium_on_rails/test_builder_actions.rb
</a>
<br />
</td>
@@ -77,6 +77,10 @@
The actions available for <a
href="TestBuilder.html">SeleniumOnRails::TestBuilder</a> tests.
</p>
+<p>
+For each action <tt>foo</tt> there’s also an action
+<tt>foo_and_wait</tt>.
+</p>
</div>
@@ -87,24 +91,34 @@ href="TestBuilder.html">SeleniumOnRails::TestBuilder</a> tests.
<h3 class="section-bar">Methods</h3>
<div class="name-list">
- <a href="#M000064">answer_on_next_prompt</a>
- <a href="#M000063">choose_cancel_on_next_confirmation</a>
- <a href="#M000050">click</a>
- <a href="#M000055">close</a>
- <a href="#M000057">fire_event</a>
- <a href="#M000054">go_back</a>
- <a href="#M000048">include_partial</a>
- <a href="#M000049">open</a>
- <a href="#M000056">pause</a>
- <a href="#M000052">select</a>
- <a href="#M000053">select_window</a>
- <a href="#M000047">setup</a>
- <a href="#M000059">store</a>
- <a href="#M000062">store_attribute</a>
- <a href="#M000061">store_text</a>
- <a href="#M000060">store_value</a>
- <a href="#M000051">type</a>
- <a href="#M000058">wait_for_value</a>
+ <a href="#M000022">add_selection</a>
+ <a href="#M000029">answer_on_next_prompt</a>
+ <a href="#M000019">check</a>
+ <a href="#M000028">choose_cancel_on_next_confirmation</a>
+ <a href="#M000011">click</a>
+ <a href="#M000032">close</a>
+ <a href="#M000012">fire_event</a>
+ <a href="#M000030">go_back</a>
+ <a href="#M000010">include_partial</a>
+ <a href="#M000014">key_down</a>
+ <a href="#M000013">key_press</a>
+ <a href="#M000015">key_up</a>
+ <a href="#M000017">mouse_down</a>
+ <a href="#M000016">mouse_over</a>
+ <a href="#M000025">open</a>
+ <a href="#M000031">refresh</a>
+ <a href="#M000023">remove_selection</a>
+ <a href="#M000021">select</a>
+ <a href="#M000026">select_window</a>
+ <a href="#M000033">set_context</a>
+ <a href="#M000035">set_timeout</a>
+ <a href="#M000009">setup</a>
+ <a href="#M000024">submit</a>
+ <a href="#M000018">type</a>
+ <a href="#M000020">uncheck</a>
+ <a href="#M000034">wait_for_condition</a>
+ <a href="#M000036">wait_for_page_to_load</a>
+ <a href="#M000027">wait_for_popup</a>
</div>
</div>
@@ -126,172 +140,233 @@ href="TestBuilder.html">SeleniumOnRails::TestBuilder</a> tests.
<div id="methods">
<h3 class="section-bar">Public Instance methods</h3>
- <div id="method-M000064" class="method-detail">
- <a name="M000064"></a>
+ <div id="method-M000022" class="method-detail">
+ <a name="M000022"></a>
<div class="method-heading">
- <a href="#M000064" class="method-signature">
- <span class="method-name">answer_on_next_prompt</span><span class="method-args">(answer_string)</span>
+ <a href="#M000022" class="method-signature">
+ <span class="method-name">add_selection</span><span class="method-args">(locator, option_locator)</span>
</a>
</div>
<div class="method-description">
<p>
-Tell Selenium how to answer the next JavaScript prompt.
+Add a selection to the set of selected options in a multi-select element
+using an option locator.
+</p>
+<p>
+See the <tt><a href="TestBuilderActions.html#M000021">select</a></tt>
+command for more information about option locators.
</p>
<p><a class="source-toggle" href="#"
- onclick="toggleCode('M000064-source');return false;">[Source]</a></p>
- <div class="method-source-code" id="M000064-source">
+ onclick="toggleCode('M000022-source');return false;">[Source]</a></p>
+ <div class="method-source-code" id="M000022-source">
<pre>
- <span class="ruby-comment cmt"># File lib/selenium_on_rails/test_builder.rb, line 126</span>
-126: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">answer_on_next_prompt</span> <span class="ruby-identifier">answer_string</span>
-127: <span class="ruby-identifier">command</span> <span class="ruby-value str">'answerOnNextPrompt'</span>, <span class="ruby-identifier">answer_string</span>
-128: <span class="ruby-keyword kw">end</span>
+ <span class="ruby-comment cmt"># File lib/selenium_on_rails/test_builder_actions.rb, line 139</span>
+139: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">add_selection</span> <span class="ruby-identifier">locator</span>, <span class="ruby-identifier">option_locator</span>
+140: <span class="ruby-identifier">command</span> <span class="ruby-value str">'addSelection'</span>, <span class="ruby-identifier">locator</span>, <span class="ruby-identifier">option_locator</span>
+141: <span class="ruby-keyword kw">end</span>
</pre>
</div>
</div>
</div>
- <div id="method-M000063" class="method-detail">
- <a name="M000063"></a>
+ <div id="method-M000029" class="method-detail">
+ <a name="M000029"></a>
<div class="method-heading">
- <a href="#M000063" class="method-signature">
- <span class="method-name">choose_cancel_on_next_confirmation</span><span class="method-args">()</span>
+ <a href="#M000029" class="method-signature">
+ <span class="method-name">answer_on_next_prompt</span><span class="method-args">(answer)</span>
</a>
</div>
<div class="method-description">
<p>
-Tell Selenium to select "Cancel" the next time a confirmation
-dialog appears.
+Instructs Selenium to return the specified answer string in response to the
+next JavaScript prompt (<tt>window.prompt()</tt>).
</p>
<p><a class="source-toggle" href="#"
- onclick="toggleCode('M000063-source');return false;">[Source]</a></p>
- <div class="method-source-code" id="M000063-source">
+ onclick="toggleCode('M000029-source');return false;">[Source]</a></p>
+ <div class="method-source-code" id="M000029-source">
<pre>
- <span class="ruby-comment cmt"># File lib/selenium_on_rails/test_builder.rb, line 121</span>
-121: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">choose_cancel_on_next_confirmation</span>
-122: <span class="ruby-identifier">command</span> <span class="ruby-value str">'chooseCancelOnNextConfirmation'</span>
-123: <span class="ruby-keyword kw">end</span>
+ <span class="ruby-comment cmt"># File lib/selenium_on_rails/test_builder_actions.rb, line 190</span>
+190: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">answer_on_next_prompt</span> <span class="ruby-identifier">answer</span>
+191: <span class="ruby-identifier">command</span> <span class="ruby-value str">'answerOnNextPrompt'</span>, <span class="ruby-identifier">answer</span>
+192: <span class="ruby-keyword kw">end</span>
</pre>
</div>
</div>
</div>
- <div id="method-M000050" class="method-detail">
- <a name="M000050"></a>
+ <div id="method-M000019" class="method-detail">
+ <a name="M000019"></a>
<div class="method-heading">
- <a href="#M000050" class="method-signature">
- <span class="method-name">click</span><span class="method-args">(element_locator, options={})</span>
+ <a href="#M000019" class="method-signature">
+ <span class="method-name">check</span><span class="method-args">(locator)</span>
</a>
</div>
<div class="method-description">
<p>
-Click on the specified element. Supports a <tt>:wait => true</tt>
-option.
+Check a toggle-button (checkbox/radio).
</p>
<p><a class="source-toggle" href="#"
- onclick="toggleCode('M000050-source');return false;">[Source]</a></p>
- <div class="method-source-code" id="M000050-source">
+ onclick="toggleCode('M000019-source');return false;">[Source]</a></p>
+ <div class="method-source-code" id="M000019-source">
<pre>
- <span class="ruby-comment cmt"># File lib/selenium_on_rails/test_builder.rb, line 48</span>
-48: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">click</span> <span class="ruby-identifier">element_locator</span>, <span class="ruby-identifier">options</span>={}
-49: <span class="ruby-identifier">command</span> <span class="ruby-identifier">name_with_optional_wait</span>(<span class="ruby-value str">'click'</span>, <span class="ruby-identifier">options</span>), <span class="ruby-identifier">element_locator</span>
-50: <span class="ruby-keyword kw">end</span>
+ <span class="ruby-comment cmt"># File lib/selenium_on_rails/test_builder_actions.rb, line 99</span>
+ 99: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">check</span> <span class="ruby-identifier">locator</span>
+100: <span class="ruby-identifier">command</span> <span class="ruby-value str">'check'</span>, <span class="ruby-identifier">locator</span>
+101: <span class="ruby-keyword kw">end</span>
</pre>
</div>
</div>
</div>
- <div id="method-M000055" class="method-detail">
- <a name="M000055"></a>
+ <div id="method-M000028" class="method-detail">
+ <a name="M000028"></a>
<div class="method-heading">
- <a href="#M000055" class="method-signature">
- <span class="method-name">close</span><span class="method-args">()</span>
+ <a href="#M000028" class="method-signature">
+ <span class="method-name">choose_cancel_on_next_confirmation</span><span class="method-args">()</span>
+ </a>
+ </div>
+
+ <div class="method-description">
+ <p>
+By default, Selenium’s overridden <tt>window.confirm()</tt> function
+will return <tt>true</tt>, as if the user had manually clicked OK. After
+running this command, the next call to <tt>confirm()</tt> will return
+<tt>false</tt>, as if the user had clicked Cancel.
+</p>
+ <p><a class="source-toggle" href="#"
+ onclick="toggleCode('M000028-source');return false;">[Source]</a></p>
+ <div class="method-source-code" id="M000028-source">
+<pre>
+ <span class="ruby-comment cmt"># File lib/selenium_on_rails/test_builder_actions.rb, line 184</span>
+184: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">choose_cancel_on_next_confirmation</span>
+185: <span class="ruby-identifier">command</span> <span class="ruby-value str">'chooseCancelOnNextConfirmation'</span>
+186: <span class="ruby-keyword kw">end</span>
+</pre>
+ </div>
+ </div>
+ </div>
+
+ <div id="method-M000011" class="method-detail">
+ <a name="M000011"></a>
+
+ <div class="method-heading">
+ <a href="#M000011" class="method-signature">
+ <span class="method-name">click</span><span class="method-args">(locator)</span>
</a>
</div>
<div class="method-description">
<p>
-Close the current window.
+Clicks on a link, button, checkbox or radio button. If the click action
+causes a new page to load (like a link usually does), call <tt><a
+href="TestBuilderActions.html#M000036">wait_for_page_to_load</a></tt>.
</p>
<p><a class="source-toggle" href="#"
- onclick="toggleCode('M000055-source');return false;">[Source]</a></p>
- <div class="method-source-code" id="M000055-source">
+ onclick="toggleCode('M000011-source');return false;">[Source]</a></p>
+ <div class="method-source-code" id="M000011-source">
<pre>
- <span class="ruby-comment cmt"># File lib/selenium_on_rails/test_builder.rb, line 78</span>
-78: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">close</span>
-79: <span class="ruby-identifier">command</span> <span class="ruby-value str">'close'</span>
-80: <span class="ruby-keyword kw">end</span>
+ <span class="ruby-comment cmt"># File lib/selenium_on_rails/test_builder_actions.rb, line 44</span>
+44: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">click</span> <span class="ruby-identifier">locator</span>
+45: <span class="ruby-identifier">command</span> <span class="ruby-value str">'click'</span>, <span class="ruby-identifier">locator</span>
+46: <span class="ruby-keyword kw">end</span>
</pre>
</div>
</div>
</div>
- <div id="method-M000057" class="method-detail">
- <a name="M000057"></a>
+ <div id="method-M000032" class="method-detail">
+ <a name="M000032"></a>
<div class="method-heading">
- <a href="#M000057" class="method-signature">
- <span class="method-name">fire_event</span><span class="method-args">(element_locator, event_name)</span>
+ <a href="#M000032" class="method-signature">
+ <span class="method-name">close</span><span class="method-args">()</span>
</a>
</div>
<div class="method-description">
<p>
-Send an event to an element.
+Simulates the user clicking the "close" button in the titlebar of
+a popup window or tab.
</p>
+ <p><a class="source-toggle" href="#"
+ onclick="toggleCode('M000032-source');return false;">[Source]</a></p>
+ <div class="method-source-code" id="M000032-source">
<pre>
- fire_event 'password', 'focus'
+ <span class="ruby-comment cmt"># File lib/selenium_on_rails/test_builder_actions.rb, line 206</span>
+206: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">close</span>
+207: <span class="ruby-identifier">command</span> <span class="ruby-value str">'close'</span>
+208: <span class="ruby-keyword kw">end</span>
</pre>
+ </div>
+ </div>
+ </div>
+
+ <div id="method-M000012" class="method-detail">
+ <a name="M000012"></a>
+
+ <div class="method-heading">
+ <a href="#M000012" class="method-signature">
+ <span class="method-name">fire_event</span><span class="method-args">(locator, event_name)</span>
+ </a>
+ </div>
+
+ <div class="method-description">
+ <p>
+Explicitly simulate an event (e.g. <tt>"focus"</tt>,
+<tt>"blur"</tt>), to trigger the corresponding
+<tt>"on_event_"</tt> handler.
+</p>
<p><a class="source-toggle" href="#"
- onclick="toggleCode('M000057-source');return false;">[Source]</a></p>
- <div class="method-source-code" id="M000057-source">
+ onclick="toggleCode('M000012-source');return false;">[Source]</a></p>
+ <div class="method-source-code" id="M000012-source">
<pre>
- <span class="ruby-comment cmt"># File lib/selenium_on_rails/test_builder.rb, line 89</span>
-89: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">fire_event</span> <span class="ruby-identifier">element_locator</span>, <span class="ruby-identifier">event_name</span>
-90: <span class="ruby-identifier">command</span> <span class="ruby-value str">'fireEvent'</span>, <span class="ruby-identifier">element_locator</span>, <span class="ruby-identifier">event_name</span>
-91: <span class="ruby-keyword kw">end</span>
+ <span class="ruby-comment cmt"># File lib/selenium_on_rails/test_builder_actions.rb, line 50</span>
+50: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">fire_event</span> <span class="ruby-identifier">locator</span>, <span class="ruby-identifier">event_name</span>
+51: <span class="ruby-identifier">command</span> <span class="ruby-value str">'fireEvent'</span>, <span class="ruby-identifier">locator</span>, <span class="ruby-identifier">event_name</span>
+52: <span class="ruby-keyword kw">end</span>
</pre>
</div>
</div>
</div>
- <div id="method-M000054" class="method-detail">
- <a name="M000054"></a>
+ <div id="method-M000030" class="method-detail">
+ <a name="M000030"></a>
<div class="method-heading">
- <a href="#M000054" class="method-signature">
+ <a href="#M000030" class="method-signature">
<span class="method-name">go_back</span><span class="method-args">()</span>
</a>
</div>
<div class="method-description">
<p>
-Simulate selecting the "Back" button.
+Simulates the user clicking the "back" button on their browser.
</p>
<p><a class="source-toggle" href="#"
- onclick="toggleCode('M000054-source');return false;">[Source]</a></p>
- <div class="method-source-code" id="M000054-source">
+ onclick="toggleCode('M000030-source');return false;">[Source]</a></p>
+ <div class="method-source-code" id="M000030-source">
<pre>
- <span class="ruby-comment cmt"># File lib/selenium_on_rails/test_builder.rb, line 73</span>
-73: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">go_back</span>
-74: <span class="ruby-identifier">command</span> <span class="ruby-value str">'goBack'</span>
-75: <span class="ruby-keyword kw">end</span>
+ <span class="ruby-comment cmt"># File lib/selenium_on_rails/test_builder_actions.rb, line 195</span>
+195: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">go_back</span>
+196: <span class="ruby-identifier">command</span> <span class="ruby-value str">'goBack'</span>
+197: <span class="ruby-keyword kw">end</span>
</pre>
</div>
</div>
</div>
- <div id="method-M000048" class="method-detail">
- <a name="M000048"></a>
+ <div id="method-M000010" class="method-detail">
+ <a name="M000010"></a>
<div class="method-heading">
- <a href="#M000048" class="method-signature">
+ <a href="#M000010" class="method-signature">
<span class="method-name">include_partial</span><span class="method-args">(path, local_assigns = {})</span>
</a>
</div>
@@ -299,7 +374,7 @@ Simulate selecting the "Back" button.
<div class="method-description">
<p>
Includes a partial. The path is relative to the Selenium tests root. The
-starting _ and the file extension doesn’t have to be specified.
+starting _ and the file extension don’t have to be specified.
</p>
<pre>
#include test/selenium/_partial.*
@@ -310,137 +385,422 @@ starting _ and the file extension doesn’t have to be specified.
include_partial 'suite/partial', :foo => bar
</pre>
<p><a class="source-toggle" href="#"
- onclick="toggleCode('M000048-source');return false;">[Source]</a></p>
- <div class="method-source-code" id="M000048-source">
+ onclick="toggleCode('M000010-source');return false;">[Source]</a></p>
+ <div class="method-source-code" id="M000010-source">
+<pre>
+ <span class="ruby-comment cmt"># File lib/selenium_on_rails/test_builder_actions.rb, line 36</span>
+36: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">include_partial</span> <span class="ruby-identifier">path</span>, <span class="ruby-identifier">local_assigns</span> = {}
+37: <span class="ruby-identifier">partial</span> = <span class="ruby-ivar">@view</span>.<span class="ruby-identifier">render</span> <span class="ruby-identifier">:partial</span> =<span class="ruby-operator">></span> <span class="ruby-identifier">path</span>, <span class="ruby-identifier">:locals</span> =<span class="ruby-operator">></span> <span class="ruby-identifier">local_assigns</span>
+38: <span class="ruby-ivar">@output</span> <span class="ruby-operator"><<</span> <span class="ruby-identifier">partial</span>
+39: <span class="ruby-keyword kw">end</span>
+</pre>
+ </div>
+ </div>
+ </div>
+
+ <div id="method-M000014" class="method-detail">
+ <a name="M000014"></a>
+
+ <div class="method-heading">
+ <a href="#M000014" class="method-signature">
+ <span class="method-name">key_down</span><span class="method-args">(locator, keycode)</span>
+ </a>
+ </div>
+
+ <div class="method-description">
+ <p>
+Simulates a user pressing a key (without releasing it yet).
+</p>
+<p>
+<tt>keycode</tt> is the numeric keycode of the key to be pressed, normally
+the ASCII value of that key.
+</p>
+ <p><a class="source-toggle" href="#"
+ onclick="toggleCode('M000014-source');return false;">[Source]</a></p>
+ <div class="method-source-code" id="M000014-source">
+<pre>
+ <span class="ruby-comment cmt"># File lib/selenium_on_rails/test_builder_actions.rb, line 66</span>
+66: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">key_down</span> <span class="ruby-identifier">locator</span>, <span class="ruby-identifier">keycode</span>
+67: <span class="ruby-identifier">command</span> <span class="ruby-value str">'keyDown'</span>, <span class="ruby-identifier">locator</span>, <span class="ruby-identifier">keycode</span>
+68: <span class="ruby-keyword kw">end</span>
+</pre>
+ </div>
+ </div>
+ </div>
+
+ <div id="method-M000013" class="method-detail">
+ <a name="M000013"></a>
+
+ <div class="method-heading">
+ <a href="#M000013" class="method-signature">
+ <span class="method-name">key_press</span><span class="method-args">(locator, keycode)</span>
+ </a>
+ </div>
+
+ <div class="method-description">
+ <p>
+Simulates a user pressing and releasing a key.
+</p>
+<p>
+<tt>keycode</tt> is the numeric keycode of the key to be pressed, normally
+the ASCII value of that key.
+</p>
+ <p><a class="source-toggle" href="#"
+ onclick="toggleCode('M000013-source');return false;">[Source]</a></p>
+ <div class="method-source-code" id="M000013-source">
+<pre>
+ <span class="ruby-comment cmt"># File lib/selenium_on_rails/test_builder_actions.rb, line 58</span>
+58: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">key_press</span> <span class="ruby-identifier">locator</span>, <span class="ruby-identifier">keycode</span>
+59: <span class="ruby-identifier">command</span> <span class="ruby-value str">'keyPress'</span>, <span class="ruby-identifier">locator</span>, <span class="ruby-identifier">keycode</span>
+60: <span class="ruby-keyword kw">end</span>
+</pre>
+ </div>
+ </div>
+ </div>
+
+ <div id="method-M000015" class="method-detail">
+ <a name="M000015"></a>
+
+ <div class="method-heading">
+ <a href="#M000015" class="method-signature">
+ <span class="method-name">key_up</span><span class="method-args">(locator, keycode)</span>
+ </a>
+ </div>
+
+ <div class="method-description">
+ <p>
+Simulates a user releasing a key.
+</p>
+<p>
+<tt>keycode</tt> is the numeric keycode of the key to be released, normally
+the ASCII value of that key.
+</p>
+ <p><a class="source-toggle" href="#"
+ onclick="toggleCode('M000015-source');return false;">[Source]</a></p>
+ <div class="method-source-code" id="M000015-source">
+<pre>
+ <span class="ruby-comment cmt"># File lib/selenium_on_rails/test_builder_actions.rb, line 74</span>
+74: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">key_up</span> <span class="ruby-identifier">locator</span>, <span class="ruby-identifier">keycode</span>
+75: <span class="ruby-identifier">command</span> <span class="ruby-value str">'keyUp'</span>, <span class="ruby-identifier">locator</span>, <span class="ruby-identifier">keycode</span>
+76: <span class="ruby-keyword kw">end</span>
+</pre>
+ </div>
+ </div>
+ </div>
+
+ <div id="method-M000017" class="method-detail">
+ <a name="M000017"></a>
+
+ <div class="method-heading">
+ <a href="#M000017" class="method-signature">
+ <span class="method-name">mouse_down</span><span class="method-args">(locator)</span>
+ </a>
+ </div>
+
+ <div class="method-description">
+ <p>
+Simulates a user pressing the mouse button (without releasing it yet) on
+the specified element.
+</p>
+ <p><a class="source-toggle" href="#"
+ onclick="toggleCode('M000017-source');return false;">[Source]</a></p>
+ <div class="method-source-code" id="M000017-source">
+<pre>
+ <span class="ruby-comment cmt"># File lib/selenium_on_rails/test_builder_actions.rb, line 85</span>
+85: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">mouse_down</span> <span class="ruby-identifier">locator</span>
+86: <span class="ruby-identifier">command</span> <span class="ruby-value str">'mouseDown'</span>, <span class="ruby-identifier">locator</span>
+87: <span class="ruby-keyword kw">end</span>
+</pre>
+ </div>
+ </div>
+ </div>
+
+ <div id="method-M000016" class="method-detail">
+ <a name="M000016"></a>
+
+ <div class="method-heading">
+ <a href="#M000016" class="method-signature">
+ <span class="method-name">mouse_over</span><span class="method-args">(locator)</span>
+ </a>
+ </div>
+
+ <div class="method-description">
+ <p>
+Simulates a user hovering a mouse over the specified element.
+</p>
+ <p><a class="source-toggle" href="#"
+ onclick="toggleCode('M000016-source');return false;">[Source]</a></p>
+ <div class="method-source-code" id="M000016-source">
<pre>
- <span class="ruby-comment cmt"># File lib/selenium_on_rails/test_builder.rb, line 33</span>
-33: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">include_partial</span> <span class="ruby-identifier">path</span>, <span class="ruby-identifier">local_assigns</span> = {}
-34: <span class="ruby-identifier">partial</span> = <span class="ruby-ivar">@view</span>.<span class="ruby-identifier">render</span> <span class="ruby-identifier">:partial</span> =<span class="ruby-operator">></span> <span class="ruby-identifier">path</span>, <span class="ruby-identifier">:locals</span> =<span class="ruby-operator">></span> <span class="ruby-identifier">local_assigns</span>
-35: <span class="ruby-ivar">@output</span> <span class="ruby-operator"><<</span> <span class="ruby-identifier">partial</span>
-36: <span class="ruby-keyword kw">end</span>
+ <span class="ruby-comment cmt"># File lib/selenium_on_rails/test_builder_actions.rb, line 79</span>
+79: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">mouse_over</span> <span class="ruby-identifier">locator</span>
+80: <span class="ruby-identifier">command</span> <span class="ruby-value str">'mouseOver'</span>, <span class="ruby-identifier">locator</span>
+81: <span class="ruby-keyword kw">end</span>
</pre>
</div>
</div>
</div>
- <div id="method-M000049" class="method-detail">
- <a name="M000049"></a>
+ <div id="method-M000025" class="method-detail">
+ <a name="M000025"></a>
<div class="method-heading">
- <a href="#M000049" class="method-signature">
+ <a href="#M000025" class="method-signature">
<span class="method-name">open</span><span class="method-args">(url)</span>
</a>
</div>
<div class="method-description">
<p>
-Open the page specified by <tt>url</tt> and wait. The <tt>url</tt> may
-either by a string, or arguments suitable for
-<tt>ActionView::UrlHelper#url_for</tt>.
+Opens an URL in the test frame. This accepts both relative and absolute
+URLs. The <tt>open</tt> command waits for the page to load before
+proceeding, i.e. you don’t have to call <tt><a
+href="TestBuilderActions.html#M000036">wait_for_page_to_load</a></tt>.
</p>
+<p>
+Note: The URL must be on the same domain as the runner HTML due to security
+restrictions in the browser (Same Origin Policy).
+</p>
+ <p><a class="source-toggle" href="#"
+ onclick="toggleCode('M000025-source');return false;">[Source]</a></p>
+ <div class="method-source-code" id="M000025-source">
<pre>
- open '/'
- open :controller => 'customer', :action => 'list'
+ <span class="ruby-comment cmt"># File lib/selenium_on_rails/test_builder_actions.rb, line 163</span>
+163: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">open</span> <span class="ruby-identifier">url</span>
+164: <span class="ruby-identifier">command</span> <span class="ruby-value str">'open'</span>, <span class="ruby-identifier">url_arg</span>(<span class="ruby-identifier">url</span>)
+165: <span class="ruby-keyword kw">end</span>
</pre>
+ </div>
+ </div>
+ </div>
+
+ <div id="method-M000031" class="method-detail">
+ <a name="M000031"></a>
+
+ <div class="method-heading">
+ <a href="#M000031" class="method-signature">
+ <span class="method-name">refresh</span><span class="method-args">()</span>
+ </a>
+ </div>
+
+ <div class="method-description">
+ <p>
+Simulates the user clicking the "Refresh" button on their
+browser.
+</p>
<p><a class="source-toggle" href="#"
- onclick="toggleCode('M000049-source');return false;">[Source]</a></p>
- <div class="method-source-code" id="M000049-source">
+ onclick="toggleCode('M000031-source');return false;">[Source]</a></p>
+ <div class="method-source-code" id="M000031-source">
<pre>
- <span class="ruby-comment cmt"># File lib/selenium_on_rails/test_builder.rb, line 42</span>
-42: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">open</span> <span class="ruby-identifier">url</span>
-43: <span class="ruby-identifier">command</span> <span class="ruby-value str">'open'</span>, <span class="ruby-identifier">url_arg</span>(<span class="ruby-identifier">url</span>)
-44: <span class="ruby-keyword kw">end</span>
+ <span class="ruby-comment cmt"># File lib/selenium_on_rails/test_builder_actions.rb, line 200</span>
+200: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">refresh</span>
+201: <span class="ruby-identifier">command</span> <span class="ruby-value str">'refresh'</span>
+202: <span class="ruby-keyword kw">end</span>
</pre>
</div>
</div>
</div>
- <div id="method-M000056" class="method-detail">
- <a name="M000056"></a>
+ <div id="method-M000023" class="method-detail">
+ <a name="M000023"></a>
<div class="method-heading">
- <a href="#M000056" class="method-signature">
- <span class="method-name">pause</span><span class="method-args">(milliseconds)</span>
+ <a href="#M000023" class="method-signature">
+ <span class="method-name">remove_selection</span><span class="method-args">(locator, option_locator)</span>
</a>
</div>
<div class="method-description">
<p>
-Wait for <tt>milliseconds</tt>.
+Remove a selection from the set of selected options in a multi-select
+element using an option locator.
+</p>
+<p>
+See the <tt>select</tt> command for more information about option locators.
</p>
<p><a class="source-toggle" href="#"
- onclick="toggleCode('M000056-source');return false;">[Source]</a></p>
- <div class="method-source-code" id="M000056-source">
+ onclick="toggleCode('M000023-source');return false;">[Source]</a></p>
+ <div class="method-source-code" id="M000023-source">
<pre>
- <span class="ruby-comment cmt"># File lib/selenium_on_rails/test_builder.rb, line 83</span>
-83: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">pause</span> <span class="ruby-identifier">milliseconds</span>
-84: <span class="ruby-identifier">command</span> <span class="ruby-value str">'pause'</span>, <span class="ruby-identifier">milliseconds</span>
-85: <span class="ruby-keyword kw">end</span>
+ <span class="ruby-comment cmt"># File lib/selenium_on_rails/test_builder_actions.rb, line 147</span>
+147: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">remove_selection</span> <span class="ruby-identifier">locator</span>, <span class="ruby-identifier">option_locator</span>
+148: <span class="ruby-identifier">command</span> <span class="ruby-value str">'removeSelection'</span>, <span class="ruby-identifier">locator</span>, <span class="ruby-identifier">option_locator</span>
+149: <span class="ruby-keyword kw">end</span>
</pre>
</div>
</div>
</div>
- <div id="method-M000052" class="method-detail">
- <a name="M000052"></a>
+ <div id="method-M000021" class="method-detail">
+ <a name="M000021"></a>
<div class="method-heading">
- <a href="#M000052" class="method-signature">
- <span class="method-name">select</span><span class="method-args">(drop_down_locator, option_specifier, options={})</span>
+ <a href="#M000021" class="method-signature">
+ <span class="method-name">select</span><span class="method-args">(locator, option_locator)</span>
</a>
</div>
<div class="method-description">
<p>
-Select an option from a <tt>select</tt> menu. Supports a <tt>:wait =>
-true</tt> option.
+Select an option from a drop-down using an option locator.
+</p>
+<p>
+Option locators provide different ways of specifying options of an HTML
+Select element (e.g. for selecting a specific option, or for asserting that
+the selected option satisfies a specification). There are several forms of
+Select Option Locator.
+</p>
+<ul>
+<li>label=labelPattern matches options based on their labels, i.e. the visible
+text. (This is the default.)
+
+<pre>
+ label=regexp:^[Oo]ther
+</pre>
+</li>
+<li>value=valuePattern matches options based on their values.
+
+<pre>
+ value=other
+</pre>
+</li>
+<li>id=id matches options based on their ids.
+
+<pre>
+ id=option1
+</pre>
+</li>
+<li>index=index matches an option based on its index (offset from zero).
+
+<pre>
+ index=2
+</pre>
+</li>
+</ul>
+<p>
+If no option locator prefix is provided, the default behaviour is to match
+on label.
</p>
<p><a class="source-toggle" href="#"
- onclick="toggleCode('M000052-source');return false;">[Source]</a></p>
- <div class="method-source-code" id="M000052-source">
+ onclick="toggleCode('M000021-source');return false;">[Source]</a></p>
+ <div class="method-source-code" id="M000021-source">
<pre>
- <span class="ruby-comment cmt"># File lib/selenium_on_rails/test_builder.rb, line 61</span>
-61: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">select</span> <span class="ruby-identifier">drop_down_locator</span>, <span class="ruby-identifier">option_specifier</span>, <span class="ruby-identifier">options</span>={}
-62: <span class="ruby-identifier">command</span>(<span class="ruby-identifier">name_with_optional_wait</span>(<span class="ruby-value str">'select'</span>, <span class="ruby-identifier">options</span>), <span class="ruby-identifier">drop_down_locator</span>,
-63: <span class="ruby-identifier">option_specifier</span>)
-64: <span class="ruby-keyword kw">end</span>
+ <span class="ruby-comment cmt"># File lib/selenium_on_rails/test_builder_actions.rb, line 131</span>
+131: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">select</span> <span class="ruby-identifier">locator</span>, <span class="ruby-identifier">option_locator</span>
+132: <span class="ruby-identifier">command</span> <span class="ruby-value str">'select'</span>, <span class="ruby-identifier">locator</span>, <span class="ruby-identifier">option_locator</span>
+133: <span class="ruby-keyword kw">end</span>
</pre>
</div>
</div>
</div>
- <div id="method-M000053" class="method-detail">
- <a name="M000053"></a>
+ <div id="method-M000026" class="method-detail">
+ <a name="M000026"></a>
<div class="method-heading">
- <a href="#M000053" class="method-signature">
+ <a href="#M000026" class="method-signature">
<span class="method-name">select_window</span><span class="method-args">(window_id)</span>
</a>
</div>
<div class="method-description">
<p>
-Select a popup window by name, and send further commands to it. If
-<tt>window_id</tt> is <tt>nil</tt>, select the main window.
+Selects a popup window; once a popup window has been selected, all commands
+go to that window. To select the main window again, use <tt>nil</tt> as the
+target.
</p>
<p><a class="source-toggle" href="#"
- onclick="toggleCode('M000053-source');return false;">[Source]</a></p>
- <div class="method-source-code" id="M000053-source">
+ onclick="toggleCode('M000026-source');return false;">[Source]</a></p>
+ <div class="method-source-code" id="M000026-source">
<pre>
- <span class="ruby-comment cmt"># File lib/selenium_on_rails/test_builder.rb, line 68</span>
-68: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">select_window</span> <span class="ruby-identifier">window_id</span>
-69: <span class="ruby-identifier">command</span> <span class="ruby-value str">'selectWindow'</span>, <span class="ruby-identifier">window_id</span><span class="ruby-operator">||</span><span class="ruby-value str">'null'</span>
-70: <span class="ruby-keyword kw">end</span>
+ <span class="ruby-comment cmt"># File lib/selenium_on_rails/test_builder_actions.rb, line 169</span>
+169: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">select_window</span> <span class="ruby-identifier">window_id</span>
+170: <span class="ruby-identifier">command</span> <span class="ruby-value str">'selectWindow'</span>, <span class="ruby-identifier">window_id</span><span class="ruby-operator">||</span><span class="ruby-value str">'null'</span>
+171: <span class="ruby-keyword kw">end</span>
</pre>
</div>
</div>
</div>
- <div id="method-M000047" class="method-detail">
- <a name="M000047"></a>
+ <div id="method-M000033" class="method-detail">
+ <a name="M000033"></a>
<div class="method-heading">
- <a href="#M000047" class="method-signature">
+ <a href="#M000033" class="method-signature">
+ <span class="method-name">set_context</span><span class="method-args">(context, log_level_threshold = nil)</span>
+ </a>
+ </div>
+
+ <div class="method-description">
+ <p>
+Writes a message to the status bar and adds a note to the browser-side log.
+</p>
+<p>
+<tt>context</tt> is the message sent to the browser.
+</p>
+<p>
+<tt>log_level_threshold</tt> can be <tt>nil</tt>, <tt>:debug</tt>,
+<tt>:info</tt>, <tt>:warn</tt> or <tt>:error</tt>.
+</p>
+ <p><a class="source-toggle" href="#"
+ onclick="toggleCode('M000033-source');return false;">[Source]</a></p>
+ <div class="method-source-code" id="M000033-source">
+<pre>
+ <span class="ruby-comment cmt"># File lib/selenium_on_rails/test_builder_actions.rb, line 216</span>
+216: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">set_context</span> <span class="ruby-identifier">context</span>, <span class="ruby-identifier">log_level_threshold</span> = <span class="ruby-keyword kw">nil</span>
+217: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">log_level_threshold</span>
+218: <span class="ruby-identifier">command</span> <span class="ruby-value str">'setContext'</span>, <span class="ruby-identifier">context</span>, <span class="ruby-identifier">log_level_threshold</span>.<span class="ruby-identifier">to_s</span>
+219: <span class="ruby-keyword kw">else</span>
+220: <span class="ruby-identifier">command</span> <span class="ruby-value str">'setContext'</span>, <span class="ruby-identifier">context</span>
+221: <span class="ruby-keyword kw">end</span>
+222: <span class="ruby-keyword kw">end</span>
+</pre>
+ </div>
+ </div>
+ </div>
+
+ <div id="method-M000035" class="method-detail">
+ <a name="M000035"></a>
+
+ <div class="method-heading">
+ <a href="#M000035" class="method-signature">
+ <span class="method-name">set_timeout</span><span class="method-args">(timeout)</span>
+ </a>
+ </div>
+
+ <div class="method-description">
+ <p>
+Specifies the amount of time that Selenium will wait for actions to
+complete.
+</p>
+<p>
+Actions that require waiting include <tt>open</tt> and the
+<tt>wait_for*</tt> actions.
+</p>
+<p>
+The default timeout is 30 seconds.
+</p>
+<p>
+<tt>timeout</tt> is specified in milliseconds.
+</p>
+ <p><a class="source-toggle" href="#"
+ onclick="toggleCode('M000035-source');return false;">[Source]</a></p>
+ <div class="method-source-code" id="M000035-source">
+<pre>
+ <span class="ruby-comment cmt"># File lib/selenium_on_rails/test_builder_actions.rb, line 248</span>
+248: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">set_timeout</span> <span class="ruby-identifier">timeout</span>
+249: <span class="ruby-identifier">command</span> <span class="ruby-value str">'setTimeout'</span>, <span class="ruby-identifier">timeout</span>
+250: <span class="ruby-keyword kw">end</span>
+</pre>
+ </div>
+ </div>
+ </div>
+
+ <div id="method-M000009" class="method-detail">
+ <a name="M000009"></a>
+
+ <div class="method-heading">
+ <a href="#M000009" class="method-signature">
<span class="method-name">setup</span><span class="method-args">(options = {})</span>
</a>
</div>
@@ -458,182 +818,215 @@ CALL THIS AGAINST NON-TEST DATABASES. The supported <tt>options</tt> are
setup :keep_session, :fixtures => [:foo, :bar]
</pre>
<p><a class="source-toggle" href="#"
- onclick="toggleCode('M000047-source');return false;">[Source]</a></p>
- <div class="method-source-code" id="M000047-source">
-<pre>
- <span class="ruby-comment cmt"># File lib/selenium_on_rails/test_builder.rb, line 10</span>
-10: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">setup</span> <span class="ruby-identifier">options</span> = {}
-11: <span class="ruby-identifier">options</span> = {<span class="ruby-identifier">options</span> =<span class="ruby-operator">></span> <span class="ruby-keyword kw">nil</span>} <span class="ruby-keyword kw">unless</span> <span class="ruby-identifier">options</span>.<span class="ruby-identifier">is_a?</span> <span class="ruby-constant">Hash</span>
-12:
-13: <span class="ruby-identifier">opts</span> = {<span class="ruby-identifier">:controller</span> =<span class="ruby-operator">></span> <span class="ruby-value str">'selenium'</span>, <span class="ruby-identifier">:action</span> =<span class="ruby-operator">></span> <span class="ruby-value str">'setup'</span>}
-14: <span class="ruby-identifier">opts</span>[<span class="ruby-identifier">:keep_session</span>] = <span class="ruby-keyword kw">true</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">options</span>.<span class="ruby-identifier">has_key?</span> <span class="ruby-identifier">:keep_session</span>
-15:
-16: <span class="ruby-keyword kw">if</span> (<span class="ruby-identifier">f</span> = <span class="ruby-identifier">options</span>[<span class="ruby-identifier">:fixtures</span>])
-17: <span class="ruby-identifier">f</span> = [<span class="ruby-identifier">f</span>] <span class="ruby-keyword kw">unless</span> <span class="ruby-identifier">f</span>.<span class="ruby-identifier">is_a?</span> <span class="ruby-constant">Array</span>
-18: <span class="ruby-identifier">opts</span>[<span class="ruby-identifier">:fixtures</span>] = <span class="ruby-identifier">f</span>.<span class="ruby-identifier">join</span> <span class="ruby-value str">','</span>
-19: <span class="ruby-keyword kw">end</span>
-20:
-21: <span class="ruby-identifier">open</span> <span class="ruby-identifier">opts</span>
-22: <span class="ruby-keyword kw">end</span>
+ onclick="toggleCode('M000009-source');return false;">[Source]</a></p>
+ <div class="method-source-code" id="M000009-source">
+<pre>
+ <span class="ruby-comment cmt"># File lib/selenium_on_rails/test_builder_actions.rb, line 13</span>
+13: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">setup</span> <span class="ruby-identifier">options</span> = {}
+14: <span class="ruby-identifier">options</span> = {<span class="ruby-identifier">options</span> =<span class="ruby-operator">></span> <span class="ruby-keyword kw">nil</span>} <span class="ruby-keyword kw">unless</span> <span class="ruby-identifier">options</span>.<span class="ruby-identifier">is_a?</span> <span class="ruby-constant">Hash</span>
+15:
+16: <span class="ruby-identifier">opts</span> = {<span class="ruby-identifier">:controller</span> =<span class="ruby-operator">></span> <span class="ruby-value str">'selenium'</span>, <span class="ruby-identifier">:action</span> =<span class="ruby-operator">></span> <span class="ruby-value str">'setup'</span>}
+17: <span class="ruby-identifier">opts</span>[<span class="ruby-identifier">:keep_session</span>] = <span class="ruby-keyword kw">true</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">options</span>.<span class="ruby-identifier">has_key?</span> <span class="ruby-identifier">:keep_session</span>
+18:
+19: <span class="ruby-keyword kw">if</span> (<span class="ruby-identifier">f</span> = <span class="ruby-identifier">options</span>[<span class="ruby-identifier">:fixtures</span>])
+20: <span class="ruby-identifier">f</span> = [<span class="ruby-identifier">f</span>] <span class="ruby-keyword kw">unless</span> <span class="ruby-identifier">f</span>.<span class="ruby-identifier">is_a?</span> <span class="ruby-constant">Array</span>
+21: <span class="ruby-identifier">opts</span>[<span class="ruby-identifier">:fixtures</span>] = <span class="ruby-identifier">f</span>.<span class="ruby-identifier">join</span> <span class="ruby-value str">','</span>
+22: <span class="ruby-keyword kw">end</span>
+23:
+24: <span class="ruby-identifier">open</span> <span class="ruby-identifier">opts</span>
+25: <span class="ruby-keyword kw">end</span>
</pre>
</div>
</div>
</div>
- <div id="method-M000059" class="method-detail">
- <a name="M000059"></a>
+ <div id="method-M000024" class="method-detail">
+ <a name="M000024"></a>
<div class="method-heading">
- <a href="#M000059" class="method-signature">
- <span class="method-name">store</span><span class="method-args">(value_to_store, variable_name)</span>
+ <a href="#M000024" class="method-signature">
+ <span class="method-name">submit</span><span class="method-args">(locator)</span>
</a>
</div>
<div class="method-description">
<p>
-Store a value into a Selenium value.
+Submit the specified form. This is particularly useful for forms without
+submit buttons, e.g. single-input "Search" forms.
</p>
<p><a class="source-toggle" href="#"
- onclick="toggleCode('M000059-source');return false;">[Source]</a></p>
- <div class="method-source-code" id="M000059-source">
+ onclick="toggleCode('M000024-source');return false;">[Source]</a></p>
+ <div class="method-source-code" id="M000024-source">
<pre>
- <span class="ruby-comment cmt"># File lib/selenium_on_rails/test_builder.rb, line 99</span>
- 99: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">store</span> <span class="ruby-identifier">value_to_store</span>, <span class="ruby-identifier">variable_name</span>
-100: <span class="ruby-identifier">command</span> <span class="ruby-value str">'store'</span>, <span class="ruby-identifier">value_to_store</span>, <span class="ruby-identifier">variable_name</span>
-101: <span class="ruby-keyword kw">end</span>
+ <span class="ruby-comment cmt"># File lib/selenium_on_rails/test_builder_actions.rb, line 153</span>
+153: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">submit</span> <span class="ruby-identifier">locator</span>
+154: <span class="ruby-identifier">command</span> <span class="ruby-value str">'submit'</span>, <span class="ruby-identifier">locator</span>
+155: <span class="ruby-keyword kw">end</span>
</pre>
</div>
</div>
</div>
- <div id="method-M000062" class="method-detail">
- <a name="M000062"></a>
+ <div id="method-M000018" class="method-detail">
+ <a name="M000018"></a>
<div class="method-heading">
- <a href="#M000062" class="method-signature">
- <span class="method-name">store_attribute</span><span class="method-args">(element_locator, attribute_name, variable_name)</span>
+ <a href="#M000018" class="method-signature">
+ <span class="method-name">type</span><span class="method-args">(locator, value)</span>
</a>
</div>
<div class="method-description">
<p>
-Store the value of an attribute into a Selenium variable.
+Sets the value of an input field, as though you typed it in.
+</p>
+<p>
+Can also be used to set the value of combo boxes, check boxes, etc. In
+these cases, <tt>value</tt> should be the value of the option selected, not
+the visible text.
</p>
<p><a class="source-toggle" href="#"
- onclick="toggleCode('M000062-source');return false;">[Source]</a></p>
- <div class="method-source-code" id="M000062-source">
+ onclick="toggleCode('M000018-source');return false;">[Source]</a></p>
+ <div class="method-source-code" id="M000018-source">
<pre>
- <span class="ruby-comment cmt"># File lib/selenium_on_rails/test_builder.rb, line 114</span>
-114: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">store_attribute</span> <span class="ruby-identifier">element_locator</span>, <span class="ruby-identifier">attribute_name</span>, <span class="ruby-identifier">variable_name</span>
-115: <span class="ruby-identifier">command</span>(<span class="ruby-value str">'storeAttribute'</span>, <span class="ruby-node">"#{element_locator}@#{attribute_name}"</span>,
-116: <span class="ruby-identifier">variable_name</span>)
-117: <span class="ruby-keyword kw">end</span>
+ <span class="ruby-comment cmt"># File lib/selenium_on_rails/test_builder_actions.rb, line 94</span>
+94: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">type</span> <span class="ruby-identifier">locator</span>, <span class="ruby-identifier">value</span>
+95: <span class="ruby-identifier">command</span> <span class="ruby-value str">'type'</span>, <span class="ruby-identifier">locator</span>, <span class="ruby-identifier">value</span>
+96: <span class="ruby-keyword kw">end</span>
</pre>
</div>
</div>
</div>
- <div id="method-M000061" class="method-detail">
- <a name="M000061"></a>
+ <div id="method-M000020" class="method-detail">
+ <a name="M000020"></a>
<div class="method-heading">
- <a href="#M000061" class="method-signature">
- <span class="method-name">store_text</span><span class="method-args">(element_locator, variable_name)</span>
+ <a href="#M000020" class="method-signature">
+ <span class="method-name">uncheck</span><span class="method-args">(locator)</span>
</a>
</div>
<div class="method-description">
<p>
-Store the text of an element into a Selenium variable.
+Uncheck a toggle-button (checkbox/radio).
</p>
<p><a class="source-toggle" href="#"
- onclick="toggleCode('M000061-source');return false;">[Source]</a></p>
- <div class="method-source-code" id="M000061-source">
+ onclick="toggleCode('M000020-source');return false;">[Source]</a></p>
+ <div class="method-source-code" id="M000020-source">
<pre>
- <span class="ruby-comment cmt"># File lib/selenium_on_rails/test_builder.rb, line 109</span>
-109: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">store_text</span> <span class="ruby-identifier">element_locator</span>, <span class="ruby-identifier">variable_name</span>
-110: <span class="ruby-identifier">command</span> <span class="ruby-value str">'storeText'</span>, <span class="ruby-identifier">element_locator</span>, <span class="ruby-identifier">variable_name</span>
-111: <span class="ruby-keyword kw">end</span>
+ <span class="ruby-comment cmt"># File lib/selenium_on_rails/test_builder_actions.rb, line 104</span>
+104: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">uncheck</span> <span class="ruby-identifier">locator</span>
+105: <span class="ruby-identifier">command</span> <span class="ruby-value str">'uncheck'</span>, <span class="ruby-identifier">locator</span>
+106: <span class="ruby-keyword kw">end</span>
</pre>
</div>
</div>
</div>
- <div id="method-M000060" class="method-detail">
- <a name="M000060"></a>
+ <div id="method-M000034" class="method-detail">
+ <a name="M000034"></a>
<div class="method-heading">
- <a href="#M000060" class="method-signature">
- <span class="method-name">store_value</span><span class="method-args">(input_locator, variable_name)</span>
+ <a href="#M000034" class="method-signature">
+ <span class="method-name">wait_for_condition</span><span class="method-args">(script, timeout)</span>
</a>
</div>
<div class="method-description">
<p>
-Store the value of an input field into a Selenium variable.
+Runs the specified JavaScript snippet repeatedly until it evaluates to
+<tt>true</tt>. The snippet may have multiple lines, but only the result of
+the last line will be considered.
+</p>
+<p>
+Note that, by default, the snippet will be run in the runner’s test
+window, not in the window of your application. To get the window of your
+application, you can use the JavaScript snippet
+<tt>selenium.browserbot.getCurrentWindow()</tt>, and then run your
+JavaScript in there.
+</p>
+<p>
+<tt>timeout</tt> is specified in milliseconds.
</p>
<p><a class="source-toggle" href="#"
- onclick="toggleCode('M000060-source');return false;">[Source]</a></p>
- <div class="method-source-code" id="M000060-source">
+ onclick="toggleCode('M000034-source');return false;">[Source]</a></p>
+ <div class="method-source-code" id="M000034-source">
<pre>
- <span class="ruby-comment cmt"># File lib/selenium_on_rails/test_builder.rb, line 104</span>
-104: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">store_value</span> <span class="ruby-identifier">input_locator</span>, <span class="ruby-identifier">variable_name</span>
-105: <span class="ruby-identifier">command</span> <span class="ruby-value str">'storeValue'</span>, <span class="ruby-identifier">input_locator</span>, <span class="ruby-identifier">variable_name</span>
-106: <span class="ruby-keyword kw">end</span>
+ <span class="ruby-comment cmt"># File lib/selenium_on_rails/test_builder_actions.rb, line 235</span>
+235: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">wait_for_condition</span> <span class="ruby-identifier">script</span>, <span class="ruby-identifier">timeout</span>
+236: <span class="ruby-identifier">command</span> <span class="ruby-value str">'waitForCondition'</span>, <span class="ruby-identifier">script</span>, <span class="ruby-identifier">timeout</span>
+237: <span class="ruby-keyword kw">end</span>
</pre>
</div>
</div>
</div>
- <div id="method-M000051" class="method-detail">
- <a name="M000051"></a>
+ <div id="method-M000036" class="method-detail">
+ <a name="M000036"></a>
<div class="method-heading">
- <a href="#M000051" class="method-signature">
- <span class="method-name">type</span><span class="method-args">(input_locator, value, options={})</span>
+ <a href="#M000036" class="method-signature">
+ <span class="method-name">wait_for_page_to_load</span><span class="method-args">(timeout)</span>
</a>
</div>
<div class="method-description">
<p>
-Type <tt>value</tt> into the specified element. Supports a <tt>:wait =>
-true</tt> option, which is useful if typing into the field causes another
-page to be loaded.
+Waits for a new page to load.
+</p>
+<p>
+You can use this command instead of the <tt>and_wait</tt> suffixes,
+<tt>click_and_wait</tt>, <tt>select_and_wait</tt>, <tt>type_and_wait</tt>
+etc. (which are only available in the JS API).
+</p>
+<p>
+Selenium constantly keeps track of new pages loading, and sets a
+<tt>newPageLoaded</tt> flag when it first notices a page load. Running any
+other Selenium command after turns the flag to <tt>false</tt>. Hence, if
+you want to wait for a page to load, you must wait immediately after a
+Selenium command that caused a page-load.
+</p>
+<p>
+<tt>timeout</tt> is specified in milliseconds.
</p>
<p><a class="source-toggle" href="#"
- onclick="toggleCode('M000051-source');return false;">[Source]</a></p>
- <div class="method-source-code" id="M000051-source">
+ onclick="toggleCode('M000036-source');return false;">[Source]</a></p>
+ <div class="method-source-code" id="M000036-source">
<pre>
- <span class="ruby-comment cmt"># File lib/selenium_on_rails/test_builder.rb, line 55</span>
-55: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">type</span> <span class="ruby-identifier">input_locator</span>, <span class="ruby-identifier">value</span>, <span class="ruby-identifier">options</span>={}
-56: <span class="ruby-identifier">command</span> <span class="ruby-identifier">name_with_optional_wait</span>(<span class="ruby-value str">'type'</span>, <span class="ruby-identifier">options</span>), <span class="ruby-identifier">input_locator</span>, <span class="ruby-identifier">value</span>
-57: <span class="ruby-keyword kw">end</span>
+ <span class="ruby-comment cmt"># File lib/selenium_on_rails/test_builder_actions.rb, line 265</span>
+265: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">wait_for_page_to_load</span> <span class="ruby-identifier">timeout</span>
+266: <span class="ruby-identifier">command</span> <span class="ruby-value str">'waitForPageToLoad'</span>, <span class="ruby-identifier">timeout</span>
+267: <span class="ruby-keyword kw">end</span>
</pre>
</div>
</div>
</div>
- <div id="method-M000058" class="method-detail">
- <a name="M000058"></a>
+ <div id="method-M000027" class="method-detail">
+ <a name="M000027"></a>
<div class="method-heading">
- <a href="#M000058" class="method-signature">
- <span class="method-name">wait_for_value</span><span class="method-args">(input_locator, value)</span>
+ <a href="#M000027" class="method-signature">
+ <span class="method-name">wait_for_popup</span><span class="method-args">(window_id, timeout)</span>
</a>
</div>
<div class="method-description">
<p>
-Wait for an input field to have the specified value.
+Waits for a popup window to appear and load up.
+</p>
+<p>
+The <tt>timeout</tt> is specified in milliseconds.
</p>
<p><a class="source-toggle" href="#"
- onclick="toggleCode('M000058-source');return false;">[Source]</a></p>
- <div class="method-source-code" id="M000058-source">
+ onclick="toggleCode('M000027-source');return false;">[Source]</a></p>
+ <div class="method-source-code" id="M000027-source">
<pre>
- <span class="ruby-comment cmt"># File lib/selenium_on_rails/test_builder.rb, line 94</span>
-94: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">wait_for_value</span> <span class="ruby-identifier">input_locator</span>, <span class="ruby-identifier">value</span>
-95: <span class="ruby-identifier">command</span> <span class="ruby-value str">'waitForValue'</span>, <span class="ruby-identifier">input_locator</span>, <span class="ruby-identifier">value</span>
-96: <span class="ruby-keyword kw">end</span>
+ <span class="ruby-comment cmt"># File lib/selenium_on_rails/test_builder_actions.rb, line 176</span>
+176: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">wait_for_popup</span> <span class="ruby-identifier">window_id</span>, <span class="ruby-identifier">timeout</span>
+177: <span class="ruby-identifier">command</span> <span class="ruby-value str">'waitForPopUp'</span>, <span class="ruby-identifier">window_id</span><span class="ruby-operator">||</span><span class="ruby-value str">'null'</span>, <span class="ruby-identifier">timeout</span>
+178: <span class="ruby-keyword kw">end</span>
</pre>
</div>
</div>
doc/classes/SeleniumOnRails/TestBuilderActions.html
@@ -56,7 +56,7 @@
</tr>
<tr class="top-aligned-row">
<td><strong>Last Update:</strong></td>
- <td>Wed May 03 00:11:21 W. Europe Daylight Time 2006</td>
+ <td>Mon Jun 05 23:59:28 W. Europe Daylight Time 2006</td>
</tr>
</table>
</div>
@@ -73,14 +73,14 @@
<h2>Overview</h2>
<p>
Selenium on Rails provides an easy way to test Rails application with <a
-href="http://www.openqa.org/selenium/">Selenium</a>.
+href="http://www.openqa.org/selenium-core/">Selenium Core</a>.
</p>
<p>
This plugin does four things:
</p>
<ol>
-<li>The Selenium files don’t have to pollute <tt>/public</tt>, they can
-stay in the Selenium gem or in <tt>/vendor/selenium</tt>.
+<li>The Selenium Core files don’t have to pollute <tt>/public</tt>, they
+can stay in the Selenium gem or in <tt>/vendor/selenium</tt>.
</li>
<li>No need to create suite files, they are generated on the fly — one
@@ -97,7 +97,7 @@ formats (see <tt>Formats</tt>).
</ol>
<h2>Installation</h2>
<ol>
-<li>Selenium needs to be available. It could either be installed as a gem
+<li>Selenium Core needs to be available. It could either be installed as a gem
(<tt>gem install selenium</tt>) or in <tt>/vendor/selenium/</tt>.
</li>
@@ -300,8 +300,8 @@ start the server when needed.
<h3>user_extension.js</h3>
<p>
Selenium has support for <tt>user_extension.js</tt> which is a way to
-extend the functionality of Selenium. However there is currently no easy
-way to add such a file in Selenium on Rails.
+extend the functionality of Selenium Core. However there is currently no
+easy way to add such a file in Selenium on Rails.
</p>
<h3>More setup/teardown support?</h3>
<p>
doc/files/README.html
@@ -56,7 +56,7 @@
</tr>
<tr class="top-aligned-row">
<td><strong>Last Update:</strong></td>
- <td>Fri Mar 03 21:23:22 W. Europe Standard Time 2006</td>
+ <td>Tue Jun 06 02:47:24 W. Europe Daylight Time 2006</td>
</tr>
</table>
</div>
@@ -70,9 +70,21 @@
<div id="description">
<p>
-The actions available for <a
-href="../../../classes/SeleniumOnRails/TestBuilder.html">SeleniumOnRails::TestBuilder</a>
-tests.
+Builds Selenium test table using a high-level Ruby interface. Normally
+invoked through <a
+href="../../../classes/SeleniumOnRails/RSelenese.html">SeleniumOnRails::RSelenese</a>.
+</p>
+<p>
+See <a
+href="../../../classes/SeleniumOnRails/TestBuilderActions.html">SeleniumOnRails::TestBuilderActions</a>
+for the available actions and <a
+href="../../../classes/SeleniumOnRails/TestBuilderAccessors.html">SeleniumOnRails::TestBuilderAccessors</a>
+for the available checks.
+</p>
+<p>
+For more information on the commands supported by TestBuilder, see the
+Selenium Commands Documentation at <a
+href="http://release.openqa.org/selenium-core/nightly/reference.html">release.openqa.org/selenium-core/nightly/reference.html</a>.
</p>
</div>
doc/files/lib/selenium_on_rails/test_builder_rb.html
@@ -56,7 +56,7 @@
</tr>
<tr class="top-aligned-row">
<td><strong>Last Update:</strong></td>
- <td>Sun Feb 19 11:48:19 W. Europe Standard Time 2006</td>
+ <td>Thu May 04 01:18:20 W. Europe Daylight Time 2006</td>
</tr>
</table>
</div>
@@ -79,6 +79,7 @@
selenium_on_rails/suite_renderer
selenium_on_rails/paths
selenium_on_rails/fixture_loader
+ selenium_on_rails/partials_support
selenium_on_rails/renderer
</div>
</div>
doc/files/lib/selenium_on_rails_rb.html
@@ -31,8 +31,8 @@
<a href="classes/SeleniumOnRails/Selenese.html">SeleniumOnRails::Selenese</a><br />
<a href="classes/SeleniumOnRails/SuiteRenderer.html">SeleniumOnRails::SuiteRenderer</a><br />
<a href="classes/SeleniumOnRails/TestBuilder.html">SeleniumOnRails::TestBuilder</a><br />
+ <a href="classes/SeleniumOnRails/TestBuilderAccessors.html">SeleniumOnRails::TestBuilderAccessors</a><br />
<a href="classes/SeleniumOnRails/TestBuilderActions.html">SeleniumOnRails::TestBuilderActions</a><br />
- <a href="classes/SeleniumOnRails/TestBuilderChecks.html">SeleniumOnRails::TestBuilderChecks</a><br />
<a href="classes/SeleniumOnRailsConfig.html">SeleniumOnRailsConfig</a><br />
</div>
</div>
doc/fr_class_index.html
@@ -33,6 +33,8 @@
<a href="files/lib/selenium_on_rails/selenese_rb.html">lib/selenium_on_rails/selenese.rb</a><br />
<a href="files/lib/selenium_on_rails/suite_renderer_rb.html">lib/selenium_on_rails/suite_renderer.rb</a><br />
<a href="files/lib/selenium_on_rails/test_builder_rb.html">lib/selenium_on_rails/test_builder.rb</a><br />
+ <a href="files/lib/selenium_on_rails/test_builder_accessors_rb.html">lib/selenium_on_rails/test_builder_accessors.rb</a><br />
+ <a href="files/lib/selenium_on_rails/test_builder_actions_rb.html">lib/selenium_on_rails/test_builder_actions.rb</a><br />
<a href="files/lib/selenium_on_rails_config_rb.html">lib/selenium_on_rails_config.rb</a><br />
</div>
</div>
doc/fr_file_index.html
@@ -20,93 +20,97 @@
<div id="index">
<h1 class="section-bar">Methods</h1>
<div id="index-entries">
- <a href="classes/SeleniumOnRails/TestBuilderActions.html#M000064">answer_on_next_prompt (SeleniumOnRails::TestBuilderActions)</a><br />
- <a href="classes/SeleniumOnRails/TestBuilderChecks.html#M000041">assert_alert (SeleniumOnRails::TestBuilderChecks)</a><br />
- <a href="classes/SeleniumOnRails/TestBuilderChecks.html#M000021">assert_attribute (SeleniumOnRails::TestBuilderChecks)</a><br />
- <a href="classes/SeleniumOnRails/TestBuilderChecks.html#M000043">assert_confirmation (SeleniumOnRails::TestBuilderChecks)</a><br />
- <a href="classes/SeleniumOnRails/TestBuilderChecks.html#M000037">assert_editable (SeleniumOnRails::TestBuilderChecks)</a><br />
- <a href="classes/SeleniumOnRails/TestBuilderChecks.html#M000029">assert_element_not_present (SeleniumOnRails::TestBuilderChecks)</a><br />
- <a href="classes/SeleniumOnRails/TestBuilderChecks.html#M000027">assert_element_present (SeleniumOnRails::TestBuilderChecks)</a><br />
- <a href="classes/SeleniumOnRails/TestBuilderChecks.html#M000009">assert_location (SeleniumOnRails::TestBuilderChecks)</a><br />
- <a href="classes/SeleniumOnRails/TestBuilderChecks.html#M000039">assert_not_editable (SeleniumOnRails::TestBuilderChecks)</a><br />
- <a href="classes/SeleniumOnRails/TestBuilderChecks.html#M000035">assert_not_visible (SeleniumOnRails::TestBuilderChecks)</a><br />
- <a href="classes/SeleniumOnRails/TestBuilderChecks.html#M000045">assert_prompt (SeleniumOnRails::TestBuilderChecks)</a><br />
- <a href="classes/SeleniumOnRails/TestBuilderChecks.html#M000017">assert_select_options (SeleniumOnRails::TestBuilderChecks)</a><br />
- <a href="classes/SeleniumOnRails/TestBuilderChecks.html#M000015">assert_selected (SeleniumOnRails::TestBuilderChecks)</a><br />
- <a href="classes/SeleniumOnRails/TestBuilderChecks.html#M000031">assert_table (SeleniumOnRails::TestBuilderChecks)</a><br />
- <a href="classes/SeleniumOnRails/TestBuilderChecks.html#M000019">assert_text (SeleniumOnRails::TestBuilderChecks)</a><br />
- <a href="classes/SeleniumOnRails/TestBuilderChecks.html#M000025">assert_text_not_present (SeleniumOnRails::TestBuilderChecks)</a><br />
- <a href="classes/SeleniumOnRails/TestBuilderChecks.html#M000023">assert_text_present (SeleniumOnRails::TestBuilderChecks)</a><br />
- <a href="classes/SeleniumOnRails/TestBuilderChecks.html#M000011">assert_title (SeleniumOnRails::TestBuilderChecks)</a><br />
- <a href="classes/SeleniumOnRails/TestBuilderChecks.html#M000013">assert_value (SeleniumOnRails::TestBuilderChecks)</a><br />
- <a href="classes/SeleniumOnRails/TestBuilderChecks.html#M000033">assert_visible (SeleniumOnRails::TestBuilderChecks)</a><br />
- <a href="classes/SeleniumOnRails/FixtureLoader.html#M000076">available_fixtures (SeleniumOnRails::FixtureLoader)</a><br />
+ <a href="classes/SeleniumOnRails/TestBuilderActions.html#M000022">add_selection (SeleniumOnRails::TestBuilderActions)</a><br />
+ <a href="classes/SeleniumOnRails/TestBuilderActions.html#M000029">answer_on_next_prompt (SeleniumOnRails::TestBuilderActions)</a><br />
+ <a href="classes/SeleniumOnRails/FixtureLoader.html#M000048">available_fixtures (SeleniumOnRails::FixtureLoader)</a><br />
<a href="files/lib/selenium_on_rails/acceptance_test_runner_rb.html#M000001">c (lib/selenium_on_rails/acceptance_test_runner.rb)</a><br />
<a href="files/lib/selenium_on_rails/acceptance_test_runner_rb.html#M000002">c_b (lib/selenium_on_rails/acceptance_test_runner.rb)</a><br />
- <a href="classes/SeleniumOnRails/TestBuilderActions.html#M000063">choose_cancel_on_next_confirmation (SeleniumOnRails::TestBuilderActions)</a><br />
- <a href="classes/SeleniumOnRails/TestBuilderActions.html#M000050">click (SeleniumOnRails::TestBuilderActions)</a><br />
- <a href="classes/SeleniumOnRails/TestBuilderActions.html#M000055">close (SeleniumOnRails::TestBuilderActions)</a><br />
- <a href="classes/SeleniumOnRails/TestBuilder.html#M000087">command (SeleniumOnRails::TestBuilder)</a><br />
+ <a href="classes/SeleniumOnRails/TestBuilderActions.html#M000019">check (SeleniumOnRails::TestBuilderActions)</a><br />
+ <a href="classes/SeleniumOnRails/TestBuilderActions.html#M000028">choose_cancel_on_next_confirmation (SeleniumOnRails::TestBuilderActions)</a><br />
+ <a href="classes/SeleniumOnRails/TestBuilderActions.html#M000011">click (SeleniumOnRails::TestBuilderActions)</a><br />
+ <a href="classes/SeleniumOnRails/TestBuilderActions.html#M000032">close (SeleniumOnRails::TestBuilderActions)</a><br />
+ <a href="classes/SeleniumOnRails/TestBuilder.html#M000088">command (SeleniumOnRails::TestBuilder)</a><br />
+ <a href="classes/SeleniumOnRails/TestBuilder.html#M000090">command_and_wait (SeleniumOnRails::TestBuilder)</a><br />
+ <a href="classes/SeleniumOnRails/TestBuilder.html#M000089">command_verbatim (SeleniumOnRails::TestBuilder)</a><br />
+ <a href="classes/SeleniumOnRails/TestBuilder.html#M000085">exactize (SeleniumOnRails::TestBuilder)</a><br />
<a href="classes/SeleniumOnRails/PartialsSupport.html#M000079">extract_commands_from_partial (SeleniumOnRails::PartialsSupport)</a><br />
- <a href="classes/SeleniumOnRails/TestBuilderActions.html#M000057">fire_event (SeleniumOnRails::TestBuilderActions)</a><br />
- <a href="classes/SeleniumOnRails/Paths.html#M000070">fixtures_path (SeleniumOnRails::Paths)</a><br />
+ <a href="classes/SeleniumOnRails/TestBuilderActions.html#M000012">fire_event (SeleniumOnRails::TestBuilderActions)</a><br />
+ <a href="classes/SeleniumOnRails/Paths.html#M000042">fixtures_path (SeleniumOnRails::Paths)</a><br />
<a href="classes/SeleniumOnRailsConfig.html#M000007">get (SeleniumOnRailsConfig)</a><br />
- <a href="classes/SeleniumOnRails/TestBuilderActions.html#M000054">go_back (SeleniumOnRails::TestBuilderActions)</a><br />
- <a href="classes/SeleniumOnRails/TestBuilderActions.html#M000048">include_partial (SeleniumOnRails::TestBuilderActions)</a><br />
- <a href="classes/SeleniumOnRails/Paths.html#M000069">layout_path (SeleniumOnRails::Paths)</a><br />
- <a href="classes/SeleniumOnRails/SuiteRenderer.html#M000075">link_to_test_case (SeleniumOnRails::SuiteRenderer)</a><br />
- <a href="classes/SeleniumOnRails/FixtureLoader.html#M000077">load_fixtures (SeleniumOnRails::FixtureLoader)</a><br />
- <a href="classes/SeleniumOnRails/Paths.html#M000071">log_path (SeleniumOnRails::Paths)</a><br />
- <a href="classes/SeleniumOnRails/RSelenese.html#M000082">new (SeleniumOnRails::RSelenese)</a><br />
- <a href="classes/SeleniumOnRails/TestBuilder.html#M000085">new (SeleniumOnRails::TestBuilder)</a><br />
+ <a href="classes/SeleniumOnRails/TestBuilderActions.html#M000030">go_back (SeleniumOnRails::TestBuilderActions)</a><br />
+ <a href="classes/SeleniumOnRails/TestBuilderActions.html#M000010">include_partial (SeleniumOnRails::TestBuilderActions)</a><br />
+ <a href="classes/SeleniumOnRails/TestBuilderActions.html#M000014">key_down (SeleniumOnRails::TestBuilderActions)</a><br />
+ <a href="classes/SeleniumOnRails/TestBuilderActions.html#M000013">key_press (SeleniumOnRails::TestBuilderActions)</a><br />
+ <a href="classes/SeleniumOnRails/TestBuilderActions.html#M000015">key_up (SeleniumOnRails::TestBuilderActions)</a><br />
+ <a href="classes/SeleniumOnRails/Paths.html#M000041">layout_path (SeleniumOnRails::Paths)</a><br />
+ <a href="classes/SeleniumOnRails/SuiteRenderer.html#M000047">link_to_test_case (SeleniumOnRails::SuiteRenderer)</a><br />
+ <a href="classes/SeleniumOnRails/FixtureLoader.html#M000049">load_fixtures (SeleniumOnRails::FixtureLoader)</a><br />
+ <a href="classes/SeleniumOnRails/Paths.html#M000043">log_path (SeleniumOnRails::Paths)</a><br />
+ <a href="classes/SeleniumOnRails/TestBuilder.html#M000091">make_command_waiting (SeleniumOnRails::TestBuilder)</a><br />
+ <a href="classes/SeleniumOnRails/TestBuilderActions.html#M000017">mouse_down (SeleniumOnRails::TestBuilderActions)</a><br />
+ <a href="classes/SeleniumOnRails/TestBuilderActions.html#M000016">mouse_over (SeleniumOnRails::TestBuilderActions)</a><br />
+ <a href="classes/SeleniumOnRails/TestBuilder.html#M000086">new (SeleniumOnRails::TestBuilder)</a><br />
<a href="classes/SeleniumOnRails/Selenese.html#M000080">new (SeleniumOnRails::Selenese)</a><br />
- <a href="classes/SeleniumOnRails/TestBuilderActions.html#M000049">open (SeleniumOnRails::TestBuilderActions)</a><br />
- <a href="classes/SeleniumOnRails/TestBuilderActions.html#M000056">pause (SeleniumOnRails::TestBuilderActions)</a><br />
+ <a href="classes/SeleniumOnRails/RSelenese.html#M000082">new (SeleniumOnRails::RSelenese)</a><br />
+ <a href="classes/SeleniumOnRails/TestBuilderActions.html#M000025">open (SeleniumOnRails::TestBuilderActions)</a><br />
<a href="classes/SeleniumController.html#M000006">record (SeleniumController)</a><br />
+ <a href="classes/SeleniumOnRails/TestBuilderActions.html#M000031">refresh (SeleniumOnRails::TestBuilderActions)</a><br />
+ <a href="classes/SeleniumOnRails/TestBuilderActions.html#M000023">remove_selection (SeleniumOnRails::TestBuilderActions)</a><br />
<a href="classes/SeleniumOnRails/RSelenese.html#M000083">render (SeleniumOnRails::RSelenese)</a><br />
<a href="classes/SeleniumOnRails/Selenese.html#M000081">render (SeleniumOnRails::Selenese)</a><br />
<a href="classes/SeleniumOnRails/PartialsSupport.html#M000078">render_partial (SeleniumOnRails::PartialsSupport)</a><br />
- <a href="classes/SeleniumOnRails/Renderer.html#M000065">render_test_case (SeleniumOnRails::Renderer)</a><br />
- <a href="classes/SeleniumOnRails/TestBuilderActions.html#M000052">select (SeleniumOnRails::TestBuilderActions)</a><br />
- <a href="classes/SeleniumOnRails/TestBuilderActions.html#M000053">select_window (SeleniumOnRails::TestBuilderActions)</a><br />
- <a href="classes/SeleniumOnRails/Paths.html#M000066">selenium_path (SeleniumOnRails::Paths)</a><br />
- <a href="classes/SeleniumOnRails/Paths.html#M000067">selenium_tests_path (SeleniumOnRails::Paths)</a><br />
+ <a href="classes/SeleniumOnRails/Renderer.html#M000037">render_test_case (SeleniumOnRails::Renderer)</a><br />
+ <a href="classes/SeleniumOnRails/TestBuilderActions.html#M000021">select (SeleniumOnRails::TestBuilderActions)</a><br />
+ <a href="classes/SeleniumOnRails/TestBuilderActions.html#M000026">select_window (SeleniumOnRails::TestBuilderActions)</a><br />
+ <a href="classes/SeleniumOnRails/Paths.html#M000038">selenium_path (SeleniumOnRails::Paths)</a><br />
+ <a href="classes/SeleniumOnRails/Paths.html#M000039">selenium_tests_path (SeleniumOnRails::Paths)</a><br />
<a href="classes/SeleniumOnRails/TestBuilder.html#M000084">selenize (SeleniumOnRails::TestBuilder)</a><br />
+ <a href="classes/SeleniumOnRails/TestBuilderActions.html#M000033">set_context (SeleniumOnRails::TestBuilderActions)</a><br />
+ <a href="classes/SeleniumOnRails/TestBuilderActions.html#M000035">set_timeout (SeleniumOnRails::TestBuilderActions)</a><br />
<a href="classes/SeleniumController.html#M000003">setup (SeleniumController)</a><br />
- <a href="classes/SeleniumOnRails/TestBuilderActions.html#M000047">setup (SeleniumOnRails::TestBuilderActions)</a><br />
- <a href="classes/SeleniumOnRails/TestBuilderActions.html#M000059">store (SeleniumOnRails::TestBuilderActions)</a><br />
- <a href="classes/SeleniumOnRails/TestBuilderActions.html#M000062">store_attribute (SeleniumOnRails::TestBuilderActions)</a><br />
- <a href="classes/SeleniumOnRails/TestBuilderActions.html#M000061">store_text (SeleniumOnRails::TestBuilderActions)</a><br />
- <a href="classes/SeleniumOnRails/TestBuilderActions.html#M000060">store_value (SeleniumOnRails::TestBuilderActions)</a><br />
+ <a href="classes/SeleniumOnRails/TestBuilderActions.html#M000009">setup (SeleniumOnRails::TestBuilderActions)</a><br />
+ <a href="classes/SeleniumOnRails/TestBuilderAccessors.html#M000056">store_absolute_location (SeleniumOnRails::TestBuilderAccessors)</a><br />
+ <a href="classes/SeleniumOnRails/TestBuilderAccessors.html#M000053">store_alert (SeleniumOnRails::TestBuilderAccessors)</a><br />
+ <a href="classes/SeleniumOnRails/TestBuilderAccessors.html#M000050">store_alert_present (SeleniumOnRails::TestBuilderAccessors)</a><br />
+ <a href="classes/SeleniumOnRails/TestBuilderAccessors.html#M000073">store_all_buttons (SeleniumOnRails::TestBuilderAccessors)</a><br />
+ <a href="classes/SeleniumOnRails/TestBuilderAccessors.html#M000075">store_all_fields (SeleniumOnRails::TestBuilderAccessors)</a><br />
+ <a href="classes/SeleniumOnRails/TestBuilderAccessors.html#M000074">store_all_links (SeleniumOnRails::TestBuilderAccessors)</a><br />
+ <a href="classes/SeleniumOnRails/TestBuilderAccessors.html#M000068">store_attribute (SeleniumOnRails::TestBuilderAccessors)</a><br />
+ <a href="classes/SeleniumOnRails/TestBuilderAccessors.html#M000059">store_body_text (SeleniumOnRails::TestBuilderAccessors)</a><br />
+ <a href="classes/SeleniumOnRails/TestBuilderAccessors.html#M000063">store_checked (SeleniumOnRails::TestBuilderAccessors)</a><br />
+ <a href="classes/SeleniumOnRails/TestBuilderAccessors.html#M000054">store_confirmation (SeleniumOnRails::TestBuilderAccessors)</a><br />
+ <a href="classes/SeleniumOnRails/TestBuilderAccessors.html#M000052">store_confirmation_present (SeleniumOnRails::TestBuilderAccessors)</a><br />
+ <a href="classes/SeleniumOnRails/TestBuilderAccessors.html#M000072">store_editable (SeleniumOnRails::TestBuilderAccessors)</a><br />
+ <a href="classes/SeleniumOnRails/TestBuilderAccessors.html#M000070">store_element_present (SeleniumOnRails::TestBuilderAccessors)</a><br />
+ <a href="classes/SeleniumOnRails/TestBuilderAccessors.html#M000062">store_eval (SeleniumOnRails::TestBuilderAccessors)</a><br />
+ <a href="classes/SeleniumOnRails/TestBuilderAccessors.html#M000077">store_expression (SeleniumOnRails::TestBuilderAccessors)</a><br />
+ <a href="classes/SeleniumOnRails/TestBuilderAccessors.html#M000076">store_html_source (SeleniumOnRails::TestBuilderAccessors)</a><br />
+ <a href="classes/SeleniumOnRails/TestBuilderAccessors.html#M000057">store_location (SeleniumOnRails::TestBuilderAccessors)</a><br />
+ <a href="classes/SeleniumOnRails/TestBuilderAccessors.html#M000055">store_prompt (SeleniumOnRails::TestBuilderAccessors)</a><br />
+ <a href="classes/SeleniumOnRails/TestBuilderAccessors.html#M000051">store_prompt_present (SeleniumOnRails::TestBuilderAccessors)</a><br />
+ <a href="classes/SeleniumOnRails/TestBuilderAccessors.html#M000067">store_select_options (SeleniumOnRails::TestBuilderAccessors)</a><br />
+ <a href="classes/SeleniumOnRails/TestBuilderAccessors.html#M000065">store_selected (SeleniumOnRails::TestBuilderAccessors)</a><br />
+ <a href="classes/SeleniumOnRails/TestBuilderAccessors.html#M000066">store_selected_options (SeleniumOnRails::TestBuilderAccessors)</a><br />
+ <a href="classes/SeleniumOnRails/TestBuilderAccessors.html#M000064">store_table (SeleniumOnRails::TestBuilderAccessors)</a><br />
+ <a href="classes/SeleniumOnRails/TestBuilderAccessors.html#M000061">store_text (SeleniumOnRails::TestBuilderAccessors)</a><br />
+ <a href="classes/SeleniumOnRails/TestBuilderAccessors.html#M000069">store_text_present (SeleniumOnRails::TestBuilderAccessors)</a><br />
+ <a href="classes/SeleniumOnRails/TestBuilderAccessors.html#M000058">store_title (SeleniumOnRails::TestBuilderAccessors)</a><br />
+ <a href="classes/SeleniumOnRails/TestBuilderAccessors.html#M000060">store_value (SeleniumOnRails::TestBuilderAccessors)</a><br />
+ <a href="classes/SeleniumOnRails/TestBuilderAccessors.html#M000071">store_visible (SeleniumOnRails::TestBuilderAccessors)</a><br />
+ <a href="classes/SeleniumOnRails/TestBuilderActions.html#M000024">submit (SeleniumOnRails::TestBuilderActions)</a><br />
<a href="classes/SeleniumController.html#M000005">support_file (SeleniumController)</a><br />
- <a href="classes/SeleniumOnRails/TestBuilder.html#M000086">table (SeleniumOnRails::TestBuilder)</a><br />
+ <a href="classes/SeleniumOnRails/TestBuilder.html#M000087">table (SeleniumOnRails::TestBuilder)</a><br />
<a href="classes/SeleniumHelper.html#M000008">test_case_name (SeleniumHelper)</a><br />
- <a href="classes/SeleniumOnRails/SuiteRenderer.html#M000074">test_cases (SeleniumOnRails::SuiteRenderer)</a><br />
+ <a href="classes/SeleniumOnRails/SuiteRenderer.html#M000046">test_cases (SeleniumOnRails::SuiteRenderer)</a><br />
<a href="classes/SeleniumController.html#M000004">test_file (SeleniumController)</a><br />
- <a href="classes/SeleniumOnRails/SuiteRenderer.html#M000072">test_suite_name (SeleniumOnRails::SuiteRenderer)</a><br />
- <a href="classes/SeleniumOnRails/SuiteRenderer.html#M000073">test_suites (SeleniumOnRails::SuiteRenderer)</a><br />
- <a href="classes/SeleniumOnRails/TestBuilderActions.html#M000051">type (SeleniumOnRails::TestBuilderActions)</a><br />
- <a href="classes/SeleniumOnRails/TestBuilderChecks.html#M000042">verify_alert (SeleniumOnRails::TestBuilderChecks)</a><br />
- <a href="classes/SeleniumOnRails/TestBuilderChecks.html#M000022">verify_attribute (SeleniumOnRails::TestBuilderChecks)</a><br />
- <a href="classes/SeleniumOnRails/TestBuilderChecks.html#M000044">verify_confirmation (SeleniumOnRails::TestBuilderChecks)</a><br />
- <a href="classes/SeleniumOnRails/TestBuilderChecks.html#M000038">verify_editable (SeleniumOnRails::TestBuilderChecks)</a><br />
- <a href="classes/SeleniumOnRails/TestBuilderChecks.html#M000030">verify_element_not_present (SeleniumOnRails::TestBuilderChecks)</a><br />
- <a href="classes/SeleniumOnRails/TestBuilderChecks.html#M000028">verify_element_present (SeleniumOnRails::TestBuilderChecks)</a><br />
- <a href="classes/SeleniumOnRails/TestBuilderChecks.html#M000010">verify_location (SeleniumOnRails::TestBuilderChecks)</a><br />
- <a href="classes/SeleniumOnRails/TestBuilderChecks.html#M000040">verify_not_editable (SeleniumOnRails::TestBuilderChecks)</a><br />
- <a href="classes/SeleniumOnRails/TestBuilderChecks.html#M000036">verify_not_visible (SeleniumOnRails::TestBuilderChecks)</a><br />
- <a href="classes/SeleniumOnRails/TestBuilderChecks.html#M000046">verify_prompt (SeleniumOnRails::TestBuilderChecks)</a><br />
- <a href="classes/SeleniumOnRails/TestBuilderChecks.html#M000018">verify_select_options (SeleniumOnRails::TestBuilderChecks)</a><br />
- <a href="classes/SeleniumOnRails/TestBuilderChecks.html#M000016">verify_selected (SeleniumOnRails::TestBuilderChecks)</a><br />
- <a href="classes/SeleniumOnRails/TestBuilderChecks.html#M000032">verify_table (SeleniumOnRails::TestBuilderChecks)</a><br />
- <a href="classes/SeleniumOnRails/TestBuilderChecks.html#M000020">verify_text (SeleniumOnRails::TestBuilderChecks)</a><br />
- <a href="classes/SeleniumOnRails/TestBuilderChecks.html#M000026">verify_text_not_present (SeleniumOnRails::TestBuilderChecks)</a><br />
- <a href="classes/SeleniumOnRails/TestBuilderChecks.html#M000024">verify_text_present (SeleniumOnRails::TestBuilderChecks)</a><br />
- <a href="classes/SeleniumOnRails/TestBuilderChecks.html#M000012">verify_title (SeleniumOnRails::TestBuilderChecks)</a><br />
- <a href="classes/SeleniumOnRails/TestBuilderChecks.html#M000014">verify_value (SeleniumOnRails::TestBuilderChecks)</a><br />
- <a href="classes/SeleniumOnRails/TestBuilderChecks.html#M000034">verify_visible (SeleniumOnRails::TestBuilderChecks)</a><br />
- <a href="classes/SeleniumOnRails/Paths.html#M000068">view_path (SeleniumOnRails::Paths)</a><br />
- <a href="classes/SeleniumOnRails/TestBuilderActions.html#M000058">wait_for_value (SeleniumOnRails::TestBuilderActions)</a><br />
+ <a href="classes/SeleniumOnRails/SuiteRenderer.html#M000044">test_suite_name (SeleniumOnRails::SuiteRenderer)</a><br />
+ <a href="classes/SeleniumOnRails/SuiteRenderer.html#M000045">test_suites (SeleniumOnRails::SuiteRenderer)</a><br />
+ <a href="classes/SeleniumOnRails/TestBuilderActions.html#M000018">type (SeleniumOnRails::TestBuilderActions)</a><br />
+ <a href="classes/SeleniumOnRails/TestBuilderActions.html#M000020">uncheck (SeleniumOnRails::TestBuilderActions)</a><br />
+ <a href="classes/SeleniumOnRails/Paths.html#M000040">view_path (SeleniumOnRails::Paths)</a><br />
+ <a href="classes/SeleniumOnRails/TestBuilderActions.html#M000034">wait_for_condition (SeleniumOnRails::TestBuilderActions)</a><br />
+ <a href="classes/SeleniumOnRails/TestBuilderActions.html#M000036">wait_for_page_to_load (SeleniumOnRails::TestBuilderActions)</a><br />
+ <a href="classes/SeleniumOnRails/TestBuilderActions.html#M000027">wait_for_popup (SeleniumOnRails::TestBuilderActions)</a><br />
</div>
</div>
</body>
doc/fr_method_index.html
@@ -9,8 +9,8 @@
<%% end -%>
</table>
-<p>More information about the commands is available <a href="http://www.openqa.org/selenium/seleniumReference.html">here</a>.</p>
+<p>More information about the commands is available <a href="http://release.openqa.org/selenium-core/nightly/reference.html">here</a>.</p>
<p>You can write comments above and below the commands, but you can only have one set of commands, i.e. one table, per test.</p>
-<p>Point the browser to <a href="<%= testcase_link %>"><%= testcase_link %></a> to see how this test is rendered, or to <a href="<%= suite_link %>"><%= suite_link %></a> to run the suite.</p>
\ No newline at end of file
+<p>Point the browser to <a href="<%= testcase_link %>"><%= testcase_link %></a> to see how this test is rendered, or to <a href="<%= suite_link %>"><%= suite_link %></a> to run the suite.</p>
generators/selenium/templates/rhtml.rhtml
@@ -6,7 +6,7 @@ open '/'
assert_title 'Home'
# More information about the commands is available at:
-# http://www.openqa.org/selenium/seleniumReference.html.
+# http://release.openqa.org/selenium-core/nightly/reference.html
# See also the RDoc for SeleniumOnRails::TestBuilder.
#
# Point the browser to <%= testcase_link %> to see
generators/selenium/templates/rselenese.rhtml
@@ -4,8 +4,8 @@ It's often a good idea to start the test with opening <tt>/selenium/setup</tt> (
|open|/|
|assertTitle|Home|
-More information about the commands is available "here":http://www.openqa.org/selenium/seleniumReference.html.
+More information about the commands is available "here":http://release.openqa.org/selenium-core/nightly/reference.html.
You can write comments above and below the commands, but you can only have one set of commands, i.e. one table, per test. "RedCloth":http://www.whytheluckystiff.net/ruby/redcloth/ is used for formatting if installed.
-Point the browser to "<%= testcase_link %>":<%= testcase_link %> to see how this test is rendered, or to "<%= suite_link %>":<%= suite_link %> to run the suite.
\ No newline at end of file
+Point the browser to "<%= testcase_link %>":<%= testcase_link %> to see how this test is rendered, or to "<%= suite_link %>":<%= suite_link %> to run the suite.
generators/selenium/templates/selenese.rhtml
@@ -33,15 +33,17 @@ module SeleniumOnRails
private
def find_selenium_path
# with checked out selenium
- selenium_path = SeleniumOnRailsConfig.get :selenium_path, File.expand_path(File.join(RAILS_ROOT, 'vendor/selenium'))
- ['', 'core', 'selenium', 'javascript'].each do |subdir|
- vendor_selenium = File.join selenium_path, subdir
- return vendor_selenium if File.exist?(File.join(vendor_selenium, 'TestRunner.html'))
+ ['selenium', 'selenium-core'].each do |seleniumdir|
+ selenium_path = SeleniumOnRailsConfig.get :selenium_path, File.expand_path(File.join(RAILS_ROOT, "vendor/#{seleniumdir}"))
+ ['', 'core', 'selenium', 'javascript'].each do |subdir|
+ vendor_selenium = File.join selenium_path, subdir
+ return vendor_selenium if File.exist?(File.join(vendor_selenium, 'TestRunner.html'))
+ end
end
# installed selenium gem
gems = Gem.source_index.find_name 'selenium', nil
- raise 'could not find selenium installation' if gems.empty?
+ raise 'Could not find Selenium Core installation' if gems.empty?
File.join gems[0].full_gem_path, 'javascript'
end
lib/selenium_on_rails/paths.rb
@@ -1,347 +1,27 @@
-# The actions available for SeleniumOnRails::TestBuilder tests.
-module SeleniumOnRails::TestBuilderActions
- # Tell Selenium on Rails to clear the session and load any fixtures. DO
- # NOT CALL THIS AGAINST NON-TEST DATABASES.
- # The supported +options+ are <code>:keep_session</code> and <code>:fixtures</code>
- # setup
- # setup :keep_session
- # setup :fixtures => :all
- # setup :keep_session, :fixtures => [:foo, :bar]
- def setup options = {}
- options = {options => nil} unless options.is_a? Hash
-
- opts = {:controller => 'selenium', :action => 'setup'}
- opts[:keep_session] = true if options.has_key? :keep_session
-
- if (f = options[:fixtures])
- f = [f] unless f.is_a? Array
- opts[:fixtures] = f.join ','
- end
-
- open opts
- end
-
- # Includes a partial.
- # The path is relative to the Selenium tests root. The starting _ and the file
- # extension doesn't have to be specified.
- # #include test/selenium/_partial.*
- # include_partial 'partial'
- # #include test/selenium/suite/_partial.*
- # include_partial 'suite/partial'
- # #include test/selenium/suite/_partial.* and provide local assigns
- # include_partial 'suite/partial', :foo => bar
- def include_partial path, local_assigns = {}
- partial = @view.render :partial => path, :locals => local_assigns
- @output << partial
- end
-
- # Open the page specified by +url+ and wait. The +url+ may either by a
- # string, or arguments suitable for <code>ActionView::UrlHelper#url_for</code>.
- # open '/'
- # open :controller => 'customer', :action => 'list'
- def open url
- command 'open', url_arg(url)
- end
-
- # Click on the specified element. Supports a <code>:wait => true</code>
- # option.
- def click element_locator, options={}
- command name_with_optional_wait('click', options), element_locator
- end
-
- # Type +value+ into the specified element. Supports a <code>:wait =>
- # true</code> option, which is useful if typing into the field causes
- # another page to be loaded.
- def type input_locator, value, options={}
- command name_with_optional_wait('type', options), input_locator, value
- end
-
- # Select an option from a +select+ menu. Supports a <code>:wait =>
- # true</code> option.
- def select drop_down_locator, option_specifier, options={}
- command(name_with_optional_wait('select', options), drop_down_locator,
- option_specifier)
- end
-
- # Select a popup window by name, and send further commands to it. If
- # +window_id+ is +nil+, select the main window.
- def select_window window_id
- command 'selectWindow', window_id||'null'
- end
-
- # Simulate selecting the "Back" button.
- def go_back
- command 'goBack'
- end
-
- # Close the current window.
- def close
- command 'close'
- end
-
- # Wait for +milliseconds+.
- def pause milliseconds
- command 'pause', milliseconds
- end
-
- # Send an event to an element.
- # fire_event 'password', 'focus'
- def fire_event element_locator, event_name
- command 'fireEvent', element_locator, event_name
- end
-
- # Wait for an input field to have the specified value.
- def wait_for_value input_locator, value
- command 'waitForValue', input_locator, value
- end
-
- # Store a value into a Selenium value.
- def store value_to_store, variable_name
- command 'store', value_to_store, variable_name
- end
-
- # Store the value of an input field into a Selenium variable.
- def store_value input_locator, variable_name
- command 'storeValue', input_locator, variable_name
- end
-
- # Store the text of an element into a Selenium variable.
- def store_text element_locator, variable_name
- command 'storeText', element_locator, variable_name
- end
-
- # Store the value of an attribute into a Selenium variable.
- def store_attribute element_locator, attribute_name, variable_name
- command('storeAttribute', "#{element_locator}@#{attribute_name}",
- variable_name)
- end
-
- # Tell Selenium to select "Cancel" the next time a confirmation dialog
- # appears.
- def choose_cancel_on_next_confirmation
- command 'chooseCancelOnNextConfirmation'
- end
-
- # Tell Selenium how to answer the next JavaScript prompt.
- def answer_on_next_prompt answer_string
- command 'answerOnNextPrompt', answer_string
- end
-
-end
-
-
-# The checks available for SeleniumOnRails::TestBuilder tests.
-#
-# For each check there exist an +assert+ and a +verify+ version.
-# <code>assert</code>s stop the execution of the test, whereas
-# <code>verify</code>s don't.
-module SeleniumOnRails::TestBuilderChecks
- # Assert that the browser is at the specified location.
- # assert_location '/'
- # assert_location :controller => 'customer', :action => 'list'
- def assert_location relative_location
- command 'assertLocation', url_arg(relative_location)
- end
- # Verify that the browser is at the specified location.
- # verify_location '/'
- # verify_location :controller => 'customer', :action => 'list'
- def verify_location relative_location
- command 'verifyLocation', url_arg(relative_location)
- end
-
- # Assert that the current page's title matches the pattern.
- def assert_title title_pattern
- command 'assertTitle', title_pattern
- end
- # Verify that the current page's title matches the pattern.
- def verify_title title_pattern
- command 'verifyTitle', title_pattern
- end
-
- # Assert the specified input field's value matches the pattern.
- def assert_value input_locator, value_pattern
- command 'assertValue', input_locator, value_pattern
- end
- # Verify the specified input field's value matches the pattern.
- def verify_value input_locator, value_pattern
- command 'verifyValue', input_locator, value_pattern
- end
-
- # Assert that a specific +option+ is chosen in a +select+ field.
- def assert_selected select_locator, option_specifier
- command 'assertSelected', select_locator, option_specifier
- end
- # Verify that a specific +option+ is chosen in a +select+ field.
- def verify_selected select_locator, option_specifier
- command 'verifySelected', select_locator, option_specifier
- end
-
- # Assert that a +select+ field has the specified option labels.
- def assert_select_options select_locator, *option_label_list
- ls = option_label_list.map {|l| l.gsub(/[\\,]/) {|s| "\\#{s}" } }.join(',')
- command 'assertSelectOptions', select_locator, ls
- end
- # Verify that a +select+ field has the specified option labels.
- def verify_select_options select_locator, *option_label_list
- ls = option_label_list.map {|l| l.gsub(/[\\,]/) {|s| "\\#{s}" } }.join(',')
- command 'verifySelectOptions', select_locator, ls
- end
-
- # Assert that an element contains the specified text.
- def assert_text element_locator, text_pattern
- command 'assertText', element_locator, text_pattern
- end
- # Verify that an element contains the specified text.
- def verify_text element_locator, text_pattern
- command 'verifyText', element_locator, text_pattern
- end
-
- # Assert that an attribute contains the specified text.
- def assert_attribute element_locator, attribute_name, value_pattern
- command('assertAttribute', "#{element_locator}@#{attribute_name}",
- value_pattern)
- end
- # Verify that an attribute contains the specified text.
- def verify_attribute element_locator, attribute_name, value_pattern
- command('verifyAttribute', "#{element_locator}@#{attribute_name}",
- value_pattern)
- end
-
- # Assert that the specified text is present somewhere on the page.
- def assert_text_present text
- command 'assertTextPresent', text
- end
- # Verify that the specified text is present somewhere on the page.
- def verify_text_present text
- command 'verifyTextPresent', text
- end
-
- # Assert that the specified text is not present anywhere on the page.
- def assert_text_not_present text
- command 'assertTextNotPresent', text
- end
- # Verify that the specified text is not present anywhere on the page.
- def verify_text_not_present text
- command 'verifyTextNotPresent', text
- end
-
- # Assert that the specified element appears on the page.
- def assert_element_present element_locator
- command 'assertElementPresent', element_locator
- end
- # Verify that the specified element appears on the page.
- def verify_element_present element_locator
- command 'verifyElementPresent', element_locator
- end
-
- # Assert that the specified element does not appear on the page.
- def assert_element_not_present element_locator
- command 'assertElementNotPresent', element_locator
- end
- # Verify that the specified element does not appear on the page.
- def verify_element_not_present element_locator
- command 'verifyElementNotPresent', element_locator
- end
-
- # Assert that the specified table cell contains the specified value.
- def assert_table table_locator, row, column, value_pattern
- command 'assertTable', "#{table_locator}.#{row}.#{column}", value_pattern
- end
- # Verify that the specified table cell contains the specified value.
- def verify_table table_locator, row, column, value_pattern
- command 'verifyTable', "#{table_locator}.#{row}.#{column}", value_pattern
- end
-
- # Assert that the specified element is visible. Checks the
- # +visibility+ and +display+ properties of the
- # element and its parents.
- def assert_visible element_locator
- command 'assertVisible', element_locator
- end
- # Verify that the specified element is visible. Checks the
- # +visibility+ and +display+ properties of the
- # element and its parents.
- def verify_visible element_locator
- command 'verifyVisible', element_locator
- end
-
- # Assert that the specified element is not visible (or is entirely
- # missing).
- def assert_not_visible element_locator
- command 'assertNotVisible', element_locator
- end
- # Verify that the specified element is not visible (or is entirely
- # missing).
- def verify_not_visible element_locator
- command 'verifyNotVisible', element_locator
- end
-
- # Assert that the specified element can be edited.
- def assert_editable input_locator
- command 'assertEditable', input_locator
- end
- # Verify that the specified element can be edited.
- def verify_editable input_locator
- command 'verifyEditable', input_locator
- end
-
- # Assert that the specified element cannot be edited.
- def assert_not_editable input_locator
- command 'assertNotEditable', input_locator
- end
- # Verify that the specified element cannot be edited.
- def verify_not_editable input_locator
- command 'verifyNotEditable', input_locator
- end
-
- # Assert the message of the next alert matches the pattern.
- def assert_alert message_pattern
- command 'assertAlert', message_pattern
- end
- # Verify the message of the next alert matches the pattern.
- def verify_alert message_pattern
- command 'verifyAlert', message_pattern
- end
-
- # Assert the message of the next confirmation matches the pattern.
- def assert_confirmation message_pattern
- command 'assertConfirmation', message_pattern
- end
- # Verify the message of the next confirmation matches the pattern.
- def verify_confirmation message_pattern
- command 'verifyConfirmation', message_pattern
- end
-
- # Assert the message of the next prompt matches the pattern.
- def assert_prompt message_pattern
- command 'assertPrompt', message_pattern
- end
- # Verify the message of the next prompt matches the pattern.
- def verify_prompt message_pattern
- command 'verifyPrompt', message_pattern
- end
-
-end
-
-
# Builds Selenium test table using a high-level Ruby interface. Normally
# invoked through SeleniumOnRails::RSelenese.
#
# See SeleniumOnRails::TestBuilderActions for the available actions and
-# SeleniumOnRails::TestBuilderChecks for the available checks.
+# SeleniumOnRails::TestBuilderAccessors for the available checks.
#
# For more information on the commands supported by TestBuilder, see the
# Selenium Commands Documentation at
-# http://www.openqa.org/selenium/seleniumReference.html.
+# http://release.openqa.org/selenium-core/nightly/reference.html.
class SeleniumOnRails::TestBuilder
include SeleniumOnRails::TestBuilderActions
- include SeleniumOnRails::TestBuilderChecks
+ include SeleniumOnRails::TestBuilderAccessors
# Convert _str_ to a Selenium command name.
- def self.selenize(str)
+ def self.selenize str
str.camelize.gsub(/^[A-Z]/) {|s| s.downcase }
end
+ # Prepends _pattern_ with 'exact:' if it would be considered containing
+ # string-match pattern otherwise.
+ def exactize pattern
+ pattern.include?(':') ? "exact:#{pattern}" : pattern
+ end
+
# Create a new TestBuilder for _view_.
def initialize view
@view = view
@@ -365,21 +45,41 @@ class SeleniumOnRails::TestBuilder
_tdata value
end
end
+ # :nodoc
+ alias_method :command_verbatim, :command
+
+ # Same as _command_ but add _AndWait_ to the name of _cmd_.
+ def command_and_wait cmd, target=nil, value=nil
+ command_verbatim cmd.to_s + 'AndWait', target, value
+ end
- protected
+ # Re routes commands in the provided block to #command_and_wait instead of
+ # #command.
+ def make_command_waiting
+ self.class.send :alias_method, :command, :command_and_wait
+ yield
+ self.class.send :alias_method, :command, :command_verbatim
+ end
+
+protected
# If _url_ is a string, return unchanged. Otherwise, pass it to
# ActionView#UrlHelper#url_for.
def url_arg url
- if url.instance_of?(String) then url else @view.url_for(url) end
+ if url.instance_of?(String) then url else exactize(@view.url_for(url)) end
end
- # If _options_ contains :wait, append +AndWait+ to _name_.
- def name_with_optional_wait name, options
- if options[:wait] then "#{name}AndWait" else name end
+ # If _arg_ is an array formats _arg_ to a textual representation.
+ # Otherwise return unchanged.
+ def collection_arg arg
+ if arg.is_a? Array
+ arg.collect {|e| e.gsub(/[\\,]/) {|s| "\\#{s}" } }.join(',')
+ else
+ arg
+ end
end
- private
+private
# Output a single TD element.
def _tdata value
lib/selenium_on_rails/test_builder.rb
@@ -81,6 +81,7 @@ END
<tr><td>open</td><td>/selenium/setup?keep_session=true</td><td> </td></tr>
<tr><td>open</td><td>/selenium/setup?fixtures=all</td><td> </td></tr>
<tr><td>open</td><td>/selenium/setup?fixtures=foo%2Cbar</td><td> </td></tr>
+ <tr><td>assertAbsoluteLocation</td><td>exact:http://test.host/selenium/setup</td><td> </td></tr>
<tr><td>assertTitle</td><td>selenium</td><td> </td></tr>
<tr><td>assertTitle</td><td>Partial from RSelenese</td><td> </td></tr>
</table>
test/renderer_test.rb
@@ -46,93 +46,329 @@ END
assert_generates_command %w{click //a}, :click, '//a'
end
+ def test_collection_arguments
+ assert_generates_command ['assertAllLinks', 'link1,link2,link3'], :assert_all_links, ['link1', 'link2','link3']
+ assert_generates_command ['assertAllLinks', 'link?,link?,link?'], :assert_all_links, 'link?,link?,link?'
+ end
+
ARG_VALUE_MAP = {
# We can't test url_for style arguments here, because we don't have
# a valid controller to interpret them. See RendererTest.
:url => '/relative/url',
- :element => 'foo', # Also: '//foo', 'document.foo', others.
:string => '1234',
- :option => 'J* Smith', # Also: many other formats.
- :pattern => 'glob:J* Smith' # Also: many other formats.
+ :pattern => 'glob:J* Smith', # Also: many other formats.
+ :variable => 'varname',
+ :locator => 'foo',
+ :script => 'script',
+ :locator_and_attribute_name => [['foo', 'attribute'], 'foo@attribute'],
+ :table_locator => [['table', 2, 4], 'table.2.4'],
+ :coll_pattern => [[['a', "b\\", 'c,']], "a,b\\\\,c\\,"],
+ :event_name => 'eventName',
+ :keycode => 123,
+ :option_locator => 'label=hello',
+ :window_id => [[nil], 'null'],
+ :timeout => 123,
+ :log_level => :debug
}
# Call _command_ with _args_ and make sure it produces a good table.
- # Specify _can_wait_ to test a version of the command with
- # <code>:wait</code>.
- # If the command is an _assert_ command it is also checked to make sure that
- # the corresponding _verify_ command works.
- def assert_command_works command, can_wait, *args
- values = args.map {|a| ARG_VALUE_MAP[a] }
- name = SeleniumOnRails::TestBuilder.selenize(command.to_s)
- assert_generates_command [name]+values, command, *values
- if can_wait
- assert_generates_command(["#{name}AndWait"]+values,
- command, *(values+[{:wait => true}]))
+ # If the input command doesn't 'selenize' cleanly (e.g. if the input command
+ # is :do_foo and the expected result is +dofoo+ and not +doFoo+) +command+
+ # can be specified as an array (e.g. +[:input_command, 'expectedResult']).
+ def assert_command_works command, *args
+ expected_values = args.inject([]) do |c, arg|
+ v = ARG_VALUE_MAP[arg]
+ if v.is_a? Array
+ c << v[1]
+ else
+ c << v
+ end
end
- if command.to_s.starts_with? 'assert'
- assert_command_works command.to_s.sub('assert', 'verify'), can_wait, *args
+ input_values = args.inject([]) do |c, arg|
+ v = ARG_VALUE_MAP[arg]
+ if v.is_a? Array
+ c.concat v[0]
+ else
+ c << v
+ end
end
+ input_name, expected_name = (command.is_a?(Array) ? command : [command, SeleniumOnRails::TestBuilder.selenize(command.to_s)])
+ assert_generates_command [expected_name]+expected_values, input_name.to_s, *input_values
end
- def test_simple_commands
- assert_command_works :open, false, :url
- assert_command_works :type, true, :element, :string
- assert_command_works :select, true, :element, :option
- assert_command_works :select_window, false, :string
- assert_command_works :go_back, false
- assert_command_works :close, false
- assert_command_works :pause, false, :string
- assert_command_works :fire_event, false, :element, :string
- assert_command_works :wait_for_value, false, :element, :string
- assert_command_works :store, false, :string, :string
- assert_command_works :store_value, false, :element, :string
- assert_command_works :store_text, false, :element, :string
- assert_command_works :choose_cancel_on_next_confirmation, false
- assert_command_works :answer_on_next_prompt, false, :string
- assert_command_works :assert_location, false, :url
- assert_command_works :assert_title, false, :string
- assert_command_works :assert_value, false, :element, :pattern
- assert_command_works :assert_selected, false, :element, :option
- assert_command_works :assert_text, false, :element, :pattern
- assert_command_works :assert_text_present, false, :string
- assert_command_works :assert_text_not_present, false, :string
- assert_command_works :assert_element_present, false, :element
- assert_command_works :assert_element_not_present, false, :element
- assert_command_works :assert_visible, false, :element
- assert_command_works :assert_not_visible, false, :element
- assert_command_works :assert_editable, false, :element
- assert_command_works :assert_not_editable, false, :element
- assert_command_works :assert_alert, false, :pattern
- assert_command_works :assert_confirmation, false, :pattern
- assert_command_works :assert_prompt, false, :pattern
+ def test_action_commands
+ assert_command_works :click, :locator
+ assert_command_works :click_and_wait, :locator
+ assert_command_works :fire_event, :locator, :event_name
+ assert_command_works :fire_event_and_wait, :locator, :event_name
+ assert_command_works :key_press, :locator, :keycode
+ assert_command_works :key_press_and_wait, :locator, :keycode
+ assert_command_works :key_down, :locator, :keycode
+ assert_command_works :key_down_and_wait, :locator, :keycode
+ assert_command_works :key_up, :locator, :keycode
+ assert_command_works :key_up_and_wait, :locator, :keycode
+ assert_command_works :mouse_over, :locator
+ assert_command_works :mouse_over_and_wait, :locator
+ assert_command_works :mouse_down, :locator
+ assert_command_works :mouse_down_and_wait, :locator
+ assert_command_works :type, :locator, :string
+ assert_command_works :type_and_wait, :locator, :string
+ assert_command_works :check, :locator
+ assert_command_works :check_and_wait, :locator
+ assert_command_works :uncheck, :locator
+ assert_command_works :uncheck_and_wait, :locator
+ assert_command_works :select, :locator, :option_locator
+ assert_command_works :select_and_wait, :locator, :option_locator
+ assert_command_works :add_selection, :locator, :option_locator
+ assert_command_works :add_selection_and_wait, :locator, :option_locator
+ assert_command_works :remove_selection, :locator, :option_locator
+ assert_command_works :remove_selection_and_wait, :locator, :option_locator
+ assert_command_works :submit, :locator
+ assert_command_works :open, :url
+ assert_command_works :select_window, :window_id
+ assert_command_works [:wait_for_popup, 'waitForPopUp'], :window_id, :timeout
+ assert_command_works :choose_cancel_on_next_confirmation
+ assert_command_works :choose_cancel_on_next_confirmation_and_wait
+ assert_command_works :answer_on_next_prompt, :string
+ assert_command_works :answer_on_next_prompt_and_wait, :string
+ assert_command_works :go_back
+ assert_command_works :refresh
+ assert_command_works :close
+ assert_command_works :set_context, :string
+ assert_command_works :set_context, :string, :log_level
+ assert_command_works :wait_for_condition, :script, :timeout
+ assert_command_works :set_timeout, :timeout
+ assert_command_works :wait_for_page_to_load, :timeout
end
- def test_select_window_should_support_nil
- assert_generates_command %w{selectWindow null}, :select_window, nil
- end
+ def test_accessor_commands
+ assert_command_works :store_alert_present, :variable
+ assert_command_works :assert_alert_present
+ assert_command_works :assert_alert_not_present
+ assert_command_works :verify_alert_present
+ assert_command_works :verify_alert_not_present
+ assert_command_works :wait_for_alert_present
+ assert_command_works :wait_for_alert_not_present
- def test_command_store_attribute
- assert_generates_command(%w{storeAttribute foo@bar baz},
- :store_attribute, 'foo', 'bar', 'baz')
- end
+ assert_command_works :store_prompt_present, :variable
+ assert_command_works :assert_prompt_present
+ assert_command_works :assert_prompt_not_present
+ assert_command_works :verify_prompt_present
+ assert_command_works :verify_prompt_not_present
+ assert_command_works :wait_for_prompt_present
+ assert_command_works :wait_for_prompt_not_present
- def test_command_assert_select_options
- # Use double-quoted strings so we can keep track of escape sequences
- # without remembering Ruby-specific rules.
- assert_generates_command(['assertSelectOptions','sel',"foo,bar\\,\\\\baz"],
- :assert_select_options, 'sel', 'foo', "bar,\\baz")
- end
+ assert_command_works :store_confirmation_present, :variable
+ assert_command_works :assert_confirmation_present
+ assert_command_works :assert_confirmation_not_present
+ assert_command_works :verify_confirmation_present
+ assert_command_works :verify_confirmation_not_present
+ assert_command_works :wait_for_confirmation_present
+ assert_command_works :wait_for_confirmation_not_present
- def test_command_assert_attribute
- assert_generates_command(%w{assertAttribute foo@bar baz},
- :assert_attribute, 'foo', 'bar', 'baz')
- end
+ assert_command_works :store_alert, :variable
+ assert_command_works :assert_alert, :pattern
+ assert_command_works :assert_not_alert, :pattern
+ assert_command_works :verify_alert, :pattern
+ assert_command_works :verify_not_alert, :pattern
+ assert_command_works :wait_for_alert, :pattern
+ assert_command_works :wait_for_not_alert, :pattern
+
+ assert_command_works :store_confirmation, :variable
+ assert_command_works :assert_confirmation, :pattern
+ assert_command_works :assert_not_confirmation, :pattern
+ assert_command_works :verify_confirmation, :pattern
+ assert_command_works :verify_not_confirmation, :pattern
+ assert_command_works :wait_for_confirmation, :pattern
+ assert_command_works :wait_for_not_confirmation, :pattern
+
+ assert_command_works :store_prompt, :variable
+ assert_command_works :assert_prompt, :pattern
+ assert_command_works :assert_not_prompt, :pattern
+ assert_command_works :verify_prompt, :pattern
+ assert_command_works :verify_not_prompt, :pattern
+ assert_command_works :wait_for_prompt, :pattern
+ assert_command_works :wait_for_not_prompt, :pattern
+
+ assert_command_works :store_absolute_location, :variable
+ assert_command_works :assert_absolute_location, :url
+ assert_command_works :assert_not_absolute_location, :url
+ assert_command_works :verify_absolute_location, :url
+ assert_command_works :verify_not_absolute_location, :url
+ assert_command_works :wait_for_absolute_location, :url
+ assert_command_works :wait_for_not_absolute_location, :url
+
+ assert_command_works :store_location, :pattern, :variable
+ assert_command_works :assert_location, :url
+ assert_command_works :assert_not_location, :url
+ assert_command_works :verify_location, :url
+ assert_command_works :verify_not_location, :url
+ assert_command_works :wait_for_location, :url
+ assert_command_works :wait_for_not_location, :url
+
+ assert_command_works :store_title, :variable
+ assert_command_works :assert_title, :pattern
+ assert_command_works :assert_not_title, :pattern
+ assert_command_works :verify_title, :pattern
+ assert_command_works :verify_not_title, :pattern
+ assert_command_works :wait_for_title, :pattern
+ assert_command_works :wait_for_not_title, :pattern
+
+ assert_command_works :store_body_text, :variable
+ assert_command_works :assert_body_text, :pattern
+ assert_command_works :assert_not_body_text, :pattern
+ assert_command_works :verify_body_text, :pattern
+ assert_command_works :verify_not_body_text, :pattern
+ assert_command_works :wait_for_body_text, :pattern
+ assert_command_works :wait_for_not_body_text, :pattern
+
+ assert_command_works :store_value, :locator, :variable
+ assert_command_works :assert_value, :locator, :pattern
+ assert_command_works :assert_not_value, :locator, :pattern
+ assert_command_works :verify_value, :locator, :pattern
+ assert_command_works :verify_not_value, :locator, :pattern
+ assert_command_works :wait_for_value, :locator, :pattern
+ assert_command_works :wait_for_not_value, :locator, :pattern
+
+ assert_command_works :store_text, :locator, :variable
+ assert_command_works :assert_text, :locator, :pattern
+ assert_command_works :assert_not_text, :locator, :pattern
+ assert_command_works :verify_text, :locator, :pattern
+ assert_command_works :verify_not_text, :locator, :pattern
+ assert_command_works :wait_for_text, :locator, :pattern
+ assert_command_works :wait_for_not_text, :locator, :pattern
+
+ assert_command_works :store_eval, :script, :variable
+ assert_command_works :assert_eval, :script, :pattern
+ assert_command_works :assert_not_eval, :script, :pattern
+ assert_command_works :verify_eval, :script, :pattern
+ assert_command_works :verify_not_eval, :script, :pattern
+ assert_command_works :wait_for_eval, :script, :pattern
+ assert_command_works :wait_for_not_eval, :script, :pattern
+
+ assert_command_works :store_checked, :locator, :variable
+ assert_command_works :assert_checked, :locator, :pattern
+ assert_command_works :assert_not_checked, :locator, :pattern
+ assert_command_works :verify_checked, :locator, :pattern
+ assert_command_works :verify_not_checked, :locator, :pattern
+ assert_command_works :wait_for_checked, :locator, :pattern
+ assert_command_works :wait_for_not_checked, :locator, :pattern
- def test_command_assert_table
- assert_generates_command(%w{assertTable foo.2.3 bar},
- :assert_table, 'foo', 2, 3, 'bar')
+ assert_command_works :store_table, :table_locator, :variable
+ assert_command_works :assert_table, :table_locator, :pattern
+ assert_command_works :assert_not_table, :table_locator, :pattern
+ assert_command_works :verify_table, :table_locator, :pattern
+ assert_command_works :verify_not_table, :table_locator, :pattern
+ assert_command_works :wait_for_table, :table_locator, :pattern
+ assert_command_works :wait_for_not_table, :table_locator, :pattern
+
+ assert_raise RuntimeError do
+ assert_command_works :store_selected, :locator, :option_locator, :variable
+ end
+ assert_command_works :assert_selected, :locator, :option_locator
+ assert_command_works :assert_not_selected, :locator, :option_locator
+ assert_command_works :verify_selected, :locator, :option_locator
+ assert_command_works :verify_not_selected, :locator, :option_locator
+ assert_command_works :wait_for_selected, :locator, :option_locator
+ assert_command_works :wait_for_not_selected, :locator, :option_locator
+
+ assert_command_works :store_selected_options, :locator, :variable
+ assert_command_works :assert_selected_options, :locator, :coll_pattern
+ assert_command_works :assert_not_selected_options, :locator, :coll_pattern
+ assert_command_works :verify_selected_options, :locator, :coll_pattern
+ assert_command_works :verify_not_selected_options, :locator, :coll_pattern
+ assert_command_works :wait_for_selected_options, :locator, :coll_pattern
+ assert_command_works :wait_for_not_selected_options, :locator, :coll_pattern
+
+ assert_command_works :store_select_options, :locator, :variable
+ assert_command_works :assert_select_options, :locator, :coll_pattern
+ assert_command_works :assert_not_select_options, :locator, :coll_pattern
+ assert_command_works :verify_select_options, :locator, :coll_pattern
+ assert_command_works :verify_not_select_options, :locator, :coll_pattern
+ assert_command_works :wait_for_select_options, :locator, :coll_pattern
+ assert_command_works :wait_for_not_select_options, :locator, :coll_pattern
+
+ assert_command_works :store_attribute, :locator_and_attribute_name, :variable
+ assert_command_works :assert_attribute, :locator_and_attribute_name, :pattern
+ assert_command_works :assert_not_attribute, :locator_and_attribute_name, :pattern
+ assert_command_works :verify_attribute, :locator_and_attribute_name, :pattern
+ assert_command_works :verify_not_attribute, :locator_and_attribute_name, :pattern
+ assert_command_works :wait_for_attribute, :locator_and_attribute_name, :pattern
+ assert_command_works :wait_for_not_attribute, :locator_and_attribute_name, :pattern
+
+ assert_command_works :store_text_present, :pattern, :variable
+ assert_command_works :assert_text_present, :pattern
+ assert_command_works :assert_text_not_present, :pattern
+ assert_command_works :verify_text_present, :pattern
+ assert_command_works :verify_text_not_present, :pattern
+ assert_command_works :wait_for_text_present, :pattern
+ assert_command_works :wait_for_text_not_present, :pattern
+
+ assert_command_works :store_element_present, :locator, :variable
+ assert_command_works :assert_element_present, :locator
+ assert_command_works :assert_element_not_present, :locator
+ assert_command_works :verify_element_present, :locator
+ assert_command_works :verify_element_not_present, :locator
+ assert_command_works :wait_for_element_present, :locator
+ assert_command_works :wait_for_element_not_present, :locator
+
+ assert_command_works :store_visible, :locator, :variable
+ assert_command_works :assert_visible, :locator
+ assert_command_works :assert_not_visible, :locator
+ assert_command_works :verify_visible, :locator
+ assert_command_works :verify_not_visible, :locator
+ assert_command_works :wait_for_visible, :locator
+ assert_command_works :wait_for_not_visible, :locator
+
+ assert_command_works :store_editable, :locator, :variable
+ assert_command_works :assert_editable, :locator
+ assert_command_works :assert_not_editable, :locator
+ assert_command_works :verify_editable, :locator
+ assert_command_works :verify_not_editable, :locator
+ assert_command_works :wait_for_editable, :locator
+ assert_command_works :wait_for_not_editable, :locator
+
+ assert_command_works :store_all_buttons, :variable
+ assert_command_works :assert_all_buttons, :coll_pattern
+ assert_command_works :assert_not_all_buttons, :coll_pattern
+ assert_command_works :verify_all_buttons, :coll_pattern
+ assert_command_works :verify_not_all_buttons, :coll_pattern
+ assert_command_works :wait_for_all_buttons, :coll_pattern
+ assert_command_works :wait_for_not_all_buttons, :coll_pattern
+
+ assert_command_works :store_all_links, :variable
+ assert_command_works :assert_all_links, :coll_pattern
+ assert_command_works :assert_not_all_links, :coll_pattern
+ assert_command_works :verify_all_links, :coll_pattern
+ assert_command_works :verify_not_all_links, :coll_pattern
+ assert_command_works :wait_for_all_links, :coll_pattern
+ assert_command_works :wait_for_not_all_links, :coll_pattern
+
+ assert_command_works :store_all_fields, :variable
+ assert_command_works :assert_all_fields, :coll_pattern
+ assert_command_works :assert_not_all_fields, :coll_pattern
+ assert_command_works :verify_all_fields, :coll_pattern
+ assert_command_works :verify_not_all_fields, :coll_pattern
+ assert_command_works :wait_for_all_fields, :coll_pattern
+ assert_command_works :wait_for_not_all_fields, :coll_pattern
+
+ assert_command_works :store_html_source, :variable
+ assert_command_works :assert_html_source, :pattern
+ assert_command_works :assert_not_html_source, :pattern
+ assert_command_works :verify_html_source, :pattern
+ assert_command_works :verify_not_html_source, :pattern
+ assert_command_works :wait_for_html_source, :pattern
+ assert_command_works :wait_for_not_html_source, :pattern
+
+ assert_command_works :store_expression, :script, :variable
+ assert_command_works :assert_expression, :script, :pattern
+ assert_command_works :assert_not_expression, :script, :pattern
+ assert_command_works :verify_expression, :script, :pattern
+ assert_command_works :verify_not_expression, :script, :pattern
+ assert_command_works :wait_for_expression, :script, :pattern
+ assert_command_works :wait_for_not_expression, :script, :pattern
end
-
+
def test_partial_support
expected = <<END
<table>
test/rselenese_test.rb
@@ -2,5 +2,6 @@ setup
setup :keep_session
test.setup :fixtures => :all
setup :fixtures => [:foo, 'bar']
+assert_absolute_location :controller => 'selenium', :action => 'setup' #urls must be tested with a controller
assert_title view.controller.controller_name #make sure we can access the view easily
-include_partial 'partial', :source => 'RSelenese'
\ No newline at end of file
+include_partial 'partial', :source => 'RSelenese'
test_data/rselenese.rsel
doc/classes/SeleniumOnRails/TestBuilderChecks.html
c5b37d289c9a03844d4a0fae9363e8573fda80f5
Jonas
Jonas@9274398c-e119-0410-8437-aa71ef7847aa
http://github.com/fnando/selenium-on-rails/commit/980d2ba343e32fc943cacfed40ec4d5f5dd10853
980d2ba343e32fc943cacfed40ec4d5f5dd10853
2006-07-31T15:06:35-07:00
2006-07-31T15:06:35-07:00
r828@D600 (orig r13): dev | 2006-06-06 12:03:24 +0100
Added support for Selenium Core 0.7
Added rcov task
git-svn-id: https://svn.openqa.org/svn/selenium-on-rails/trunk@14 9274398c-e119-0410-8437-aa71ef7847aa
d9f9b85f3ece0f680d8b6049476beb23b8336e81
Jonas
Jonas@9274398c-e119-0410-8437-aa71ef7847aa