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

restoreState

Обзор

Команда для восстановления данных (cookies, local and session storages) из файла или объекта.

warning

Если вы используете webdriver automation protocol вы должны установить webSocketUrl: true в desiredCapabilities для браузера в конфиге. Для devtools protocol не нужно дополнительных настроек.

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

Вы можете восстановить данные из файла (используя параметр path) или из объекта (используя параметрdata) Но если вы укажете оба параметра то данные восстановятся из файла. Так же вы можете указать параметры cookies, localStorage и sessionStorage что бы восстановить только нужные данные. Данные для восстановления вы можете получить из команды saveState.

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

ИмяТипОписание
pathStringПуть к файлу с данными.
dataSaveStateDataОбъект с данными.
cookiesBooleanВключить восстановление кук (true по умолчанию).
localStorageBooleanВключить восстановление localStorage (true по умолчанию).
sessionStorageBooleanВключить восстановление sessionStorage (true по умолчанию).
cookieFilter(cookie: Cookie) => booleanФункция для фильтрации кук, принимает объект куки и возвращает boolean.
await browser.restoreState({
path: "./stateDump.json",
data: stateDump,
cookies: true,
localStorage: true,
sessionStorage: true,
});

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

Восстановление данных из файла.

it("test", async ({ browser }) => {
await browser.url("https://github.com/gemini-testing/testplane");

await browser.restoreState({
path: "./stateDump.json",
cookieFilter: ({ domain }) => domain === ".example.com",
});

// Reload page for see auth result.
await browser.refresh();
});