Hoppa till huvudinnehåll

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
NamnTypDetaljer
cookieArray<WebDriverCookie>, WebDriverCookiecookie-objekt eller objektarray.
cookie.name
valfri
StringNamnet på cookien.
cookie.value
valfri
StringCookie-värdet.
cookie.path
valfri
StringCookie-sökvägen. Standardvärdet är "/" om det utelämnas när en cookie läggs till.
cookie.domain
valfri
StringDomä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
BooleanOm cookien är en säker cookie. Standardvärdet är false om det utelämnas när en cookie läggs till.
cookie.httpOnly
valfri
BooleanOm cookien är en HTTP-only cookie. Standardvärdet är false om det utelämnas när en cookie läggs till.
cookie.expiry
valfri
NumberNä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
StringOm 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'}
// ]
});

Welcome! How can I help?

WebdriverIO AI Copilot