Перейти до основного вмісту

setCookies

Встановлює один або більше cookies для поточної сторінки. Переконайтеся, що ви перебуваєте на сторінці, яка повинна отримати cookie. Ви не можете встановити cookie для довільної сторінки, не перебуваючи на ній.

Usage
browser.setCookies({ name, value, path, domain, secure, httpOnly, expiry, sameSite })
Parameters
NameTypeDetails
cookieArray<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'}
// ]
});

Welcome! How can I help?

WebdriverIO AI Copilot