gitlab-org--gitlab-foss/qa/spec/page/base_spec.rb

182 lines
5.1 KiB
Ruby

# frozen_string_literal: true
describe QA::Page::Base do
describe 'page helpers' do
it 'exposes helpful page helpers' do
expect(subject).to respond_to :refresh, :wait_until, :scroll_to
end
end
describe '.view', 'DSL for defining view partials' do
subject do
Class.new(described_class) do
view 'path/to/some/view.html.haml' do
element :something, 'string pattern' # rubocop:disable QA/ElementWithPattern
element :something_else, /regexp pattern/ # rubocop:disable QA/ElementWithPattern
end
view 'path/to/some/_partial.html.haml' do
element :another_element, 'string pattern' # rubocop:disable QA/ElementWithPattern
end
end
end
it 'makes it possible to define page views' do
expect(subject.views.size).to eq 2
expect(subject.views).to all(be_an_instance_of(QA::Page::View))
end
it 'populates views objects with data about elements' do
expect(subject.elements.size).to eq 3
expect(subject.elements).to all(be_an_instance_of(QA::Page::Element))
expect(subject.elements.map(&:name))
.to eq [:something, :something_else, :another_element]
end
end
describe '.errors' do
let(:view) { double('view') }
context 'when page has views and elements defined' do
before do
allow(described_class).to receive(:views)
.and_return([view])
allow(view).to receive(:errors).and_return(['some error'])
end
it 'iterates views composite and returns errors' do
expect(described_class.errors).to eq ['some error']
end
end
context 'when page has no views and elements defined' do
before do
allow(described_class).to receive(:views).and_return([])
end
it 'appends an error about missing views / elements block' do
expect(described_class.errors)
.to include 'Page class does not have views / elements defined!'
end
end
end
describe '#wait_until' do
subject { Class.new(described_class).new }
context 'when the condition is true' do
it 'does not refresh' do
expect(subject).not_to receive(:refresh)
subject.wait_until(max_duration: 0.01, raise_on_failure: false) { true }
end
it 'returns true' do
expect(subject.wait_until(max_duration: 0.1, raise_on_failure: false) { true }).to be_truthy
end
end
context 'when the condition is false' do
it 'refreshes' do
expect(subject).to receive(:refresh).at_least(:once)
subject.wait_until(max_duration: 0.01, raise_on_failure: false) { false }
end
it 'returns false' do
allow(subject).to receive(:refresh)
expect(subject.wait_until(max_duration: 0.01, raise_on_failure: false) { false }).to be_falsey
end
end
end
describe '#all_elements' do
before do
allow(subject).to receive(:all)
end
it 'raises an error if count or minimum are not specified' do
expect { subject.all_elements(:foo) }.to raise_error ArgumentError
end
it 'does not raise an error if :minimum, :maximum, :count, or :between is specified' do
[:minimum, :maximum, :count, :between].each do |param|
expect { subject.all_elements(:foo, param => 1) }.not_to raise_error
end
end
end
context 'elements' do
subject do
Class.new(described_class) do
view 'path/to/some/view.html.haml' do
element :something, required: true
element :something_else
end
end
end
describe '#elements' do
it 'returns all elements' do
expect(subject.elements.size).to eq(2)
end
end
describe '#required_elements' do
it 'returns only required elements' do
expect(subject.required_elements.size).to eq(1)
end
end
describe '#visible?', 'Page is currently visible' do
let(:page) { subject.new }
context 'with elements' do
context 'on the page' do
before do
# required elements not there, meaning not on page
allow(page).to receive(:has_no_element?).and_return(false)
end
it 'is visible' do
expect(page).to be_visible
end
end
context 'not on the page' do
before do
# required elements are not on the page
allow(page).to receive(:has_no_element?).and_return(true)
end
it 'is not visible' do
expect(page).not_to be_visible
end
end
it 'does not raise error if page has elements' do
expect { page.visible? }.not_to raise_error
end
end
context 'no elements' do
subject do
Class.new(described_class) do
view 'path/to/some/view.html.haml' do
element :something
element :something_else
end
end
end
let(:page) { subject.new }
it 'raises error if page has no required elements' do
expect { page.visible? }.to raise_error(described_class::NoRequiredElementsError)
end
end
end
end
end