Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
branch: master
Fetching contributors…

Cannot retrieve contributors at this time

82 lines (65 sloc) 4.362 kb
---
assert_select: |-
Selectors
* any element
E an element of type E
E.warning an E element whose class is "warning" (the document language specifies how class is determined).
E#myid an E element with ID equal to "myid".
E[foo] an E element with a "foo" attribute
E[foo="bar"] an E element whose "foo" attribute value is exactly equal to "bar"
E[foo~="bar"] an E element whose "foo" attribute value is a list of space-separated values, one of which is exactly equal to "bar"
E[foo^="bar"] an E element whose "foo" attribute value begins exactly with the string "bar"
E[foo$="bar"] an E element whose "foo" attribute value ends exactly with the string "bar"
E[foo*="bar"] an E element whose "foo" attribute value contains the substring "bar"
E[hreflang|="en"] an E element whose "hreflang" attribute has a hyphen-separated list of values beginning (from the left) with "en"
E:root an E element, root of the document
E:nth-child(n) an E element, the n-th child of its parent
E:nth-last-child(n) an E element, the n-th child of its parent, counting from the last one
E:nth-of-type(n) an E element, the n-th sibling of its type
E:nth-last-of-type(n) an E element, the n-th sibling of its type, counting from the last one
E:first-child an E element, first child of its parent
E:last-child an E element, last child of its parent
E:first-of-type an E element, first sibling of its type
E:last-of-type an E element, last sibling of its type
E:only-child an E element, only child of its parent
E:only-of-type an E element, only sibling of its type
E:empty an E element that has no children (including text nodes)
E:not(s) an E element that does not match simple selector s
E F an F element descendant of an E element
E > F an F element child of an E element
E + F an F element immediately preceded by an E element
E ~ F an F element preceded by an E element
Substitution values
.? Class name
#? ID attribute
[foo=?] Attribute value
May be string or regular expression, e.g. "[foo=?]", /bar/i
assert_select(selector, equality?, message?) { |elems| ... }
assert_select(element, selector, equality?, message?) { |elems| ... }
Use selector to select elements from response page or first argument (element), and evalute
equality test. Raises exception with message if equality test fails.
Equality tests include:
true At least one element found (:minimum=>1)
false No element found (:count=>0)
text, :text=>text All elements found have the text contents (string or regexp)
n, :count=>n Exactly n elements found
:minimum=>n At least n elements found
:maximum=>n At most n elements found
n..m Between n and m elements found
If no count specified, :minimum=>1 assumed.
If no count specified, default is :minimum=>1.
With block, calls block with all selected elements. Calling assert_select (or any of the other
functions) within that block operates on element selected by outer block.
assert_select_rjs(id?) { |elems| ... }
assert_select_rjs(statement, id?) { |elems| ... }
assert_select_rjs(:insert, position, id?) { |elems| ... }
Asserts that RJS statement updates/inserts HTML content and allows nested assertions on the content.
With id, selects only RJS statement affecting elements with that id. With statement, RJS statements
that :replace, :replace_html or :insert. With :insert can limit position (:before, :after, etc).
assert_select_email() { |elems| ... }
Assertions on the (HTML) body of the delivered e-mail.
assert_select_encoded(element?) { |elems| ... }
For operating on encoded HTML (e.g. RSS item description).
css_select(selector) => array
css_select(element, selector) => array
Returns an array with selected elements (empty if no elements selected).
Jump to Line
Something went wrong with that request. Please try again.