Cypress Best Practices
https://t.me/testingNotQAДавайте еще раз, но уже осознанно, пробежимся по Cypress Best Practices, там есть несколько моментов, которые мы можем имплементировать прямо сейчас, другие же стоит знать и применять в тестировании вне зависимости от фреймворка.
Cypress вырос из идеи дать мощный инструмент для автоматизации самим разработчикам и опытным SDET. По этой причине многие его крутые фишки лучше отдельно проговорить, так как создатели подразумевают, что у вас уже есть какой-то прошлый опыт автотестов и понимание работы веб-приложений.

Page Object
Первым же пунктом идет предложение отказаться от Page Object, поэтому стоит пару слов о нем сказать. Очень кратко: это абстракция и паттерн разработки тестов, при котором UI элементы логически группируются в один класс вместе с шагами-фунциями, которые служат для достижения какой-то пользовательской цели (прокликать шаги логина или оплаты товара).
Очень подробное объяснение с кучей кода вот в этом посте. Тем, у кого был опыт написания тестов, рекомендую хотя бы ознакомиться с доводами, это развивает кругозор автоматизации веба. Но Page Objects широко используются в коммьюнити (в нашей команде в том числе), поэтому из церки свидетелей Cypress вас не выгонят, можно совмещать.
Take control of your application state
Суть в том, что UI путь может быть протестирован один раз, а затем добраться до нужного состояния приложения можно разными более быстрыми и надежными способами.
Пример: если вам нужен авторизированный пользователь в 50 тестах, не нужно 50 раз это делать через UI, достаточно иметь 1 тест, который протестирует успешный логин, а 49 других могут логиниться более эффективно.
Например, через запрос к API или предустановку cookie, или закэшировать сессию браузера и потом вставить ее в следующие тесты, или в сам код приложения можно добавить методы, позволяющие "указать", что у приложения теперь авторизованный пользователь. Часть из этих способов я планирую добавить в следующий продвинутый курс. Пока все это просто для того же расширения кругозора.
Вот продвинутые рецепты авторизации, включая всякие токены и SSO: cypress-example-recipes.
Это мы уже разбирали в уроке по селекторам, поэтому просто напомню:

Если не data атрибуты, пользуйтесь Cypress Testing Library, не нужно xpath, s'il vous plait.

Стиль написания кода в Cypress устроен не так, как в тестах на тех же Selenium, Playwright и прочих, поэтому действительно const и let почти не должны использоваться для элементов.
Вместо этого следует внимательно прочесть Varaibles and aliases и отрефакторить код. Выдержки из этой статьи далее.
then()
Пример получения текста кнопки и сравнения его с другим текстом другой кнопки. Такая вложенность – нормальная.
cy.get('button').then((btn) => {
// store the button's text
const txt = btn.text()
// submit a form
cy.get('form').submit()
// compare the two buttons' text
// and make sure they are different
cy.get('button').should(($btn2) => {
expect($btn2.text()).not.to.eq(txt)
})
})
@
Или aliases. Данные, полученные где-то в одном месте, можно переиспользовать в другом, присвоив им алиас:
cy.get('label').as('myLabel')
...
cy.get('@myLabel').then((label) => {...}
this
Если then тревожит своей вложенностью, есть вариант использовать контекст this, но для этого в тесте нужно вместо анонимной функции () => {} использовать обычную function () {}
beforeEach(() => {
cy.get('button').invoke('text').as('text')
})
it('has access to text', function () {
expect(this.text).to.contain('expectedText')
})

Cypress не рекомендует посещать сайты, которые вы не контролируете. Это не всегда возможно, поэтому почитайте, какие способы они предлагают, чтобы минимизировать риски хрупкости тестов.

Независимость тестов
Тесты должны быть детерминированными, то есть не зависеть от других тестов и условий. Проверяйте это, запуская отдельные it как it.only. В случае использования параллелизации это все вылезет мгновенно.
beforeEach()
Если у вас появляется несколько тестов, которые начинаются с одних и тех же шагов, выносите этот общий код в beforeEach():
describe('my form', () => {
beforeEach(() => {
cy.visit('/users/new')
cy.get('[data-testid="first-name"]').type('Johnny')
cy.get('[data-testid="last-name"]').type('Appleseed')
})
it('displays form validation', () => {
cy.get('[data-testid="first-name"]').clear()
cy.get('form').submit()
cy.get('[data-testid="errors"]').should('contain', 'First name is required')
})
it('can submit a valid form', () => {
cy.get('form').submit()
})
})

Тем, кто приходит в дивный мир E2E часто кажется, что Arrange Act Assert, применяемый в юнит-тестах, здесь тоже имеет смысл, но – нет. В E2E может быть Arrange Act Assert Act Assert Assert и так далее, и это тоже нормально.

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

cy.wait() это дурной тон, иногда без него никуда, но это последний вариант, и его применение должно быть сведено к минимуму.
Обычно затыки возникают, когда что-то асинхронно выполняется дольше, чем обычно, и тест может падать после дефолтых 4 секунд, и это очень частая проблема на CI.
Это можно попробовать решить такими вариантами:
- Если это завязано на запрос к серверу, то нужно дождаться ответа, там таймауты гораздо больше (это будет в отдельном уроке)
- Если идет загрузка новой страницы, можно завязаться на смену URL:
cy.url().should('include', '/abc') - Если же что-то происходит в самом UI, то лучше опереться на какой-то элемент, проверить, что он изменил свое состояние (кнопка стала активной) и только потом продолжать. Вместо изменения глобального дефолтного ожидания, можно его увеличить у конкретной команды:
cy.get('button).should('be.visible', { timeout: 15000 })

Тут все просто, вместо указания полного URL каждый раз в тестах, нужно добавить baseUrl в конфиг Cypress. Инструкция.
Тогда вместо такого кода:
cy.visit('https://www.demoblaze.com')
или
cy.url().should('eq', 'https://www.demoblaze.com/index.html')
Можно сделать так:
cy.visit('/')
...
cy.url()
.should('eq', Cypress.config().baseUrl + '/index.html')
- Укажите
baseUrlв конфиге, и поменяйте ссылки везде, где ранее использовали полный адрес - Если применимо, добавьте общие шаги (по факту предусловия) в
beforeEach() - Если применимо, попробуйте убрать
cy.wait(), завязавшись на UI элемент или смену URL - Если применимо, замените
constиletна любой из вариантов, предложенных Cypress - Для тех, кто занимается в группе: cкиньте ссылку на тесты в чат с соответствующим топиком