setCookies

Setzt einen oder mehrere Cookies für die aktuelle Seite. Stellen Sie sicher, dass Sie auf der Seite sind, die das Cookie erhalten soll. Sie können kein Cookie für eine beliebige Seite setzen, ohne auf dieser Seite zu sein.

Usage

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

Parameters

Name	Type	Details
cookie	Array<WebDriverCookie>, WebDriverCookie	Cookie-Objekt oder Objekt-Array.
cookie.name optional	String	Der Name des Cookies.
cookie.value optional	String	Der Cookie-Wert.
cookie.path optional	String	Der Cookie-Pfad. Standardwert ist "/", wenn beim Hinzufügen eines Cookies nicht angegeben.
cookie.domain optional	String	Die Domain, für die das Cookie sichtbar ist. Standardwert ist die Domain der URL des aktiven Dokuments des aktuellen Browsing-Kontexts, wenn beim Hinzufügen eines Cookies nicht angegeben.
cookie.secure optional	Boolean	Ob das Cookie ein sicheres Cookie ist. Standardwert ist false, wenn beim Hinzufügen eines Cookies nicht angegeben.
cookie.httpOnly optional	Boolean	Ob das Cookie ein HTTP-Only-Cookie ist. Standardwert ist false, wenn beim Hinzufügen eines Cookies nicht angegeben.
cookie.expiry optional	Number	Wann das Cookie abläuft, angegeben in Sekunden seit Unix Epoch. Darf nicht gesetzt werden, wenn beim Hinzufügen eines Cookies nicht angegeben.
cookie.sameSite optional	String	Ob das Cookie für eine SameSite-Richtlinie gilt. Standardwert ist None, wenn beim Hinzufügen eines Cookies nicht angegeben. Kann auf "Lax" oder "Strict" gesetzt werden.

Example

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