# Проверка страницы в настоящем Chromium без установки

На ноутбуке все хорошо, а на телефоне макет разъезжается и в консоли сыплются ошибки. Прогоните страницу через настоящий Chromium в песочнице Just Run: вернутся два скриншота — десктопный и мобильный, — список ошибок консоли и HTML-отчет, который можно приложить к задаче. Ни браузер, ни Playwright ставить не придется.

![Пример отчета с десктопным и мобильным скриншотами](/assets/images/browser-check-preview-5055803907416fab195620117a48030d.png)

* **Скачайте:** [проект](/example-assets/browser-check.zip)
* **Вам понадобится:** Python 3.10+ локально, шаблон `playwright` на Just Run.

## Запуск[​](#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 работает в песочнице**, поэтому локально устанавливать браузер не нужно.

## Что получится[​](#result "Прямая ссылка на Что получится")

Откройте `browser-report/index.html`, чтобы посмотреть визуальный отчет. Сырые данные сохраняются рядом в `report.json` — оба файла удобно прикреплять к задачам и баг-репортам.

В отчете фиксируются:

* Скриншоты в десктопном (**1440 × 900**) и мобильном (**390 × 844**) разрешениях.
* Ошибки JavaScript, вызовы `console.error`, сетевые сбои и HTTP-ошибки при загрузке страницы.
* Базовые проблемы верстки: горизонтальный скролл и изображения без атрибута `alt`.

**Ограничения проверки:** скрипт не заменяет полноценное тестирование. Он не умеет авторизоваться в аккаунте, переходить по внутренним ссылкам или гарантировать соответствие стандартам доступности. Просматривайте отчет вручную.

Пример снят на тестовом стенде

Ошибки в отчете сделаны намеренно: это не результат проверки живого сайта.

## Как адаптировать[​](#customise "Прямая ссылка на Как адаптировать")

Браузером управляет `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
```

## Удаление ресурсов[​](#cleanup "Прямая ссылка на Удаление ресурсов")

И после успеха, и после ошибки скрипт удаляет временную песочницу. Если очистка прервалась, сохраните `.browser-check-state.json` и повторите:

```
python3 run.py --cleanup
```

Если API недоступен, позднее найдите выведенный ID в разделе *Песочницы*. Удаление песочницы оставляет скачанный отчет локально. Перед отправкой просмотрите скриншоты и сообщения консоли.

**Дальше:** [запускайте проверку сайта по расписанию](/examples/run-a-scheduled-job.md).
