تنظیم کوکی‌ها

یک یا چند کوکی را برای صفحه فعلی تنظیم می‌کند. مطمئن شوید که در صفحه‌ای هستید که باید کوکی را دریافت کند. شما نمی‌توانید یک کوکی را برای یک صفحه دلخواه بدون حضور در آن صفحه تنظیم کنید.

استفاده

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