added some preliminary documentation about transactional fixtures

This commit is contained in:
Jo Liss 2011-04-14 15:39:34 +02:00
parent ef3a4d6c25
commit b7a460c5a4
1 changed files with 20 additions and 0 deletions

View File

@ -194,6 +194,9 @@ Ajax requests to finish after you've interacted with the page. You can switch
off this behaviour by setting the driver option <tt>:resynchronize</tt> to
<tt>false</tt>. See the section on configuring drivers.
Note: Selenium does not support transactional fixtures; see the section
"Transactional Fixtures" below.
=== HtmlUnit
There are three different drivers, maintained as external gems, that you can
@ -210,6 +213,9 @@ use to drive {HtmlUnit}[http://htmlunit.sourceforge.net/]:
as noted above, and make sure that JRuby is in your path. Note that Culerity
does not seem to be working under Ruby 1.9 at the moment.
Note: HtmlUnit does not support transactional fixtures; see the section
"Transactional Fixtures" below.
=== env.js
The {capybara-envjs driver}[http://github.com/smparkes/capybara-envjs]
@ -222,6 +228,9 @@ JavaScript outside the browser. The driver is installed by installing the capyba
More info about the driver and env.js are available through the links above. The envjs gem only supports
Ruby 1.8.7 at this time.
Note: Envjs does not support transactional fixtures; see the section
"Transactional Fixtures" below.
== The DSL
Capybara's DSL (domain-specific language) is inspired by Webrat. While
@ -381,6 +390,17 @@ look at it:
save_and_open_page
== Transactional fixtures
Transactional fixtures only work in the default Rack::Test driver, but not for
other drivers like Selenium. Cucumber takes care of this automatically, but
with Test::Unit or RSpec, you may have to use the
{database_cleaner}[https://github.com/bmabey/database_cleaner] gem. See {this
explanation}[https://groups.google.com/d/msg/ruby-capybara/JI6JrirL9gM/R6YiXj4gi_UJ]
(and code for {solution
2}[http://opinionated-programmer.com/2011/02/capybara-and-selenium-with-rspec-and-rails-3/#comment-220]
and {solution 3}[http://pastie.org/1745020]) for details.
== Asynchronous JavaScript (Ajax and friends)
When working with asynchronous JavaScript, you might come across situations