setCookies

Обзор

Используйте команду setCookies, чтобы установить cookies на текущей странице.

Убедитесь, что вы находитесь именно на той странице, для которой вы хотите установить cookies. Вы не можете установить cookies для произвольной страницы, не находясь при этом на ней.

Использование

await browser.setCookies(cookies);

Параметры команды

Имя	Тип	Описание
cookies	WebDriver.Cookie или WebDriver.Cookie[]	Объект cookie или массив объектов cookie.

Параметры объекта WebDriver.Cookie

Имя	Тип	По умолчанию	Описание
name	String	N/A	Имя cookie.
value	String	N/A	Значение cookie.
path	String	"/"	Путь к cookie.
domain	String	см. описание	Домен, для которого будет видна cookie. Если домен не указан, то подразумевается домен урла активного документа в текущем контексте браузера.
secure	Boolean	false	Признак безопасной cookie.
httpOnly	Boolean	false	Признак cookie только для http.
expiry	Number	не устанавливается	Срок годности cookie в секундах от начала эпохи Unix.
sameSite	String	"None"	Признак подчинения cookie политике SameSite. Допустимые значения: "Lax" или "Strict".

Примеры использования

it("should set a cookie for the page", async ({ browser }) => {
    await browser.url("/");

    // устанавливаем одну cookie
    await browser.setCookies({
        name: "test1",
        value: "one",
        // Следующие параметры опциональны:
        // путь к cookie, по умолчанию: "/"
        //      path: '/foo',
        // домен, для которого будет видна cookie
        // по умолчанию: домен урла активного документа в текущем контексте браузера
        //      domain: '.example.com',
        // признак, что это безопасная cookie, по умолчанию: false
        //      secure: true,
        // признак, что это cookie только для http, по умолчанию: false
        //      httpOnly: true,
        // срок, когда cookie истекает, указывается в секундах с начала эпохи Unix
        //      expiry: 1551393875
    });

    // устанавливаем несколько cookies
    await browser.setCookies([
        { name: "test2", value: "two" },
        { name: "test3", value: "three" },
    ]);

    const cookies = await browser.getCookies();

    await console.log(cookies);
    // выведет:
    // [
    //      { name: 'test1', value: 'one', domain: 'www.example.com' },
    //      { name: 'test2', value: 'two', domain: 'www.example.com' },
    //      { name: 'test3', value: 'three', domain: 'www.example.com' }
    // ]
});

Связанные команды

• getCookies
• deleteCookies