2016-03-07 19:52:19 -05:00
# frozen_string_literal: true
2018-02-28 19:11:41 -05:00
2016-01-06 20:11:00 -05:00
require 'spec_helper'
RSpec . describe Capybara do
describe 'Selectors' do
let :string do
Capybara . string <<-STRING
< html >
< head >
< title > selectors < / title>
< / head>
< body >
< div class = " a " id = " page " >
< div class = " b " id = " content " >
< h1 class = " a " > Totally awesome < / h1>
< p > Yes it is < / p>
< / div>
2018-05-29 19:46:04 -04:00
< p class = " b c " > Some Content < / p>
< p class = " b d " > < / p>
2016-01-06 20:11:00 -05:00
< / div>
2016-09-22 19:55:54 -04:00
< div id = " # special " >
< / div>
2018-05-26 13:26:44 -04:00
< div class = " some random words " id = " random_words " >
Something
< / div>
2016-09-22 19:55:54 -04:00
< input id = " 2checkbox " class = " 2checkbox " type = " checkbox " / >
2016-03-24 14:18:12 -04:00
< input type = " radio " / >
2016-09-22 19:55:54 -04:00
< label for = " my_text_input " > My Text Input < / label>
< input type = " text " name = " form[my_text_input] " placeholder = " my text " id = " my_text_input " / >
< input type = " file " id = " file " class = " .special file " / >
2016-10-02 21:28:52 -04:00
< input type = " hidden " id = " hidden_field " value = " this is hidden " / >
2018-04-11 12:23:59 -04:00
< input type = " submit " value = " click me " title = " submit button " / >
2016-03-24 14:18:12 -04:00
< a href = " # " > link < / a>
< fieldset > < / fieldset>
2016-10-05 18:16:00 -04:00
< select id = " select " >
2016-03-24 14:18:12 -04:00
< option value = " a " > A < / option>
2016-03-24 17:50:42 -04:00
< option value = " b " disabled > B < / option>
< option value = " c " selected > C < / option>
2016-03-24 14:18:12 -04:00
< / select>
< table >
< tr > < td > < / td>< / tr >
2018-05-26 13:26:44 -04:00
< / table>
2016-01-06 20:11:00 -05:00
< / body>
< / html>
STRING
end
before do
Capybara . add_selector :custom_selector do
css { | css_class | " div. #{ css_class } " }
2018-05-29 17:02:03 -04:00
node_filter ( :not_empty , boolean : true , default : true , skip_if : :all ) { | node , value | value ^ ( node . text == '' ) }
2016-01-06 20:11:00 -05:00
end
2016-09-22 19:55:54 -04:00
Capybara . add_selector :custom_css_selector do
css { | selector | selector }
end
2018-05-26 13:26:44 -04:00
Capybara . add_selector :custom_xpath_selector do
xpath { | selector | selector }
end
2016-01-06 20:11:00 -05:00
end
2018-05-29 17:02:03 -04:00
it " supports `filter` as an alias for `node_filter` " do
expect do
Capybara . add_selector :filter_alias_selector do
2018-05-29 19:46:04 -04:00
css { | _unused | " div " }
2018-05-29 17:02:03 -04:00
filter ( :something ) { | _node , _value | true }
end
end . not_to raise_error
end
2016-10-02 21:28:52 -04:00
describe " adding a selector " do
it " can set default visiblity " do
Capybara . add_selector :hidden_field do
visible :hidden
2018-02-28 19:11:41 -05:00
css { | _sel | 'input[type="hidden"]' }
2016-10-02 21:28:52 -04:00
end
expect ( string ) . to have_no_css ( 'input[type="hidden"]' )
expect ( string ) . to have_selector ( :hidden_field )
end
end
2016-02-01 12:03:47 -05:00
describe " modify_selector " do
2016-01-06 20:11:00 -05:00
it " allows modifying a selector " do
el = string . find ( :custom_selector , 'a' )
expect ( el . tag_name ) . to eq 'div'
Capybara . modify_selector :custom_selector do
css { | css_class | " h1. #{ css_class } " }
end
el = string . find ( :custom_selector , 'a' )
expect ( el . tag_name ) . to eq 'h1'
end
it " doesn't change existing filters " do
Capybara . modify_selector :custom_selector do
2018-02-28 19:11:41 -05:00
css { | css_class | " p. #{ css_class } " }
2016-01-06 20:11:00 -05:00
end
expect ( string ) . to have_selector ( :custom_selector , 'b' , count : 1 )
expect ( string ) . to have_selector ( :custom_selector , 'b' , not_empty : false , count : 1 )
expect ( string ) . to have_selector ( :custom_selector , 'b' , not_empty : :all , count : 2 )
end
end
2016-03-24 14:18:12 -04:00
2016-03-24 17:50:42 -04:00
describe " builtin selectors " do
context " when locator is nil " do
it " devolves to just finding element types " do
selectors = {
field : " .//*[self::input | self::textarea | self::select][not(./@type = 'submit' or ./@type = 'image' or ./@type = 'hidden')] " ,
fieldset : " .//fieldset " ,
link : " .//a[./@href] " ,
2018-02-28 19:11:41 -05:00
link_or_button : " .//a[./@href] | .//input[./@type = 'submit' or ./@type = 'reset' or ./@type = 'image' or ./@type = 'button'] | .//button " ,
2016-03-24 17:50:42 -04:00
fillable_field : " .//*[self::input | self::textarea][not(./@type = 'submit' or ./@type = 'image' or ./@type = 'radio' or ./@type = 'checkbox' or ./@type = 'hidden' or ./@type = 'file')] " ,
radio_button : " .//input[./@type = 'radio'] " ,
checkbox : " .//input[./@type = 'checkbox'] " ,
select : " .//select " ,
option : " .//option " ,
file_field : " .//input[./@type = 'file'] " ,
table : " .//table "
}
selectors . each do | selector , xpath |
2018-02-28 19:11:41 -05:00
results = string . all ( selector , nil ) . to_a . map ( & :native )
2016-03-24 17:50:42 -04:00
expect ( results . size ) . to be > 0
expect ( results ) . to eq string . all ( :xpath , xpath ) . to_a . map ( & :native )
end
end
end
2016-09-23 12:56:07 -04:00
context " with :id option " do
2016-09-22 19:55:54 -04:00
it " works with compound css selectors " do
expect ( string . all ( :custom_css_selector , " div, h1 " , id : 'page' ) . size ) . to eq 1
expect ( string . all ( :custom_css_selector , " h1, div " , id : 'page' ) . size ) . to eq 1
end
it " works with 'special' characters " do
expect ( string . find ( :custom_css_selector , " div " , id : " # special " ) [ :id ] ) . to eq '#special'
expect ( string . find ( :custom_css_selector , " input " , id : " 2checkbox " ) [ :id ] ) . to eq '2checkbox'
end
2018-05-26 13:26:44 -04:00
it " accepts XPath expression for xpath based selectors " do
expect ( string . find ( :custom_xpath_selector , './/div' , id : XPath . contains ( 'peci' ) ) [ :id ] ) . to eq '#special'
expect ( string . find ( :custom_xpath_selector , './/input' , id : XPath . ends_with ( 'box' ) ) [ :id ] ) . to eq '2checkbox'
end
it " errors XPath expression for CSS based selectors " do
expect { string . find ( :custom_css_selector , " div " , id : XPath . contains ( 'peci' ) ) }
. to raise_error ( ArgumentError , / not supported / )
end
2016-09-22 19:55:54 -04:00
end
2016-09-23 12:56:07 -04:00
context " with :class option " do
2016-09-22 19:55:54 -04:00
it " works with compound css selectors " do
expect ( string . all ( :custom_css_selector , " div, h1 " , class : 'a' ) . size ) . to eq 2
expect ( string . all ( :custom_css_selector , " h1, div " , class : 'a' ) . size ) . to eq 2
end
2018-05-29 19:46:04 -04:00
it " handles negated classes " do
expect ( string . all ( :custom_css_selector , " div, p " , class : [ 'b' , '!c' ] ) . size ) . to eq 2
expect ( string . all ( :custom_css_selector , " div, p " , class : [ '!c' , '!d' , 'b' ] ) . size ) . to eq 1
expect ( string . all ( :custom_xpath_selector , XPath . descendant ( :div , :p ) , class : [ 'b' , '!c' ] ) . size ) . to eq 2
expect ( string . all ( :custom_xpath_selector , XPath . descendant ( :div , :p ) , class : [ '!c' , '!d' , 'b' ] ) . size ) . to eq 1
end
2016-09-22 19:55:54 -04:00
it " works with 'special' characters " do
expect ( string . find ( :custom_css_selector , " input " , class : " .special " ) [ :id ] ) . to eq 'file'
expect ( string . find ( :custom_css_selector , " input " , class : " 2checkbox " ) [ :id ] ) . to eq '2checkbox'
end
2018-05-26 13:26:44 -04:00
it " accepts XPath expression for xpath based selectors " do
expect ( string . find ( :custom_xpath_selector , './/div' , class : XPath . contains ( 'dom wor' ) ) [ :id ] ) . to eq 'random_words'
expect ( string . find ( :custom_xpath_selector , './/div' , class : XPath . ends_with ( 'words' ) ) [ :id ] ) . to eq 'random_words'
end
it " errors XPath expression for CSS based selectors " do
expect { string . find ( :custom_css_selector , " div " , class : XPath . contains ( 'random' ) ) }
. to raise_error ( ArgumentError , / not supported / )
end
2016-09-22 19:55:54 -04:00
end
# :css, :xpath, :id, :field, :fieldset, :link, :button, :link_or_button, :fillable_field, :radio_button, :checkbox, :select,
# :option, :file_field, :label, :table, :frame
describe " :css selector " do
it " finds by CSS locator " do
expect ( string . find ( :css , " input # my_text_input " ) [ :name ] ) . to eq 'form[my_text_input]'
end
end
describe " :xpath selector " do
it " finds by XPath locator " do
expect ( string . find ( :xpath , './/input[@id="my_text_input"]' ) [ :name ] ) . to eq 'form[my_text_input]'
end
end
describe " :id selector " do
it " finds by locator " do
expect ( string . find ( :id , " my_text_input " ) [ :name ] ) . to eq 'form[my_text_input]'
end
end
describe " :field selector " do
it " finds by locator " do
expect ( string . find ( :field , 'My Text Input' ) [ :id ] ) . to eq 'my_text_input'
expect ( string . find ( :field , 'my_text_input' ) [ :id ] ) . to eq 'my_text_input'
expect ( string . find ( :field , 'form[my_text_input]' ) [ :id ] ) . to eq 'my_text_input'
end
it " finds by id " do
expect ( string . find ( :field , id : 'my_text_input' ) [ :name ] ) . to eq 'form[my_text_input]'
end
it " finds by name " do
expect ( string . find ( :field , name : 'form[my_text_input]' ) [ :id ] ) . to eq 'my_text_input'
end
it " finds by placeholder " do
expect ( string . find ( :field , placeholder : 'my text' ) [ :id ] ) . to eq 'my_text_input'
end
it " finds by type " do
expect ( string . find ( :field , type : 'file' ) [ :id ] ) . to eq 'file'
2016-10-05 18:16:00 -04:00
expect ( string . find ( :field , type : 'select' ) [ :id ] ) . to eq 'select'
2016-09-22 19:55:54 -04:00
end
end
2016-03-24 17:50:42 -04:00
describe " :option selector " do
it " finds disabled options " do
expect ( string . find ( :option , disabled : true ) . value ) . to eq 'b'
end
it " finds selected options " do
expect ( string . find ( :option , selected : true ) . value ) . to eq 'c'
end
it " finds not selected and not disabled options " do
expect ( string . find ( :option , disabled : false , selected : false ) . value ) . to eq 'a'
2016-03-24 14:18:12 -04:00
end
end
2018-04-11 12:23:59 -04:00
describe " :button selector " do
it " finds by value " do
expect ( string . find ( :button , 'click me' ) . value ) . to eq 'click me'
end
it " finds by title " do
expect ( string . find ( :button , 'submit button' ) . value ) . to eq 'click me'
end
it " includes non-matching parameters in failure message " do
expect { string . find ( :button , 'click me' , title : 'click me' ) } . to raise_error ( / with title click me / )
end
end
2018-05-24 18:27:34 -04:00
describe " :element selector " do
it " finds by any attributes " do
expect ( string . find ( :element , 'input' , type : 'submit' ) . value ) . to eq 'click me'
end
it " still works with system keys " do
expect { string . all ( :element , 'input' , type : 'submit' , count : 1 ) } . not_to raise_error
end
it " includes wildcarded keys in description " do
expect { string . find ( :element , 'input' , not_there : 'bad' , count : 1 ) }
. to ( raise_error do | e |
expect ( e ) . to be_a ( Capybara :: ElementNotFound )
2018-05-26 13:26:44 -04:00
expect ( e . message ) . to include " not_there => bad "
2018-05-24 18:27:34 -04:00
expect ( e . message ) . not_to include " count 1 "
end )
end
it " accepts XPath::Expression " do
expect ( string . find ( :element , 'input' , type : XPath . starts_with ( 'subm' ) ) . value ) . to eq 'click me'
expect ( string . find ( :element , 'input' , type : XPath . ends_with ( 'ext' ) ) [ :type ] ) . to eq 'text'
expect ( string . find ( :element , 'input' , type : XPath . contains ( 'ckb' ) ) [ :type ] ) . to eq 'checkbox'
expect ( string . find ( :element , 'input' , title : XPath . contains_word ( 'submit' ) ) [ :type ] ) . to eq 'submit'
expect ( string . find ( :element , 'input' , title : XPath . contains_word ( 'button' ) ) [ :type ] ) . to eq 'submit'
end
end
2016-03-24 14:18:12 -04:00
end
2016-01-06 20:11:00 -05:00
end
end
