Перейти к основному содержимому

setCookies

Обзор​

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

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

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

await browser.setCookies(cookies);

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

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

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

ИмяТипПо умолчаниюОписание
nameStringN/AИмя cookie.
valueStringN/AЗначение cookie.
pathString"/"Путь к cookie.
domainStringсм. описаниеДомен, для которого будет видна cookie. Если домен не указан, то подразумевается домен урла активного документа в текущем контексте браузера.
secureBooleanfalseПризнак безопасной cookie.
httpOnlyBooleanfalseПризнак cookie только для http.
expiryNumberне устанавливаетсяСрок годности cookie в секундах от начала эпохи Unix.
sameSiteString"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' }
    // ]
});