clearCookies

Очистить все файлы cookie браузера для текущего домена и поддоменов.

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

Синтаксис

cy.clearCookies()
cy.clearCookies(options)

Использование

Правильное использование

cy.clearCookies() // clear all cookies

Аргументы

options (Объект)

Передайте объект options, чтобы изменить стандартное поведение cy.clearCookies().

Возвращаемое значение

• cy.clearCookies() возвращает null .
• cy.clearCookies() не может быть дополнительно использована в цепочке.

Примеры

Без аргументов

Очистка всех файлов cookie после входа

В этом примере наш сервер возвращает нам файл cookie сессии при первом входе. После вызова cy.clearCookies() это очищает файл cookie сессии, и при переходе на незащищённую страницу сервер должен перенаправить нас обратно на страницу входа.

// assume we just logged in
cy.contains('Login').click()
cy.url().should('include', 'profile')
cy.clearCookies()
cy.visit('/dashboard') // we should be redirected back to login
cy.url().should('include', 'login')

Правила

Требования

• cy.clearCookies() должна быть использована после cy.

Утверждения

• cy.clearCookies() не может иметь никаких утверждений в цепочке.

Временные ограничения

• cy.clearCookies() не должна превышать временное ограничение.

Так как cy.clearCookies() асинхронна, теоретически возможно превышение временного ограничения при общении с внутренними API Cypress. Но на практике это не должно произойти.

Журнал команд

Очистка файлов cookie после получения файлов cookie

cy.getCookies().should('have.length', 1)
cy.clearCookies()
cy.getCookies().should('be.empty')

Вышеперечисленные команды будут отображены в журнале команд как:

При нажатии на clearCookies в журнале команд, в консоль выводится следующее:

См. также

• cy.clearCookie()
• API Cypress для файлов cookie
• cy.getCookie()
• cy.getCookies()
• cy.setCookie()