setCookies
Встановлює один або більше cookies для поточної сторінки. Переконайтеся, що ви перебуваєте на сторінці, яка повинна отримати cookie. Ви не можете встановити cookie для довільної сторінки, не перебуваючи на ній.
Usage
browser.setCookies({ name, value, path, domain, secure, httpOnly, expiry, sameSite })
Parameters
Name | Type | Details |
---|---|---|
cookie | Array<WebDriverCookie>, WebDriverCookie | об'єкт cookie або масив об'єктів. |
cookie.name optional | String | Назва cookie. |
cookie.value optional | String | Значення cookie. |
cookie.path optional | String | Шлях cookie. За замовчуванням має значення "/" якщо опущено при додаванні cookie. |
cookie.domain optional | String | Домен, для якого cookie є видимим. За замовчуванням - домен URL поточного активного документа, якщо опущено при додаванні cookie. |
cookie.secure optional | Boolean | Чи є cookie захищеним. За замовчуванням має значення false, якщо опущено при додаванні cookie. |
cookie.httpOnly optional | Boolean | Чи є cookie лише для HTTP. За замовчуванням має значення false, якщо опущено при додаванні cookie. |
cookie.expiry optional | Number | Час закінчення терміну дії cookie, вказаний у секундах починаючи з Unix Epoch. Не повинен бути встановлений, якщо опущено при додаванні cookie. |
cookie.sameSite optional | String | Чи застосовується до cookie політика SameSite. За замовчуванням має значення None, якщо опущено при додаванні cookie. Може бути встановлено на "Lax" або "Strict". |
Example
setCookies.js
it('should set a cookie for the page', async () => {
await browser.url('/')
// set a single cookie
await browser.setCookies({
name: 'test1',
value: 'one'
// The below options are optional
// path: '/foo', // The cookie path. Defaults to "/"
// domain: '.example.com', // The domain the cookie is visible to. Defaults to the current browsing context's active document's URL domain
// secure: true, // Whether the cookie is a secure cookie. Defaults to false
// httpOnly: true, // Whether the cookie is an HTTP only cookie. Defaults to false
// expiry: 1551393875 // When the cookie expires, specified in seconds since Unix Epoch
})
// set multiple cookies
await browser.setCookies([
{name: 'test2', value: 'two'},
{name: 'test3', value: 'three'}
])
const cookies = await browser.getCookies()
console.log(cookies);
// outputs:
// [
// {name: 'test1', value: 'one', domain: 'www.example.com'},
// {name: 'test2', value: 'two', domain: 'www.example.com'},
// {name: 'test3', value: 'three', domain: 'www.example.com'}
// ]
});