Проверка страницы в настоящем Chromium без установки
На ноутбуке все хорошо, а на телефоне макет разъезжается и в консоли сыплются ошибки. Прогоните страницу через настоящий Chromium в песочнице Just Run: вернутся два скриншота — десктопный и мобильный, — список ошибок консоли и HTML-отчет, который можно приложить к задаче. Ни браузер, ни Playwright ставить не придется.
- Скачайте: проект
- Вам понадобится: Python 3.10+ локально, шаблон
playwrightна Just Run.
Запуск
Распакуйте архив browser-check. В аккаунте должна быть квота на создание хотя бы одной песочницы (2 vCPU, 2048 МиБ RAM) и права на шаблон playwright. Из этой песочницы нужен исходящий доступ к проверяемому сайту.
Настройка доступа к API (один раз)
Укажите HTTPS-адрес платформы и персональный токен с правами Полные:
export JUSTRUN_API="https://your-just-run-host"
read -rsp 'just-run PAT: ' JUSTRUN_PAT; printf '\n'
export JUSTRUN_PAT
cd browser-check
python3 run.py https://your-site.example
Замените https://your-site.example на адрес страницы своего приложения. Скрипт создаст песочницу из шаблона playwright, откроет в ней страницу, снимет скриншоты, скачает отчет и удалит песочницу. Chromium работает в песочнице, поэтому локально устанавливать браузер не нужно.
Что получится
Откройте browser-report/index.html, чтобы посмотреть визуальный отчет. Сырые данные сохраняются рядом в report.json — оба файла удобно прикреплять к задачам и баг-репортам.
В отчете фиксируются:
- Скриншоты в десктопном (1440 × 900) и мобильном (390 × 844) разрешениях.
- Ошибки JavaScript, вызовы
console.error, сетевые сбои и HTTP-ошибки при загрузке страницы. - Базовые проблемы верстки: горизонтальный скролл и изображения без атрибута
alt.
Ограничения проверки: скрипт не заменяет полноценное тестирование. Он не умеет авторизоваться в аккаунте, переходить по внутренним ссылкам или гарантировать соответствие стандартам доступности. Просматривайте отчет вручную.
Ошибки в отчете сделаны намеренно: это не результат проверки живого сайта.
Как адаптировать
Браузером управляет check.cjs, а работу с платформой берет на себя run.py: создание песочницы, ожидание готовности, передачу файлов и очистку. Добавьте в check.cjs шаг для важного взаимодействия в вашем приложении:
await page.getByRole('button', { name: 'Open menu' }).click();
await page.screenshot({ path: 'menu-open.png' });
Менять имеет смысл именно эту часть. Второй запуск в ту же папку завершится ошибкой, поэтому для следующей проверки добавьте к команде флаг --output:
python3 run.py https://your-site.example --output another-report
Удаление ресурсов
И после успеха, и после ошибки скрипт удаляет временную песочницу. Если очистка прервалась, сохраните .browser-check-state.json и повторите:
python3 run.py --cleanup
Если API недоступен, позднее найдите выведенный ID в разделе Песочницы. Удаление песочницы оставляет скачанный отчет локально. Перед отправкой просмотрите скриншоты и сообщения консоли.