From c8790004afd2d2613764a9c0fe7c60c419502c45 Mon Sep 17 00:00:00 2001 From: kseniataranov Date: Thu, 9 Jul 2026 19:35:24 +0300 Subject: [PATCH 1/2] docs: minor wording fixes per style guide --- .../basic-guides/browsers-overview.mdx | 27 +++++++++---------- .../current/basic-guides/configuration.mdx | 2 +- .../current/quickstart/index.mdx | 4 +-- 3 files changed, 16 insertions(+), 17 deletions(-) diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/basic-guides/browsers-overview.mdx b/i18n/ru/docusaurus-plugin-content-docs/current/basic-guides/browsers-overview.mdx index 323d36c8..d27fbd57 100644 --- a/i18n/ru/docusaurus-plugin-content-docs/current/basic-guides/browsers-overview.mdx +++ b/i18n/ru/docusaurus-plugin-content-docs/current/basic-guides/browsers-overview.mdx @@ -17,7 +17,7 @@ Testplane запускает тесты в реальных браузерах Вы описываете нужные браузеры в секции [`browsers`](../reference/config/browsers.mdx), а параметр [`gridUrl`](../reference/config/browsers.mdx#grid_url) определяет, откуда их брать: локально, из Docker-грида (например, Selenoid) или из удаленного облака (BrowserStack, Sauce Labs). -**Общая схема работы:** +**Общая схема работы** 1. Testplane читает секцию `browsers` 2. Для каждого браузера берет `gridUrl` (общий или переопределенный на уровне браузера) @@ -71,7 +71,7 @@ export default { Параметр [`headless: true`](../reference/config/browsers.mdx#headless) включает запуск браузера без графического интерфейса. -**Важные моменты:** +**Важные моменты** - Поведение тестов идентично: с точки зрения тестов браузер с `headless: true` и `headless: false` работает полностью одинаково. Например, при запуске с `headless: true` все еще можно делать скриншоты, работать с DOM, выполнять любые команды. @@ -140,19 +140,18 @@ TESTPLANE_BROWSERS_PATH=./node_modules/.testplane npx testplane install-deps #### Удаление браузеров -- Удалите директорию .testplane в домашней папке -- Или удалите каталог, указанный в `TESTPLANE_BROWSERS_PATH` +Удалите директорию .testplane в домашней папке или каталог, указанный в `TESTPLANE_BROWSERS_PATH`. ### Поддержка браузеров {#browser-support} Ниже представлена таблица поддерживаемых браузеров: -| Браузер | Авто-загрузка | Авто-загрузка драйвера | Запуск webdriver | +| Браузер | Автозагрузка | Автозагрузка драйвера | Запуск webdriver | | ------- | ------------- | ---------------------- | ---------------- | | Chrome | + | + | + | | Firefox | + | + | + | -| Edge | - | + | + | -| Safari | - | + | + | +| Edge | − | + | + | +| Safari | − | + | + | Поддерживаемые версии браузеров в зависимости от ОС: @@ -161,9 +160,9 @@ TESTPLANE_BROWSERS_PATH=./node_modules/.testplane npx testplane install-deps | Chrome | 73+ | 73+ | 73+ | 73+ | 73+ | | Firefox | 60+ | 60+ | 60+ | 91+ | 126+ | | Edge | \* | \* | \* | \* | \* | -| Safari | - | \* | - | - | - | +| Safari | − | \* |− | − | − | -> `*` — авто-загрузка браузера не поддерживается, но если браузер установлен пользователем, Testplane будет использовать установленную версию. +> `*` — автозагрузка браузера не поддерживается, но если браузер установлен пользователем, Testplane будет использовать установленную версию. ### Запуск тестов @@ -212,9 +211,9 @@ export default { ## Браузеры в Docker-контейнерах -Docker-контейнеры дают изолированное и воспроизводимое окружение, удобное для CI/CD. Часто используют Selenoid — легковесную реализацию Selenium Grid, которая запускает браузеры внутри контейнеров. +Docker-контейнеры дают изолированное и воспроизводимое окружение, удобное для CI/CD. Часто используют Selenoid — легковесную реализацию Selenium Grid. Она запускает браузеры внутри контейнеров. -**Selenoid:** +**Selenoid** - Управляет браузерами в Docker-контейнерах - Автоматически масштабирует контейнеры @@ -318,7 +317,7 @@ export default { #### Запуск Selenoid -Запустите Selenoid, указав путь к конфигурации (в примере конфиг лежит в `/home/selenoid-config/browsers.json`): +Для запуска Selenoid укажите путь к конфигурации (в примере конфиг лежит в `/home/selenoid-config/browsers.json`): ```bash docker run --rm -d \ @@ -432,13 +431,13 @@ Docker хорошо подходит для CI/CD и скриншотного т ## Удаленные гриды -Облачные сервисы (BrowserStack, Sauce Labs и др.) дают широкий набор браузеров, ОС и реальных устройств для кросс-браузерного тестирования. +Облачные сервисы (такие как BrowserStack и Sauce Labs) дают широкий набор браузеров, ОС и реальных устройств для кросс-браузерного тестирования. ### Подключение и аутентификация Для подключения нужно указать `gridUrl` сервиса и передать учетные данные через `user` и `key`. Рекомендуется хранить их в переменных окружения. -Базовая конфигурация браузеров остается той же, меняется только `gridUrl` и добавляются специфичные опции облачного провайдера: +Базовая конфигурация браузеров остается той же, меняется только `gridUrl`, и добавляются специфичные опции облачного провайдера: ```ts title="testplane.config.ts" export default { diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/basic-guides/configuration.mdx b/i18n/ru/docusaurus-plugin-content-docs/current/basic-guides/configuration.mdx index 739663fa..a675df98 100644 --- a/i18n/ru/docusaurus-plugin-content-docs/current/basic-guides/configuration.mdx +++ b/i18n/ru/docusaurus-plugin-content-docs/current/basic-guides/configuration.mdx @@ -255,7 +255,7 @@ export default { } satisfies ConfigInput; ``` -В этом примере Testplane может запустить до 5 параллельных сессий Chrome и до 3 сессий Firefox, распределяя тесты между 4 воркер-процессами. +В этом примере Testplane может запустить до 5 параллельных сессий Chrome и до 3 сессий Firefox и распределяет тесты между 4 воркер-процессами. ## Тайм-ауты {#timeouts} diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/quickstart/index.mdx b/i18n/ru/docusaurus-plugin-content-docs/current/quickstart/index.mdx index c02e0949..3b72dfae 100644 --- a/i18n/ru/docusaurus-plugin-content-docs/current/quickstart/index.mdx +++ b/i18n/ru/docusaurus-plugin-content-docs/current/quickstart/index.mdx @@ -91,13 +91,13 @@ export default { Полный список параметров конфигурации ищите в [справочнике по конфигурации](../reference/config/main.mdx). -Чтобы загрузить браузеры, описанные в конфиге, отдельно от запуска самого Testplane, выполните команду: +Чтобы загрузить браузеры, которые описаны в конфиге, отдельно от запуска самого Testplane, выполните команду: ```bash npx testplane install-deps ``` -Без предварительного запуска команды недостающие браузеры будут автоматически загружены с первым запуском Testplane. +Если не запустить команду заранее, Testplane автоматически загрузит при первом запуске браузеры, которых не хватает. ## Первый запуск {#first-run} From e9877fce6f39bfc6b2dc6790549ad3b4735e204e Mon Sep 17 00:00:00 2001 From: kseniataranov Date: Thu, 9 Jul 2026 19:42:21 +0300 Subject: [PATCH 2/2] docs(browsers): prettier fix --- .../current/basic-guides/browsers-overview.mdx | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/basic-guides/browsers-overview.mdx b/i18n/ru/docusaurus-plugin-content-docs/current/basic-guides/browsers-overview.mdx index d27fbd57..918e7c47 100644 --- a/i18n/ru/docusaurus-plugin-content-docs/current/basic-guides/browsers-overview.mdx +++ b/i18n/ru/docusaurus-plugin-content-docs/current/basic-guides/browsers-overview.mdx @@ -147,11 +147,11 @@ TESTPLANE_BROWSERS_PATH=./node_modules/.testplane npx testplane install-deps Ниже представлена таблица поддерживаемых браузеров: | Браузер | Автозагрузка | Автозагрузка драйвера | Запуск webdriver | -| ------- | ------------- | ---------------------- | ---------------- | -| Chrome | + | + | + | -| Firefox | + | + | + | -| Edge | − | + | + | -| Safari | − | + | + | +| ------- | ------------ | --------------------- | ---------------- | +| Chrome | + | + | + | +| Firefox | + | + | + | +| Edge | − | + | + | +| Safari | − | + | + | Поддерживаемые версии браузеров в зависимости от ОС: @@ -160,7 +160,7 @@ TESTPLANE_BROWSERS_PATH=./node_modules/.testplane npx testplane install-deps | Chrome | 73+ | 73+ | 73+ | 73+ | 73+ | | Firefox | 60+ | 60+ | 60+ | 91+ | 126+ | | Edge | \* | \* | \* | \* | \* | -| Safari | − | \* |− | − | − | +| Safari | − | \* | − | − | − | > `*` — автозагрузка браузера не поддерживается, но если браузер установлен пользователем, Testplane будет использовать установленную версию.