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
Nome | Tipo | Dettagli |
---|---|---|
cookie | Array<WebDriverCookie>, WebDriverCookie | oggetto cookie o array di oggetti. |
cookie.name opzionale | String | Il nome del cookie. |
cookie.value opzionale | String | Il valore del cookie. |
cookie.path opzionale | String | Il percorso del cookie. Predefinito a "/" se omesso quando si aggiunge un cookie. |
cookie.domain opzionale | String | Il 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 | Boolean | Se il cookie è un cookie sicuro. Predefinito a false se omesso quando si aggiunge un cookie. |
cookie.httpOnly opzionale | Boolean | Se il cookie è un cookie HTTP only. Predefinito a false se omesso quando si aggiunge un cookie. |
cookie.expiry opzionale | Number | Quando il cookie scade, specificato in secondi dall'Epoca Unix. Non deve essere impostato se omesso quando si aggiunge un cookie. |
cookie.sameSite opzionale | String | Se 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'}
// ]
});