Vai al contenuto principale

setCookies

Imposta uno o più cookies per la pagina corrente. Assicurati di essere sulla pagina che dovrebbe ricevere il cookie. Non puoi impostare un cookie per una pagina arbitraria senza essere su quella pagina.

Utilizzo
browser.setCookies({ name, value, path, domain, secure, httpOnly, expiry, sameSite })
Parametri
NomeTipoDettagli
cookieArray<WebDriverCookie>, WebDriverCookieoggetto cookie o array di oggetti.
cookie.name
opzionale
StringIl nome del cookie.
cookie.value
opzionale
StringIl valore del cookie.
cookie.path
opzionale
StringIl percorso del cookie. Predefinito a "/" se omesso quando si aggiunge un cookie.
cookie.domain
opzionale
StringIl dominio in cui il cookie è visibile. Predefinito al dominio URL del documento attivo del contesto di navigazione corrente se omesso quando si aggiunge un cookie.
cookie.secure
opzionale
BooleanSe il cookie è un cookie sicuro. Predefinito a false se omesso quando si aggiunge un cookie.
cookie.httpOnly
opzionale
BooleanSe il cookie è un cookie HTTP only. Predefinito a false se omesso quando si aggiunge un cookie.
cookie.expiry
opzionale
NumberQuando il cookie scade, specificato in secondi dall'Epoca Unix. Non deve essere impostato se omesso quando si aggiunge un cookie.
cookie.sameSite
opzionale
StringSe il cookie si applica a una politica SameSite. Predefinito a None se omesso quando si aggiunge un cookie. Può essere impostato a "Lax" o "Strict".
Esempio
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