Тестирование Функциональности Пользователя Сайта С Использованием Объектов Страницы Capybara

Здесь предусмотрены следующие действия: переход на соответствующую страницу, взаимодействие со страницей и проверка содержимого.

Часть кода дублируется, но это можно исправить, придерживаясь принципа СУХОЙ .

Важно понимать, что этот код сложно поддерживать, если в тестируемом приложении есть изменения.

Например, могут меняться классы элементов, имена и идентификаторы, что требует регулярного обновления тестового кода.

Также в этом коде нет «Семантического контекста», сложно понять, какие строки кода логически сгруппированы.

Взяв предыдущий пример и применив Объект страницы Чтобы создавать новые блоги и просматривать их, мы можем очистить код из предыдущего примера.

Избавившись от конкретной информации о технической реализации, конечный результат (код) должен быть читабельным и не должен содержать специфической информации о пользовательском интерфейсе (id, классы css и т. д.).

require 'feature_helper' require_relative '.

/pages/new_blog' require_relative '.

/pages/view_blog' feature 'Blog management', type: :feature do let(:new_blog_page) { ::Pages::NewBlog.new } let(:view_blog_page) { ::Pages::ViewBlog.new } before :each do new_blog_page.visit_location end scenario 'Successfully creating a new blog' do new_blog_page.create title: 'My Blog Title', text: 'My new blog text' expect(view_blog_page).

to have_loaded expect(view_blog_page).

to have_blog title: 'My Blog Title', text: 'My new blog text' end scenario 'Entering no data' do new_blog_page.create title: '', text: '' expect(view_blog_page).

to_not have_loaded expect(new_blog_page).

to have_errors "Title can't be blank", "Text can't be blank", "Title is too short", "Text is too short" end end

Создание объектов страницы Первый шаг творения Объекты страницы речь идет о создании структуры базовый класс страницы :

module Pages class NewBlog include RSpec::Matchers include Capybara::DSL # .

end end

Подключение (питание включено) Капибара :: DSL разрешить экземпляры Объекты страницы использовать методы, доступные в Водосвинка

has_css? '.

foo' has_content? 'hello world' find('.

foo').

Не нарушайте договоренности Объекты страницы не следует включать ожидать .

Однако там, где это уместно, я предпочитаю использовать этот подход, опираясь на встроенные механизмы.

Водосвинка для обработки условий.

Например, следующий код Водосвинка воля ожидать (ожидать) , доступность 'фу' внутри Объекты страницы (в данном случае это себя ):

expect(self).

to have_content 'foo'

Однако в следующем коде:

expect(page_object.content).

to match 'foo'

Могут возникнуть неожиданные ошибки (может возникнуть плавающий тест), поскольку page_object.content немедленно проверяется на соответствие условию и может быть еще не задекларирован.

Дополнительные примеры я бы рекомендовал прочитать мыслибот написание надежных асинхронных интеграционных тестов с Водосвинка .

to have_loaded end def has_loaded? self.has_selector? 'h1', text: 'Create Blog' end

Важно выбрать семантически правильный имена методов для вашего Объекты страницы

def create(title:, text:) # .

end def has_errors?(*errors) # .

end def has_error?(error) # .

end

В целом важно следовать принципу функционально интегрированных методов и, где это возможно, придерживаться принципа единой ответственности.

private def blog_form ::Components::BlogForm end

Где может быть скрыта реализация методов для BlogForm:

module Components class BlogForm include RSpec::Matchers include Capybara::DSL def create(title:, text:) within blog_form do fill_in 'blog_title', with: title fill_in 'blog_text', with: text click_on 'Save Blog' end end private def blog_form find('.

require 'feature_helper' require_relative '.

/pages/new_blog' require_relative '.

/pages/view_blog' feature 'Blog management', type: :feature do let(:new_blog_page) { ::Pages::NewBlog.new } let(:view_blog_page) { ::Pages::ViewBlog.new } # .

end

Примечание.

Я намеренно вручную создал объект страницы в верхней части файла объектов.

В некоторых тестах RSpec может быть удобно автоматически загружать все файлы поддержки и делать их доступными в объектных файлах, но это может привести к чрезмерным накладным расходам при использовании больших фрагментов кода.

В частности, это приведет к медленному запуску и потенциальным непреднамеренным циклическим зависимостям.

В наших тестах мы взаимодействовали с объектом страницы, используя иметь_загружено И иметь_блог :

expect(view_blog_page).

to have_loaded expect(view_blog_page).

to have_blog title: 'My Blog Title', text: 'My new blog text'

Однако имена методов нашего объекта страницы на самом деле has_loaded? И has_blog? :

def has_loaded? # .

end def has_blog?(title:, text:) # .

end

Это тонкая разница, которую необходимо отметить.

Для более подробной информации об этом соглашении я бы рекомендовал прочитать следующую ссылку.

средства сопоставления предикатов .