docs: browsers overview by swordqueen · Pull Request #118 · gemini-testing/testplane-docs

swordqueen · 2026-03-11T12:19:02Z

No description provided.

github-actions · 2026-03-11T12:23:12Z

✅ Successfully deployed static

janair77 · 2026-03-16T11:20:19Z

i18n/ru/docusaurus-plugin-content-docs/current/basic-guides/browsers-overview.mdx

+
+        - Создайте отдельные логические браузеры для ключевых комбинаций (Chrome, Safari, мобильный Chrome и т.д.)
+        - Запускайте регрессию раз в релиз или по расписанию
+        - Анализируйте видео и логи для редких сложно воспроизводимых багов


"сложновоспроизводимых" нужно слитно

janair77

комментарий

shadowusr

В целом получилась очень крутая статья на мой взгляд! 🔥

Ниже оставил ряд предложений по тому, что можно улучшить. Все они не критичные, но думаю еще немного улучшат содержание. Считаю, что почти готово к влитию, очень информативно, просто читается и с соблюдением всех гайдлайнов!

shadowusr · 2026-03-17T19:57:01Z

i18n/ru/docusaurus-plugin-content-docs/current/basic-guides/browsers-overview.mdx

+} satisfies ConfigInput;
+```
+
+Ключ в `browsers` (`chrome`, `chrome-mobile`) — логическое **имя браузера**. Оно используется в CLI и в отчётах. Имя не ограничивает реальные настройки: в `desiredCapabilities` можно указать любой `browserName` и `browserVersion`.


Субъективно, конечно, но я бы не использовал выделение жирным здесь и далее. На мой взгляд, здесь выделение жирным не помогает восприятию информации. Ну и всякие LLMки очень любят сейчас сыпать жирным, не хочется, чтобы было похоже =)

shadowusr · 2026-03-17T20:01:25Z

i18n/ru/docusaurus-plugin-content-docs/current/basic-guides/browsers-overview.mdx

+
+Ключ в `browsers` (`chrome`, `chrome-mobile`) — логическое **имя браузера**. Оно используется в CLI и в отчётах. Имя не ограничивает реальные настройки: в `desiredCapabilities` можно указать любой `browserName` и `browserVersion`.
+
+**Версия браузера** задаётся в `desiredCapabilities.browserVersion`. Для локальных браузеров Testplane скачает нужную версию, если она поддерживается. Для Docker и облака версия должна совпадать с образом или настройками грида.


Тут чуточку корректнее было бы сказать, что для Docker и облака версия должна быть выбрана среди доступных там вариантов.

Образ может называться как угодно — selenoid/firefox:144.0-with-bidi. При этому версия браузера тут будет все еще 144.0, т.е. вообще не обязательно совпадение, важно, что зашито внутри образа.

Не критично

shadowusr · 2026-03-17T20:10:32Z

i18n/ru/docusaurus-plugin-content-docs/current/basic-guides/browsers-overview.mdx

+
+**Версия браузера** задаётся в `desiredCapabilities.browserVersion`. Для локальных браузеров Testplane скачает нужную версию, если она поддерживается. Для Docker и облака версия должна совпадать с образом или настройками грида.
+
+`headless: true` включает **запуск без графического интерфейса**.


Я бы наверное даже сделал это мини-секцией как про мобильную эмуляцию. И подчеркнул парочку моментов:

с точки зрения тестов, поведения браузера с headless true/false полностью одинаково, например, при запуске с headless=true все еще можно делать скриншоты и т.д. (были юзеры, которые путались и думали, что тогда это делать нельзя)

в окружениях, где нет UI, например, в CI джобах, нужно использовать headless=true, т.к. иначе будут ошибки вида cannot open display и т.д.

shadowusr · 2026-03-17T20:15:34Z

i18n/ru/docusaurus-plugin-content-docs/current/basic-guides/browsers-overview.mdx

+
+### Установка зависимостей
+
+Скачать необходимые браузеры и драйверы:


я бы тут уточнил, что будут установлены все браузеры, указанные в конфиге, и для которых поддержана автоматическая установка, "необходимые" не очень понятно

shadowusr · 2026-03-17T20:16:30Z

i18n/ru/docusaurus-plugin-content-docs/current/basic-guides/browsers-overview.mdx

+
+Есть два варианта:
+
+**Через CLI-опцию `--local`:**


тоже думаю можно без жирного

shadowusr · 2026-03-17T20:42:09Z

i18n/ru/docusaurus-plugin-content-docs/current/basic-guides/browsers-overview.mdx

+./firefox/build.sh
+```
+
+Следить за появлением готовых свежих образов можно в [этом issue](https://github.com/gemini-testing/testplane/issues/1212).


Хотелось бы добавить 2 небольших раздела:

Как запустить образ одного браузера и прогнать в нём тесты

docker run -it --rm --privileged -p 4444:4444 -p 5900:5900 -e ENABLE_VNC='true' selenoid/chrome:128.0

Тут gridUrl нужен будет localhost:4444.

Как запустить selenoid с несколькими браузерами и прогнать в нём тесты:

Создаем конфиг browser.json (его можно спрятать под спойлер):

{ "chrome": { "versions": { "128.0": { "image": "selenoid/chrome:128.0", "path": "/", "port": "4444", "shmSize": 2147483648, "tmpfs": { "/tmp": "size=512m" }, "volumes": [ "/tmp/.X11-unix:/tmp/.X11-unix" ] }, }, "firefox": { "versions": { "145.0": { "image": "selenoid/firefox:145.0", "path": "/wd/hub", "port": "4444", "shmSize": 2147483648, "tmpfs": { "/tmp": "size=512m" }, "volumes": [ "/tmp/.X11-unix:/tmp/.X11-unix" ] } } } }

Запускаем selenoid, указав этот конфиг (конфиг лежит в /home/selenoid-config/browsers.json, а в образ прорастет получается в /etc/selenoid/browsers.json):

docker run --rm -d --name selenoid -v /var/run/docker.sock:/var/run/docker.sock -v /home/selenoid-config:/etc/selenoid/:ro --network=host aerokube/selenoid:latest

Такая штука позволит запускать одновременно и chrome, и firefox в образах. И тут gridUrl будет localhost:4444/wd/hub.

Также можно оставить ссылку на доку selenoid для более подробной настройки.

shadowusr · 2026-03-17T20:47:15Z

i18n/ru/docusaurus-plugin-content-docs/current/basic-guides/browsers-overview.mdx

+
+    - Большой выбор браузеров и ОС
+    - Нет необходимости поднимать свою инфраструктуру
+    - Детальные логи и видео


Сюда тоже стоит вписать стабильность скриншотов

shadowusr · 2026-03-17T20:55:46Z

i18n/ru/docusaurus-plugin-content-docs/current/basic-guides/browsers-overview.mdx

+-   Зависимость от операционной системы: скриншоты могут различаться
+-   Нужен контроль за обновлением версий
+
+Локальные браузеры подходят для разработки, быстрого прогона и отладки, но не идеальны для скриншотного тестирования между разными ОС.


У локальных браузеров пропали таблички поддержки автозагрузки и версий. Я думаю, это очень полезная инфа, которую стоит оставить.

shadowusr · 2026-03-17T21:11:00Z

i18n/ru/docusaurus-plugin-content-docs/current/basic-guides/browsers-overview.mdx

+
+Облачные гриды удобны для регулярного кросс-браузерного и мобильного тестирования без поддержки собственной фермы браузеров.
+
+## Практические сценарии


Хм, я бы наверное эти практические сценарии схлопнул в краткое саммари по статье, т.к. эти практические сценарии не совсем практические ИМХО.

Что имею в виду. Описано 3 сценария. При этом все эти 3 сценария обычно есть в каждом проекте, всем надо разрабатываться, всем нужен CI и всем нужно кросс-браузерное тестирование.

Однако у каждого сценария дано свое отдельное решение. Складывается ощущение, что надо в итоге в любом проекте юзать и локальные браузеры, и докер, и грид — звучит сложно и неудобно.

Я бы рекомендовал выбирать что-то одно (либо бить тесты на паки, в каждом из которых выбирать что-то одно):

Локальные браузеры — если не используются скриншотные тесты или для разработки/отладки, где удобна скорость

Docker, если важна стабильность скриншотов и есть готовность работать с образами

Облако — если важна стабильность скриншотов и важна масштабируемость на тысячах тестов для прогона с высокой параллельностью

Как правило, локальные браузеры являются самым простым и удобным вариантом, и двигаться нужно именно от него. Docker/Grid решают конкретные задачи (стабильные скрины и высокая параллельность на гриде), и нужно переходить на них, если локальные браузеры их не закрывают.

shadowusr · 2026-03-17T21:12:47Z

i18n/ru/docusaurus-plugin-content-docs/current/basic-guides/browsers-overview.mdx

Этот файл должен замещать вот эту статью: https://testplane.io/ru/docs/v8/basic-guides/managing-browsers/

Сейчас получилось 2 статьи на 1 тему, которые перекликаются.

Название я бы оставил лакончиное "Браузеры".

…verview

shadowusr

Статья получилась супер. Можно поправить несколько минорных моментов ниже и вливать. Мне всё понравилось. Четко, кратко, понятно и при этом исчерпывающе.

⚠️ Важно не забыть синкнуть изменения в английскую версию!

shadowusr · 2026-04-02T09:22:39Z

i18n/ru/docusaurus-plugin-content-docs/current/basic-guides/browsers-overview.mdx

+
+### Мобильная эмуляция
+
+Для Chrome используйте `goog:chromeOptions.mobileEmulation`:


Давай оставим ссылку на документацию, где можно посмотреть остальные поддерживаемые настройки: https://developer.chrome.com/docs/chromedriver/mobile-emulation

shadowusr · 2026-04-02T09:25:40Z

i18n/ru/docusaurus-plugin-content-docs/current/basic-guides/browsers-overview.mdx

+    }
+```
+
+Для Firefox можно эмулировать мобильный user-agent через `moz:firefoxOptions`:


Давай еще подкинем в пример как задать pixel ratio, window size

shadowusr · 2026-04-02T09:31:31Z

i18n/ru/docusaurus-plugin-content-docs/current/basic-guides/browsers-overview.mdx

+Для Chrome используйте `goog:chromeOptions.mobileEmulation`:
+
+```ts
+"goog:chromeOptions": {


Еще небольшой нюанс по сниппетам с кодом в целом.

У нас в проекте работает prettier, который умеет форматировать код внутри таких сниппетов, поддерживая единый стиль отступов, кавычек, запятых на конце и т.д.

Поэтому важно, чтобы если сниппет обозначен как ts, в нем был валидный код на TS. Сейчас это не так — и такой сниппет не будет форматироваться. Его можно поправить так, например:

const desiredCapabilities = { "goog:chromeOptions": { mobileEmulation: { deviceName: "iPhone 12 Pro", } } };

либо как json, но главное, чтобы объявленный язык сниппета совпадал с реальностью.

Это не прям критичный момент, но nice to have.

shadowusr · 2026-04-02T09:33:42Z

i18n/ru/docusaurus-plugin-content-docs/current/basic-guides/browsers-overview.mdx

+export default {
+    browsers: {
+        chrome: {
+            gridUrl: "http://localhost:4444/wd/hub",


мелочь, но при запуске образа chrome без selenoid gridUrl будет http://localhost:4444 — без wd/hub на конце

shadowusr · 2026-04-02T09:38:06Z

i18n/ru/docusaurus-plugin-content-docs/current/basic-guides/browsers-overview.mdx

+                },
+            },
+            headless: true,
+        },


тут чутка рассинхрон мысленный с browsers.json. там указано два браузера, chrome и firefox, тут тоже 2, но внезапно это chrome и chrome-mobile, а firefox мы тут не юзаем. Зачем настраивали его тогда? =)

Да, я понимаю, что это потому что в других секциях мы этот пример юзаем, и это хорошо, как я и просил!

Но можно тогда или словами просто сказать "нам еще тут firefox доступен благодаря selenoid конфигу". Короче как-то упомянуть этот момент.

kseniataranov added 2 commits March 11, 2026 15:10

docs: browsers overview

78c9ece

docs: translate article

f9ea4ca

swordqueen temporarily deployed to CI March 11, 2026 12:19 — with GitHub Actions Inactive

janair77 reviewed Mar 16, 2026

View reviewed changes

docs: prettier reformat and fix

33e7cb9

swordqueen temporarily deployed to CI March 17, 2026 04:23 — with GitHub Actions Inactive

shadowusr reviewed Mar 17, 2026

View reviewed changes

kseniataranov and others added 4 commits March 23, 2026 10:00

docs: some fixes

a73911b

docs: fixes

ce0abe2

docs: delete old article

270e603

Merge branch 'master' into users/kseniataranov/DOCORG-6611.browsers-o…

a962361

…verview

swordqueen temporarily deployed to CI March 25, 2026 14:36 — with GitHub Actions Inactive

docs(browsers): simplify the browser source selection section

df2f7e8

swordqueen temporarily deployed to CI March 27, 2026 18:07 — with GitHub Actions Inactive

docs(browsers): quick fixes

487d2bd

swordqueen temporarily deployed to CI March 30, 2026 13:01 — with GitHub Actions Inactive

docs(browsers): remove ё

89aed85

swordqueen temporarily deployed to CI March 31, 2026 08:22 — with GitHub Actions Inactive

shadowusr approved these changes Apr 2, 2026

View reviewed changes


		Ключ в `browsers` (`chrome`, `chrome-mobile`) — логическое имя браузера. Оно используется в CLI и в отчётах. Имя не ограничивает реальные настройки: в `desiredCapabilities` можно указать любой `browserName` и `browserVersion`.

		Версия браузера задаётся в `desiredCapabilities.browserVersion`. Для локальных браузеров Testplane скачает нужную версию, если она поддерживается. Для Docker и облака версия должна совпадать с образом или настройками грида.


		Версия браузера задаётся в `desiredCapabilities.browserVersion`. Для локальных браузеров Testplane скачает нужную версию, если она поддерживается. Для Docker и облака версия должна совпадать с образом или настройками грида.

		`headless: true` включает запуск без графического интерфейса.


		### Установка зависимостей

		Скачать необходимые браузеры и драйверы:


		Есть два варианта:

		Через CLI-опцию `--local`:


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

		## Практические сценарии


		### Мобильная эмуляция

		Для Chrome используйте `goog:chromeOptions.mobileEmulation`:

Conversation

swordqueen commented Mar 11, 2026

Uh oh!

github-actions bot commented Mar 11, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

✅ Successfully deployed static

Uh oh!

Choose a reason for hiding this comment

Uh oh!

janair77 left a comment

Choose a reason for hiding this comment

Uh oh!

shadowusr left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

shadowusr left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

github-actions bot commented Mar 11, 2026 •

edited

Loading