Saltar al contenido principal

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
NombreTipoDetalles
cookieArray<WebDriverCookie>, WebDriverCookieobjeto cookie o array de objetos.
cookie.name
opcional
StringEl nombre de la cookie.
cookie.value
opcional
StringEl valor de la cookie.
cookie.path
opcional
StringLa ruta de la cookie. El valor predeterminado es "/" si se omite al agregar una cookie.
cookie.domain
opcional
StringEl 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
BooleanSi la cookie es una cookie segura. El valor predeterminado es false si se omite al agregar una cookie.
cookie.httpOnly
opcional
BooleanSi la cookie es una cookie de solo HTTP. El valor predeterminado es false si se omite al agregar una cookie.
cookie.expiry
opcional
NumberCuando expira la cookie, especificado en segundos desde Unix Epoch. No debe establecerse si se omite al agregar una cookie.
cookie.sameSite
opcional
StringSi 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'}
// ]
});

Welcome! How can I help?

WebdriverIO AI Copilot