[ANN] assert{ 2.0 } 0.4.8 unit-tests Ajax using assert_rjs syntax + assert_xhtml
Phlip
assert{ 2.0 } now contains "alpha" replacements for these assertions from the
"arts" project:
assert_rjs_ :alert, 'This is an alert'
assert_rjs_ :call, 'foo', 'bar', /baz/ # matches foo("bar", "baz")
assert_rjs_ :remove, 'offending_div'
assert_rjs_ :replace, 'person_45', '<div>This replaces person_45</div>'
assert_rjs_ :replace_html, :label_7, /Top_Ranking/
Notice these assertions are not yet drop-in compatible with assert_rjs classic -
hence the trailing _. More replacements are naturally forthcoming.
The improvement is they use racc and rkelly, which form a real JavaScript lexer.
This solution is much better than Regexp (and better than certain lexers I have
tried in the past!). The assertion is more accurate, so it can use both Regexp
and assert_xhtml to pin down each important detail of generated JavaScript.
One common Ajax scenario revolves around sending Element.update() commands
containing the output of View partials. These can be very complex, so testing
them _before_ they get into a real web browser can be mission-critical. The
following test intercepts an Element.update("staff_access", "..."), where the
"..." contains an entire <form>. (Not my idea, but you must admit it gets the
job done!)
Everything inside the do...end blocks is assert_xhtml notation ( described here:
http://assert2.rubyforge.org/svn/README ). The assert_rjs_ intercepted the "..."
payload, interpreted it, and rendered it as HTML. This allows us to test that
secret payload just as freely as we would have tested HTML after a simple GET:
def test_deleting_a_staff_sets_active_flag_to_false_instead_of_destroying_it
aaron = staff(:aaron)
xhr :post, :xhr_delete_staff, :staff_id => aaron.id
assert_rjs_ :replace_html, :staff_list, /quentin/ do
form :name => :staff_access, :verbose! => true do
without!{ tr :id => "staff_#{ aaron.id }" }
end
end
assert{ Staff.find_by_id(aaron.id).active? == false }
end
The test shows :verbose! => true - use it to get a glimpse of your actual HTML
partial, without all the JavaScript delimiters cluttering it up.
The test also shows without!{} testing that aaron did indeed disappear from the
form.
Both :replace and :replace_html use this syntax. If anyone needs any other
"arts" assertion here - or even a new kind of JS assertion - ping me and I will
add it.
Get assert_rjs_ with:
gem install racc rkelly nokogiri assert2
require 'assert2/rjs'
(Note that assert2 contains more than one reusable module, so it does not
automatically require every dependency. This lets you only install the gems you
need...)
--
Phlip