Перейти к основному содержимому
Открыть Markdown

Проверка страницы в настоящем 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 в разделе Песочницы. Удаление песочницы оставляет скачанный отчет локально. Перед отправкой просмотрите скриншоты и сообщения консоли.

Дальше: запускайте проверку сайта по расписанию.