setCookies
Sätter en eller flera cookies för den aktuella sidan. Se till att du befinner dig på den sida som ska ta emot cookien. Du kan inte sätta en cookie för en godtycklig sida utan att befinna dig på den sidan.
Användning
browser.setCookies({ name, value, path, domain, secure, httpOnly, expiry, sameSite })
Parametrar
Namn | Typ | Detaljer |
---|---|---|
cookie | Array<WebDriverCookie>, WebDriverCookie | cookie-objekt eller objektarray. |
cookie.name valfri | String | Namnet på cookien. |
cookie.value valfri | String | Cookie-värdet. |
cookie.path valfri | String | Cookie-sökvägen. Standardvärdet är "/" om det utelämnas när en cookie läggs till. |
cookie.domain valfri | String | Domänen som cookien är synlig för. Standardvärdet är den aktuella bläddringssammanhangets aktiva dokumentets URL-domän om det utelämnas när en cookie läggs till. |
cookie.secure valfri | Boolean | Om cookien är en säker cookie. Standardvärdet är false om det utelämnas när en cookie läggs till. |
cookie.httpOnly valfri | Boolean | Om cookien är en HTTP-only cookie. Standardvärdet är false om det utelämnas när en cookie läggs till. |
cookie.expiry valfri | Number | När cookien upphör att gälla, angivet i sekunder sedan Unix Epoch. Får inte anges om det utelämnas när en cookie läggs till. |
cookie.sameSite valfri | String | Om cookien tillämpar en SameSite-policy. Standardvärdet är None om det utelämnas när en cookie läggs till. Kan ställas in på antingen "Lax" eller "Strict". |
Exempel
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'}
// ]
});