Отладка в браузере

В ОС Аврора доступны два браузера:

штатный браузер, разработанный на основе движка Gecko 78-ой версии;
браузер (Аврора Браузер), разработанный на основе проекта Chromium актуальной версии. Браузер доступен в ОС Аврора 5.1 и выше.

Штатный браузер

Штатный браузер не предоставляет встроенных инструментов для отладки веб-страниц.

Аврора Браузер

Для отладки веб-приложений разработчику доступен инструментарий DevTools.

Инструментарий DevTools встроен непосредственно в браузер и поддерживает удалённую отладку. Именно его рекомендуется использовать в первую очередь при разработке веб-приложения: при отладке сетевой активности, JavaScript, media pipeline, PWA и т.д.

Команды в данной инструкции приводятся для Unix-совместимого терминала. В Linux и macOS можно использовать стандартный терминал, в Windows необходимо использовать Git Bash.

Для удалённой отладки следует выполнить следующие действия:

Запустить браузер на устройстве со следующими параметрами запуска:

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

Для запуска браузера с пользовательской конфигурацией можно использовать режим с OVERRIDE_ARGS=1, например:
```
OVERRIDE_ARGS=1 ru.omp.browserpwa --url=example.com --preset-default
```
Примечание. При использовании OVERRIDE_ARGS отсутствуют проверки на совместимость передаваемых ключей, поэтому возможен конфликт с внутренней конфигурацией браузера и, как следствие, ошибки в его работе.

Для удалённой отладки браузера необходимо добавить следующие ключи:
- --remote-debugging-port=9222;
- --remote-allow-origins=http://localhost:9229.
```
OVERRIDE_ARGS=1 ru.omp.browserpwa --preset-default --remote-debugging-port=9222 --remote-allow-origins=http://localhost:9229
```
Порты можно выбрать любые.
Пробросить туннель на МУ с компьютера разработчика:
```
ssh -fN -L 9229:localhost:9222 defaultuser@192.168.2.15
```
Порты соответствуют выбранным на первом шаге, IP-адрес соответствует адресу, по которому МУ было подключено к компьютеру разработчика.
Открыть в браузере на компьютере разработчика страницу http://localhost:9229, на которой будут доступны стандартные инструменты разработчика.