setCookies

Define um ou mais cookies para a página atual. Certifique-se de que você está na página que deve receber o cookie. Você não pode definir um cookie para uma página arbitrária sem estar nessa página.

Uso

browser.setCookies({ name, value, path, domain, secure, httpOnly, expiry, sameSite })

Parâmetros

Nome	Tipo	Detalhes
cookie	Array<WebDriverCookie>, WebDriverCookie	objeto cookie ou array de objetos.
cookie.name opcional	String	O nome do cookie.
cookie.value opcional	String	O valor do cookie.
cookie.path opcional	String	O caminho do cookie. O padrão é "/" se omitido ao adicionar um cookie.
cookie.domain opcional	String	O domínio no qual o cookie é visível. O padrão é o domínio URL do documento ativo do contexto de navegação atual se omitido ao adicionar um cookie.
cookie.secure opcional	Boolean	Se o cookie é um cookie seguro. O padrão é false se omitido ao adicionar um cookie.
cookie.httpOnly opcional	Boolean	Se o cookie é um cookie HTTP only. O padrão é false se omitido ao adicionar um cookie.
cookie.expiry opcional	Number	Quando o cookie expira, especificado em segundos desde o Unix Epoch. Não deve ser definido se omitido ao adicionar um cookie.
cookie.sameSite opcional	String	Se o cookie se aplica a uma política SameSite. O padrão é None se omitido ao adicionar um cookie. Pode ser definido como "Lax" ou "Strict".

Exemplo

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'}
    // ]
});