# frozen_string_literal: true require 'spec_helper' RSpec.describe Capybara do describe 'Selectors' do let :string do Capybara.string <<-STRING selectors

Totally awesome

Yes it is

Some Content

Something
link
STRING end before do Capybara.add_selector :custom_selector do css { |css_class| "div.#{css_class}" } node_filter(:not_empty, boolean: true, default: true, skip_if: :all) { |node, value| value ^ (node.text == '') } end Capybara.add_selector :custom_css_selector do css { |selector| selector } end Capybara.add_selector :custom_xpath_selector do xpath { |selector| selector } end end it "supports `filter` as an alias for `node_filter`" do expect do Capybara.add_selector :filter_alias_selector do css { |_unused| "div" } filter(:something) { |_node, _value| true } end end.not_to raise_error end describe "adding a selector" do it "can set default visiblity" do Capybara.add_selector :hidden_field do visible :hidden css { |_sel| 'input[type="hidden"]' } end expect(string).to have_no_css('input[type="hidden"]') expect(string).to have_selector(:hidden_field) end end describe "modify_selector" do 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 css { |css_class| "p.#{css_class}" } 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 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]", link_or_button: ".//a[./@href] | .//input[./@type = 'submit' or ./@type = 'reset' or ./@type = 'image' or ./@type = 'button'] | .//button", 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| results = string.all(selector, nil).to_a.map(&:native) expect(results.size).to be > 0 expect(results).to eq string.all(:xpath, xpath).to_a.map(&:native) end end end context "with :id option" do 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 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 end context "with :class option" do 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 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 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 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 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' expect(string.find(:field, type: 'select')[:id]).to eq 'select' end end 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' end end 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 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) expect(e.message).to include "not_there => bad" 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 end end end