clearCookie

Очистить определенный куки браузера.

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

Синтаксис

cy.clearCookie(name)
cy.clearCookie(name, options)

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

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

cy.clearCookie('authId') // clear the 'authId' cookie

Аргументы

name (Строка)

Имя куки, которое нужно очистить.

options (Объект)

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

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

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

Примеры

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

Очистка куки после входа в систему

В этом примере при первом входе в систему сервер возвращает нам куки сессии. После вызова cy.clearCookie('session_id'), этот куки сессии очищается. Затем, при переходе на незащищенную страницу, мы проверяем, что сервер перенаправил нас обратно на страницу входа.

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

Правила

Требования

• cy.clearCookie() должна быть цепочкой команд от cy.

Утверждения

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

Таймауты

• cy.clearCookie() никогда не должна вызывать таймаут.

Поскольку cy.clearCookie() является асинхронной, теоретически возможен таймаут при взаимодействии с внутренними API Cypress. Но на практике это должно происходить очень редко.

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

Очистка куки после установки куки

cy.setCookie('foo', 'bar')
cy.clearCookie('foo')
cy.getCookie('foo').should('be.null')

Вышеуказанные команды будут отображаться в журнале команд как:

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

См. также

• cy.clearCookies()
• cy.clearLocalStorage()
• API куки Cypress
• cy.getCookie()
• cy.getCookies()
• cy.setCookie()