Гигиена тестовых данных и состояния браузера в автоматизации
Назначайте владельцев синтетическим данным, состоянию браузера и очистке для каждого изолированного worker.
BotBrowser Team
Нужна структурированная документация по теме Идентичность?
Эта статья относится к редакционной библиотеке. Для пошаговой настройки, справки и постоянных обновлений переходите сразу в соответствующий раздел docs.
Надёжный тест заранее называет вход, владельца, наблюдаемый результат и границу очистки. Новый контекст не делает общими аккаунт, запись сервера или каталог загрузки независимыми. Используйте синтетические данные из документированного тестового интерфейса, а не персональные документы или реальные учётные данные. См. руководство по fixture и изоляции.
В этих пределах BotBrowser предоставляет изолированные BrowserContexts для разрешённых синтетических тестов, каждый со своими cookies, хранилищем браузера и состоянием сеанса. Это не песочница ОС и не гарантия завершения серверной сессии, удаления серверных записей или фоновых задач.
TL;DR: кратко
- Назначайте явного владельца каждой синтетической записи, контекста браузера, каталога артефактов и удалённой задачи.
- Закрытие контекста очищает только клиентское состояние; записи и задачи сервера нужно отдельно проверять через документированные интерфейсы.
- Используйте изоляцию BotBrowser для сравнения контролируемого состояния браузера, а очистку сервиса, секреты и хранение оставляйте их фактическим владельцам.
Содержание
- Матрица владельцев
- Сбойная fixture
- Таблица решений
- Защищайте секреты и артефакты
- Проверяйте повторы и параллельность
- Итог
- Возможность и ограничение BotBrowser
Матрица владельцев
| Ресурс | Создатель | Владелец изменений | Наблюдение | Граница очистки |
|---|---|---|---|---|
| Синтетический аккаунт | тестовый сервис | worker сценария | заголовок или доступ | API сброса |
| Контекст и cookies | fixture | fixture | чистый контекст | закрытие в finally |
| Базовое состояние | репозиторий | копия fixture | загруженный маршрут | хранить baseline; удалить копию |
| Каталог артефактов | worker | worker | короткая квитанция | удалить локальный путь |
| Удалённая задача | приложение | сервис | документированный статус | отмена или истечение |
Закрытие контекста не доказывает удаление записи сервера. Загружайте baseline только для чтения, а новую копию именуйте worker и попыткой. Разным worker нужны разные синтетические записи либо явно сериализованная мутация.
Сбойная fixture
Страница без маркера готовности проверяет ограниченный сбой и очистку:
import os from 'node:os';
import path from 'node:path';
import { mkdtemp, rm } from 'node:fs/promises';
import { chromium } from 'playwright';
import { expect } from '@playwright/test';
let dir;
let browser;
let context;
let page;
let failure;
const remember = (label, error) => {
const current = new Error(`${label}: ${error.message}`, { cause: error });
failure = failure ? new AggregateError([failure, current], `${failure.message}; ${label} failed`) : current;
};
try {
dir = await mkdtemp(path.join(os.tmpdir(), 'state-hygiene-'));
browser = await chromium.launch({ headless: true });
context = await browser.newContext({ baseURL: 'http://fixture.test' });
page = await context.newPage();
await page.route('/fixtures/without-ready-marker', route =>
route.fulfill({ status: 200, contentType: 'text/html', body: '<main><p>Waiting</p></main>' })
);
await page.goto('/fixtures/without-ready-marker');
await expect(page.getByRole('status')).toHaveText('Ready', { timeout: 250 });
} catch (error) {
remember('инициализация или проверка fixture', error);
} finally {
if (context) {
try {
await context.close();
} catch (error) {
remember('закрытие контекста', error);
}
}
if (dir) {
try {
await rm(dir, { recursive: true, force: true });
} catch (error) {
remember('очистка артефакта', error);
}
}
if (browser) {
try {
await browser.close();
} catch (error) {
remember('закрытие браузера', error);
}
}
}
if (failure) throw failure;
Таблица решений
| Наблюдение | Категория | Действие | Не доказано |
|---|---|---|---|
| Нет baseline | fixture | остановить тест и исправить вход | доступность сервиса |
| Видны старые cookies | состояние браузера | выбросить контекст | отзыв серверной сессии |
| Worker перезаписывают запись | тестовые данные | разделить или сериализовать | ошибка BrowserContext |
| Проверка прошла, очистка нет | инфраструктура | сохранить обе ошибки | удаление на сервере |
| Повтор успешен | неопределённый результат | запросить поддерживаемый статус | безопасность первой попытки |
Проверяйте переходы состояния
Рассматривайте состояние как последовательность: baseline, видимая проверка и очистка. Смена аккаунта требует штатного выхода и нового контекста; удаление локального хранилища не отзывает удалённую сессию. Версию baseline нужно сохранять, а неполный файл отклонять, не создавая его молча заново. О версиях, квоте и очистке IndexedDB рассказывает материал Жизненный цикл IndexedDB: версии, квота и очистка.
Защищайте секреты и артефакты
Снимок состояния может содержать cookies. Ограничьте права, храните короткую квитанцию со сценарием, worker, результатом и очисткой. Не записывайте токены или текст страницы. Временный каталог и хранение CI имеют разных владельцев. См. также руководство по загрузкам и скачиваниям.
Проверяйте повторы и параллельность
Именуйте файлы scenario, worker и attempt без личных идентификаторов. После тайм-аута запросите поддерживаемый статус до повтора мутации. После обновления запускайте чистый контекст, просроченное состояние, смену аккаунта, параллельный вывод и принудительную очистку.
Повторяемость дают контролируемые входы, а не общий долгоживущий браузер.
Зафиксируйте маршрут, схему fixture, форму синтетической записи и нужную конфигурацию.
Тогда изменение относится к приложению, fixture или runner.
Не используйте общую настройку, которая создаёт аккаунты, выдаёт разрешения и оставляет страницы открытыми.
Такая настройка смешивает причину первого сбоя с эффектами прежних тестов.
Стартовая fixture сообщает о загрузке известного состояния или завершённом документированном входе.
Она не выводит материал сессии.
Fixture данных сообщает метку сценария и результат сброса.
Она не перебирает записи в поиске случайно подходящей.
Отсутствующий вход означает ошибку fixture.
Незапланированная замена делает результат неповторяемым.
Часть состояния живёт вне браузера: например, в симуляторе почты или уведомлений.
Каждой такой зависимости нужен свой синтетический namespace и чек.
Браузер наблюдает подтверждение, но не доказывает все последующие доставки.
Для сервисных фактов используйте документированный тестовый интерфейс сервиса.
Закрытие страницы освобождает её listeners и handles.
Закрытие контекста освобождает состояние этого контекста.
Эти действия сами не удаляют скопированный файл, загруженный объект или token другого устройства.
Выполняйте штатный выход, пока страница доступна.
Затем закрывайте ресурсы браузера и локальный каталог worker. Для Puppeteer те же границы ресурсов описаны в материале Puppeteer: владение BrowserContext и Page и очистка ресурсов.
Сбой очистки приложения может не зависеть от закрытия браузера.
Сохраняйте оба наблюдения в короткой квитанции.
Не ищите похожие профили, каталоги или контексты ради расширенной очистки.
При неудачном удалении процедура восстановления может изолировать только собственный известный каталог.
Синтетическая запись должна быть узнаваемой, но не похожей на персональные данные.
Используйте префикс сценария, метку запуска и значения для нужной проверки.
Для граничного случая меняйте одно объявленное свойство входа.
Сброс возвращает известную baseline, а не угадывает частичное исправление.
Не используйте автоматически метку с незавершённой очисткой.
Проверка описывает то, что видит пользователь или разрешённый тест.
Пустое локальное хранилище не доказывает отзыв удалённой сессии.
Завершённая навигация не доказывает асинхронную задачу.
Записывайте отсутствующий сигнал, неожиданный видимый статус или документированную категорию ошибки.
Перед изменением ожиданий сопоставьте квитанцию сбоя с контрактом и проверьте уникальную тестовую запись, контекст и частный каталог.
Итог
Надёжная автоматизация браузера требует явных владельцев и наблюдаемых границ. Начинайте каждую попытку с синтетических данных, принадлежащих worker, детерминированно закрывайте ресурсы браузера и отдельно сообщайте о серверной очистке и хранении. BotBrowser делает изоляцию клиентского состояния повторяемой, но ненаблюдаемая удалённая операция не становится доказанным удалением.
Возможность и ограничение BotBrowser
BotBrowser предоставляет изолированные BrowserContexts с отдельными cookies, хранилищем и состоянием сессии для разрешённых синтетических сценариев. Это позволяет проверить отсутствие унаследованного клиентского состояния; см. документацию об изоляции аккаунтов. BotBrowser не заменяет управление жизненным циклом Playwright/Selenium, очистку приложения, отзыв серверной сессии или работу с секретами. Он не гарантирует принятие просроченной cookie, отмену задачи или удаление записи провайдера.
Храните только сценарий, worker, видимый результат и статус очистки. Перед изменением fixture выполните чистый контекст, просроченное состояние и этот принудительный сбой.
Источники
Эта статья входит в руководство: Поверхности идентичности браузера: обзор согласованности
Похожие статьи
Надёжные тесты загрузки и скачивания файлов в браузерной автоматизации
Начало работыЖизненный цикл BrowserContext и состояние хранилища в Playwright
Начало работыФикстуры и изоляция браузерной автоматизации
ИдентичностьОчистка данных сайта без нарушения границ аккаунта
ИдентичностьЖизненный цикл браузерной сессии на общем рабочем месте
ИдентичностьУправление резервным копированием и восстановлением профилей браузера
Выполните ту же проверку в BotBrowser
Загрузите профиль, сохраните внутри браузера те сигналы, о которых только что прочитали, и подтвердите результат на своей машине до раскатки.