குக்கீகளை அமைக்க
தற்போதைய பக்கத்திற்கு ஒன்று அல்லது அதற்கு மேற்பட்ட குக்கீகளை அமைக்கிறது. குக்கீயைப் பெற வேண்டிய பக்கத்தில் நீங்கள் இருப்பதை உறுதிப்படுத்திக் கொள்ளுங்கள். அந்த பக்கத்தில் இல்லாமல் ஒரு தன்னிச்சையான பக்கத்திற்கு குக்கீயை அமைக்க முடியாது.
பயன்பாடு
browser.setCookies({ name, value, path, domain, secure, httpOnly, expiry, sameSite })
அளவுருக்கள்
பெயர் | வகை | விவரங்கள் |
---|---|---|
cookie | Array<WebDriverCookie>, WebDriverCookie | குக்கீ பொருள் அல்லது பொருள் வரிசை. |
cookie.name விருப்பத்தேர்வு | String | குக்கீயின் பெயர். |
cookie.value விருப்பத்தேர்வு | String | குக்கீ மதிப்பு. |
cookie.path விருப்பத்தேர்வு | String | குக்கீ பாதை. குக்கீயை சேர்க்கும்போது விடப்பட்டால் இயல்பாக "/" ஆக இருக்கும். |
cookie.domain விருப்பத்தேர்வு | String | குக்கீ காணக்கூடிய டொமைன். குக்கீயை சேர்க்கும்போது விடப்பட்டால், தற்போதைய உலாவும் சூழலின் செயலில் உள்ள ஆவணத்தின் URL டொமைனுக்கு இயல்பாக அமைக்கப்படும். |
cookie.secure விருப்பத்தேர்வு | Boolean | குக்கீ பாதுகாப்பான குக்கீயா என்பது. குக்கீயை சேர்க்கும்போது விடப்பட்டால் இயல்பாக 'false' ஆக இருக்கும். |
cookie.httpOnly விருப்பத்தேர்வு | Boolean | குக்கீ HTTP மட்டும் குக்கீயா என்பது. குக்கீயை சேர்க்கும்போது விடப்பட்டால் இயல்பாக 'false' ஆக இருக்கும். |
cookie.expiry விருப்பத்தேர்வு | Number | குக்கீ காலாவதியாகும் நேரம், யூனிக்ஸ் எபாக் முதல் வினாடிகளில் குறிப்பிடப்பட்டுள்ளது. குக்கீயை சேர்க்கும்போது விடப்பட்டால் அமைக்கப்படக்கூடாது. |
cookie.sameSite விருப்பத்தேர்வு | String | குக்கீ SameSite கொள்கைக்கு பொருந்துமா என்பது. குக்கீயை சேர்க்கும்போது விடப்பட்டால் இயல்பாக 'None' ஆக இருக்கும். "Lax" அல்லது "Strict" என அமைக்கலாம். |
எடுத்துக்காட்டு
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'}
// ]
});