setCookie
Set a browser cookie.
Syntax​
cy.setCookie(name, value)
cy.setCookie(name, value, options)
Usage​
Correct Usage
cy.setCookie('auth_key', '123key') // Set the 'auth_key' cookie to '123key'
Arguments​
name (String)
The name of the cookie to set.
value (String)
The value of the cookie to set.
options (Object)
Pass in an options object to change the default behavior of cy.setCookie().
| Option | Default | Description |
|---|---|---|
log | true | Displays the command in the Command log |
domain | Hostname of the current URL | The domain the cookie is visible to |
expiry | 20 years into the future | When the cookie expires, specified in seconds since Unix Epoch. |
hostOnly | false | Whether the cookie is a host-only cookie, (i.e. the request's host must exactly match the domain of the cookie) |
httpOnly | false | Whether the cookie is an HTTP only cookie |
path | / | The cookie path |
secure | false | Whether the cookie is a secure cookie |
timeout | responseTimeout | Time to wait for cy.setCookie() to resolve before timing out |
sameSite | undefined | Cookie's SameSite value. If set, should be one of lax, strict, or no_restriction. Pass undefined to use the browser's default. Note: no_restriction can only be used if the secure flag is set to true. |
Yields ​
cy.setCookie() yields a cookie object with the following properties:
domainexpiry(if specified)hostOnly(if specified)httpOnlynamepathsameSite(if specified)securevalue
Examples​
Name Value​
Set a cookie​
cy.getCookies().should('be.empty')
cy.setCookie('session_id', '189jd09sufh33aaiidhf99d09')
cy.getCookie('session_id').should(
'have.property',
'value',
'189jd09sufh33aaiidhf99d09'
)
Preserving a cookie across tests​
By default, Cypress
clears all cookies before each test to
keep tests independent. If you have a known cookie value that every test
requires — such as a cookie-consent acceptance or a feature flag — re-set it in
a beforeEach hook so it is present at the start of every test:
// cypress/support/e2e.js
beforeEach(() => {
cy.setCookie('cookieConsent', 'accepted')
})
For cookies that are generated by the server after a login flow, use
cy.session() instead, which caches and restores the
full browser context (cookies, localStorage, and sessionStorage) across tests.
Rules​
Requirements ​
cy.setCookie()requires being chained off ofcy.
Assertions ​
cy.setCookie()will only run assertions you have chained once, and will not retry.
Timeouts ​
cy.setCookie()should never time out.
Because cy.setCookie() is asynchronous it is technically possible for there to
be a timeout while talking to the internal Cypress automation APIs. But for
practical purposes it should never happen.
Command Log​
Set a cookie on the browser for testing
cy.getCookies().should('be.empty')
cy.setCookie('fakeCookie1', '123ABC')
cy.getCookie('fakeCookie1').should('have.property', 'value', '123ABC')
The commands above will display in the Command Log as:
When clicking on setCookie within the command log, the console outputs the
following:
History​
| Version | Changes |
|---|---|
| 12.7.0 | Support hostOnly option for a given domain. |
| 5.0.0 | Removed experimentalGetCookiesSameSite and made sameSite property always available. |
| 4.3.0 | Added sameSite property when the experimentalGetCookiesSameSite configuration value is true. |
| 0.16.0 | cy.setCookie() command added |