setCookies

Ustawia jeden lub więcej ciasteczek dla bieżącej strony. Upewnij się, że jesteś na stronie, która ma otrzymać ciasteczko. Nie możesz ustawić ciasteczka dla dowolnej strony bez przebywania na tej stronie.

Użycie

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

Parametry

Nazwa	Typ	Szczegóły
cookie	Array<WebDriverCookie>, WebDriverCookie	obiekt cookie lub tablica obiektów.
cookie.name opcjonalne	String	Nazwa ciasteczka.
cookie.value opcjonalne	String	Wartość ciasteczka.
cookie.path opcjonalne	String	Ścieżka ciasteczka. Domyślnie "/" jeśli pominięto podczas dodawania ciasteczka.
cookie.domain opcjonalne	String	Domena, dla której ciasteczko jest widoczne. Domyślnie domena URL aktywnego dokumentu bieżącego kontekstu przeglądania, jeśli pominięto podczas dodawania ciasteczka.
cookie.secure opcjonalne	Boolean	Czy ciasteczko jest bezpieczne. Domyślnie false, jeśli pominięto podczas dodawania ciasteczka.
cookie.httpOnly opcjonalne	Boolean	Czy ciasteczko jest ciasteczkiem tylko dla HTTP. Domyślnie false, jeśli pominięto podczas dodawania ciasteczka.
cookie.expiry opcjonalne	Number	Kiedy ciasteczko wygasa, określone w sekundach od początku epoki Unix. Nie może być ustawione, jeśli pominięto podczas dodawania ciasteczka.
cookie.sameSite opcjonalne	String	Czy ciasteczko stosuje się do polityki SameSite. Domyślnie None, jeśli pominięto podczas dodawania ciasteczka. Może być ustawione na "Lax" lub "Strict".

Przykład

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