Перейти к содержимому
Учи.Онлайн Выбрать школу
Статья

Cypress: e2e-тесты веб-приложения на JavaScript и чем он отличается от Playwright

Cypress — фреймворк, на котором фронтенд-разработчик или тестировщик пишет сквозные (e2e) тесты на JavaScript или TypeScript: тест открывает приложение в браузере, нажимает кнопки, заполняет формы, подменяет ответы сервера и проверяет, что увидит пользователь. Работа с ним держится на трёх вещах: командах cy, которые сами ждут появления элементов, перехвате сетевых запросов через cy.intercept и фикстурах с тестовыми данными. От Playwright Cypress отличается устройством запуска, языками и поддержкой вкладок и браузеров.

Автор: редакция Учи.ОнлайнОтветственный редактор: Дмитрий Игнатьев
Содержание
Иллюстрация к статье: Cypress: e2e-тесты веб-приложения на JavaScript и чем он отличается от Playwright

Главное, что стоит понять до первого теста: код теста выполняется внутри того же браузера, что и приложение, а не управляет им со стороны. Поэтому Cypress видит DOM, запросы и хранилища страницы напрямую, а в окне запуска можно навести курсор на любой шаг и посмотреть, как выглядела страница в этот момент. Цена такого устройства — одна вкладка и один браузер на тест и только JavaScript или TypeScript.

Какие задачи решает Cypress

Cypress нужен там, где важен путь пользователя целиком: войти, найти товар, оформить заявку. Фронтенд-разработчик проверяет, что после правки форма по-прежнему отправляется, тестировщик на JS-проекте закрывает регресс. Кроме сквозных тестов, Cypress умеет компонентные: отдельный компонент React или Vue монтируется в настоящем браузере.

Другой подход нужен в трёх случаях. Логику функций быстрее проверять юнит-тестами на Jest или Vitest, API без интерфейса — запросами, например в Postman. А если команда пишет на Python или Java или продукту нужен Safari, смотрите в сторону Playwright или Selenium.

Устанавливают Cypress как зависимость проекта (npm install cypress --save-dev) и запускают npx cypress open: в окне выбирают E2E Testing, браузер и файл теста. Для CI есть cypress run без окна. По справочнику конфигурации тесты ищутся по шаблону cypress/e2e/**/*.cy.{js,jsx,ts,tsx}, фикстуры лежат в cypress/fixtures, видео по умолчанию не пишется, а снимок экрана при падении сохраняется.

Команды cy и повторные попытки

Команды cy не выполняются сразу: Cypress ставит их в очередь и проходит по ней сам. Поэтому const button = cy.get('button') не даёт элемент. Значение берут внутри .then() или сразу ставят проверку .should().

По разделу о повторных попытках запросы к странице вроде cy.get и .find повторяются вместе со следующей проверкой до 4 секунд (defaultCommandTimeout), и цепочка перезапускается с начала. Действия вроде .click() выполняются один раз: Cypress ждёт, пока элемент станет видимым и доступным, нажимает и к предыдущим запросам не возвращается. Отсюда правило: сначала дождаться нужного состояния через .should(), потом действовать. Повтор упавшего теста целиком — другая настройка, retries, и по умолчанию она равна нулю.

Учебный пример: фильтр каталога

Ситуация учебная. В онлайн-библиотеке есть каталог с фильтром по жанру: при выборе жанра страница запрашивает /api/books и рисует карточки. Нужно проверить, что фильтр показывает нужные книги и что страница сообщает об ошибке, если сервер упал. Настоящий сервер не нужен: ответы подставит cy.intercept, данные возьмутся из фикстуры books-fantasy.json с тремя книгами.

describe('Каталог: фильтр по жанру', () => {
  it('показывает книги жанра', () => {
    cy.intercept({ pathname: '/api/books', query: { genre: 'fantasy' } },
      { fixture: 'books-fantasy.json' }).as('books')
    cy.visit('/catalog')
    cy.get('[data-cy=genre]').select('Фэнтези')
    cy.wait('@books')
    cy.get('[data-cy=book-card]').should('have.length', 3)
  })

  it('сообщает об ошибке сервера', () => {
    cy.intercept({ pathname: '/api/books' }, { statusCode: 500 }).as('books')
    cy.visit('/catalog')
    cy.get('[data-cy=genre]').select('Фэнтези')
    cy.wait('@books')
    cy.contains('Не удалось загрузить каталог').should('be.visible')
  })
})

Порядок строк важен. По справочнику cy.intercept маршрут видит только запросы, отправленные после его объявления, поэтому перехват ставят до cy.visit. Перед каждым тестом все перехваты снимаются, так что второй тест объявляет свой. Если запросу подходят несколько маршрутов, первым срабатывает объявленный последним. cy.wait('@books') ждёт конкретный запрос, а не фиксированное время, а атрибуты data-cy не меняются при переделке стилей, в отличие от классов из сборки.

Что очищается между тестами, а что остаётся

По умолчанию изоляция тестов включена (testIsolation: true). Раздел документации об изоляции перечисляет, что происходит перед каждым тестом: страница сбрасывается на about:blank, очищаются cookie, localStorage и sessionStorage во всех доменах. Но IndexedDB и другие хранилища браузера не очищаются даже при включённой изоляции. Данные, которые приложение или его библиотека записали в IndexedDB, доживают до следующего теста. Команда cy.session(), кеширующая вход, сохраняет и восстанавливает только cookie, localStorage и sessionStorage, так что IndexedDB она тоже не трогает.

На практике это выглядит так. Приложение хранит корзину в IndexedDB для работы без сети. Тест «пустая корзина» проходит отдельно и падает после теста, который положил туда товар. Перезапуск ничего не объясняет, и проверку записывают в нестабильные. Документация советует удалять базы приложения в хуке beforeEach: открыть страницу, вызвать indexedDB.deleteDatabase() для каждой базы и дождаться завершения.

Нестабильные тесты и Cypress Cloud

Нестабильный (flaky) тест то проходит, то падает без изменений в коде. Типичные причины — паузы cy.wait(3000), тесты, зависящие от предыдущего, общие данные на стенде и состояние, пережившее изоляцию. Включённые retries выручают сборку, но если не разбирать, что прошло со второй попытки, они прячут проблему.

Cypress Cloud — облачный сервис для команды: туда уходят результаты прогонов из CI, он распределяет тесты по машинам и хранит запись упавшего теста (Test Replay). На странице тарифов в октябре 2026 года бесплатный план Starter давал 500 результатов тестов в месяц, 10 пользователей и 30 дней хранения, без выявления нестабильных тестов; оно есть в тарифе Team за 799 долларов в год. Сам Cypress там назван бесплатным приложением с открытым кодом под лицензией MIT, так что учиться и запускать тесты в CI можно без Cloud.

Cypress или Playwright

Оба фреймворка сами ждут элементы, поэтому выбор определяют устройство запуска и ограничения. Cypress прямо перечисляет свои компромиссы: единственный язык — JavaScript, управлять можно только одним браузером за раз, тест привязан к одному домену верхнего уровня, а переход на другой включают командой cy.origin.

Cypress Playwright
Где выполняется тест внутри браузера в отдельном процессе
Языки JavaScript, TypeScript JS и TS, Python, Java, .NET
Вкладки одна вкладка, один браузер несколько страниц в тесте
Подмена запросов cy.intercept page.route
Параллельный запуск через Cloud или сторонние средства встроенный

Если проект на JavaScript, тесты уже написаны на Cypress и команде удобна пошаговая отладка, менять фреймворк незачем. Если нужен WebKit для проверки поведения Safari, несколько вкладок или тесты на языке бэкенда, логичнее Playwright.

С чего начать и в каком порядке осваивать

Шаги идут от простого к зависимому: без асинхронного JavaScript непонятно, почему команды cy не возвращают значения, без устойчивых селекторов перехват запросов даст хрупкий тест, а изоляцию и CI имеет смысл разбирать, когда тестов хотя бы десяток.

  1. JavaScript на уровне промисов и async/await, DOM и CSS-селекторы, Node.js и npm.
  2. Первый тест: открыть страницу, найти элемент, проверить текст.
  3. Атрибуты data-cy, проверки .should(), что повторяется, а что нет.
  4. cy.intercept, фикстуры, cy.wait по псевдониму: успех, пустой ответ, ошибка.
  5. Вход через cy.session или cy.request, хуки beforeEach.
  6. cypress run в CI, снимки экрана, retries и учёт нестабильных тестов.

Потренироваться можно на своём проекте или на демонстрационном Cypress Real World App с GitHub. Возьмите один сценарий и напишите три теста: с настоящим сервером, с фикстурой и с ошибкой 500. Результат проверяется просто: тесты проходят в любом порядке и по одному и не содержат пауз на фиксированное число миллисекунд.

Ошибки новичков повторяются: перехват объявляют после cy.visit, сохраняют cy.get в переменную, логинятся в первом тесте и рассчитывают на это во втором, выбирают элементы по классам из сборки, готовят данные через интерфейс вместо cy.request.

Где учат Cypress и что проверить в программе

Cypress редко изучают отдельно: обычно он входит в программу по автоматизации тестирования на JavaScript или во фронтенд-трек. Смотрите, есть ли отдельный блок с практикой, а не строчка в перечне инструментов.

Ближе всего к теме профессия «Инженер по автоматизации тестирования» на Skillbox: это девять месяцев, после основ и первых тестов на Selenium студент выбирает язык, и в JavaScript-треке разбирают WebdriverIO, Cypress, паттерны и API-тесты. В двух проектах нужно показать структуру тестов, тестовые данные, отчёты и автоматический запуск.

Открыть курс

Перед записью сравните, сколько времени отведено именно Cypress. Если он стоит в одном ряду с тремя другими фреймворками, вы получите знакомство, а перехваты, изоляцию и CI придётся добирать по документации.

Так устроен онлайн-курс TeachMeSkills «Автоматизированное тестирование на JavaScript»: 4,5 месяца живых занятий без записей на TypeScript, а Cypress назван в списке инструментов рядом с Playwright, Selenium WebDriver и WebdriverIO. Отдельного модуля по нему в программе нет, объём темы и цену стоит уточнить у школы.

Разработчику, которому тесты нужны к собственному фронтенду, Cypress встретится внутри программы по разработке. Там он занимает немного времени, зато тесты пишутся к своему же приложению.

На курсе Яндекс Практикума «Фулстек-разработчик» Cypress и Jest стоят в четвёртом модуле «React, состояние и тестирование», после хуков, маршрутизации и Redux Toolkit. В программе 13 проектов с ревью, а сведения о длительности расходятся — проверьте её перед оплатой.

Как навык влияет на доход

Отдельной надбавки за Cypress в открытых источниках нет, и сопоставимых свежих данных о зарплатах именно с этим навыком найти не удалось. В вакансиях он идёт строкой требований наравне с Playwright: работодатель платит за умение поддерживать набор сквозных тестов, а не за название фреймворка.

Чтобы оценить рынок, откройте вакансии автоматизатора тестирования в своём городе с фильтром по опыту и сравните, как часто упоминаются Cypress и Playwright. Смотрите медиану, а не верх вилки, и уточняйте, указана сумма до вычета налога или на руки. Если выбираете школу, а не программу, поможет рейтинг онлайн-школ по тестированию и QA.