setCookies
Establece una o más cookies para la página actual. Asegúrate de que estás en la página que debe recibir la cookie. No puedes establecer una cookie para una página arbitraria sin estar en esa página.
Uso
browser.setCookies({ name, value, path, domain, secure, httpOnly, expiry, sameSite })
Parámetros
Nombre | Tipo | Detalles |
---|---|---|
cookie | Array<WebDriverCookie>, WebDriverCookie | objeto cookie o array de objetos. |
cookie.name opcional | String | El nombre de la cookie. |
cookie.value opcional | String | El valor de la cookie. |
cookie.path opcional | String | La ruta de la cookie. El valor predeterminado es "/" si se omite al agregar una cookie. |
cookie.domain opcional | String | El dominio en el que la cookie es visible. Por defecto es el dominio de la URL del documento activo del contexto de navegación actual si se omite al agregar una cookie. |
cookie.secure opcional | Boolean | Si la cookie es una cookie segura. El valor predeterminado es false si se omite al agregar una cookie. |
cookie.httpOnly opcional | Boolean | Si la cookie es una cookie de solo HTTP. El valor predeterminado es false si se omite al agregar una cookie. |
cookie.expiry opcional | Number | Cuando expira la cookie, especificado en segundos desde Unix Epoch. No debe establecerse si se omite al agregar una cookie. |
cookie.sameSite opcional | String | Si la cookie aplica una política SameSite. El valor predeterminado es None si se omite al agregar una cookie. Puede establecerse en "Lax" o "Strict". |
Ejemplo
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'}
// ]
});