Back to Repositories

Validating Multiple Selector Detection Workflows in Capybara

This test suite validates Capybara’s has_all_selectors functionality, which checks for the presence of multiple elements on a page. It ensures robust element detection across different selector types and scoping contexts in web applications.

Test Coverage Overview

The test suite comprehensively covers the has_all_of_selectors matcher functionality in Capybara.

Key areas tested include:

Basic selector verification using CSS selectors
Default selector behavior
Scoped element detection within specific contexts
Option handling for specialized element types
Asynchronous element detection with wait times

Implementation Analysis

The testing approach employs RSpec’s expectation syntax to verify selector matching behavior. The implementation uses various Capybara methods and contexts to validate element presence, with particular attention to scoping and timing considerations.

Notable patterns include:

Explicit selector type specification
Nested context blocks for related scenarios
Error case validation
JavaScript-dependent testing

Technical Details

Testing tools and configuration:

RSpec as the testing framework
Capybara for web element interaction
CSS and XPath selector support
JavaScript capability testing
Custom wait time configuration
Session-based testing approach

Best Practices Demonstrated

The test suite exemplifies several testing best practices in web application testing.

Notable practices include:

Comprehensive positive and negative test cases
Proper test isolation and setup
Clear test case organization
Explicit error checking
Proper handling of asynchronous behaviors
Effective use of context blocks for related scenarios

teamcapybara/capybara

lib/capybara/spec/session/has_all_selectors_spec.rb

            
# frozen_string_literal: true

Capybara::SpecHelper.spec '#have_all_of_selectors' do
  before do
    @session.visit('/with_html')
  end

  it 'should be true if the given selectors are on the page' do
    expect(@session).to have_all_of_selectors(:css, 'p a#foo', 'h2#h2one', 'h2#h2two')
  end

  it 'should be false if any of the given selectors are not on the page' do
    expect do
      expect(@session).to have_all_of_selectors(:css, 'p a#foo', 'h2#h2three', 'h2#h2one')
    end.to raise_error RSpec::Expectations::ExpectationNotMetError
  end

  it 'should use default selector' do
    Capybara.default_selector = :css
    expect(@session).to have_all_of_selectors('p a#foo', 'h2#h2two', 'h2#h2one')
    expect do
      expect(@session).to have_all_of_selectors('p a#foo', 'h2#h2three', 'h2#h2one')
    end.to raise_error RSpec::Expectations::ExpectationNotMetError
  end

  context 'should respect scopes' do
    it 'when used with `within`' do
      @session.within "//p[@id='first']" do
        expect(@session).to have_all_of_selectors(".//a[@id='foo']")
        expect do
          expect(@session).to have_all_of_selectors(".//a[@id='red']")
        end.to raise_error RSpec::Expectations::ExpectationNotMetError
      end
    end

    it 'when called on elements' do
      el = @session.find "//p[@id='first']"
      expect(el).to have_all_of_selectors(".//a[@id='foo']")
      expect do
        expect(el).to have_all_of_selectors(".//a[@id='red']")
      end.to raise_error RSpec::Expectations::ExpectationNotMetError
    end
  end

  context 'with options' do
    it 'should apply options to all locators' do
      expect(@session).to have_all_of_selectors(:field, 'normal', 'additional_newline', type: :textarea)
      expect do
        expect(@session).to have_all_of_selectors(:field, 'normal', 'test_field', 'additional_newline', type: :textarea)
      end.to raise_error RSpec::Expectations::ExpectationNotMetError
    end
  end

  context 'with wait', requires: [:js] do
    it 'should not raise error if all the elements appear before given wait duration' do
      Capybara.using_wait_time(0.1) do
        @session.visit('/with_js')
        @session.click_link('Click me')
        expect(@session).to have_all_of_selectors(:css, 'a#clickable', 'a#has-been-clicked', '#drag', wait: 5)
      end
    end
  end

  it 'cannot be negated' do
    expect do
      expect(@session).not_to have_all_of_selectors(:css, 'p a#foo', 'h2#h2one', 'h2#h2two')
    end.to raise_error ArgumentError
  end
end