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.nameopzionale | String | Il nome del cookie. |
cookie.valueopzionale | String | Il valore del cookie. |
cookie.pathopzionale | String | Il percorso del cookie. Predefinito a "/" se omesso quando si aggiunge un cookie. |
cookie.domainopzionale | 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.secureopzionale | Boolean | Se il cookie è un cookie sicuro. Predefinito a false se omesso quando si aggiunge un cookie. |
cookie.httpOnlyopzionale | Boolean | Se il cookie è un cookie HTTP only. Predefinito a false se omesso quando si aggiunge un cookie. |
cookie.expiryopzionale | Number | Quando il cookie scade, specificato in secondi dall'Epoca Unix. Non deve essere impostato se omesso quando si aggiunge un cookie. |
cookie.sameSiteopzionale | 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'}
// ]
});