Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -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` (общий или переопределенный на уровне браузера)
Expand Down Expand Up @@ -71,7 +71,7 @@ export default {

Параметр [`headless: true`](../reference/config/browsers.mdx#headless) включает запуск браузера без графического интерфейса.

**Важные моменты:**
**Важные моменты**

- Поведение тестов идентично: с точки зрения тестов браузер с `headless: true` и `headless: false` работает полностью одинаково. Например, при запуске с `headless: true` все еще можно делать скриншоты, работать с DOM, выполнять любые команды.

Expand Down Expand Up @@ -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 |
| ------- | ------------- | ---------------------- | ---------------- |
| Chrome | + | + | + |
| Firefox | + | + | + |
| Edge | - | + | + |
| Safari | - | + | + |
| Браузер | Автозагрузка | Автозагрузка драйвера | Запуск webdriver |
| ------- | ------------ | --------------------- | ---------------- |
| Chrome | + | + | + |
| Firefox | + | + | + |
| Edge | | + | + |
| Safari | | + | + |

Поддерживаемые версии браузеров в зависимости от ОС:

Expand All @@ -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 будет использовать установленную версию.

### Запуск тестов

Expand Down Expand Up @@ -212,9 +211,9 @@ export default {

## Браузеры в Docker-контейнерах

Docker-контейнеры дают изолированное и воспроизводимое окружение, удобное для CI/CD. Часто используют Selenoid — легковесную реализацию Selenium Grid, которая запускает браузеры внутри контейнеров.
Docker-контейнеры дают изолированное и воспроизводимое окружение, удобное для CI/CD. Часто используют Selenoid — легковесную реализацию Selenium Grid. Она запускает браузеры внутри контейнеров.

**Selenoid:**
**Selenoid**

- Управляет браузерами в Docker-контейнерах
- Автоматически масштабирует контейнеры
Expand Down Expand Up @@ -318,7 +317,7 @@ export default {

#### Запуск Selenoid

Запустите Selenoid, указав путь к конфигурации (в примере конфиг лежит в `/home/selenoid-config/browsers.json`):
Для запуска Selenoid укажите путь к конфигурации (в примере конфиг лежит в `/home/selenoid-config/browsers.json`):

```bash
docker run --rm -d \
Expand Down Expand Up @@ -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 {
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -255,7 +255,7 @@ export default {
} satisfies ConfigInput;
```

В этом примере Testplane может запустить до 5 параллельных сессий Chrome и до 3 сессий Firefox, распределяя тесты между 4 воркер-процессами.
В этом примере Testplane может запустить до 5 параллельных сессий Chrome и до 3 сессий Firefox и распределяет тесты между 4 воркер-процессами.

## Тайм-ауты {#timeouts}

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -91,13 +91,13 @@ export default {

Полный список параметров конфигурации ищите в [справочнике по конфигурации](../reference/config/main.mdx).

Чтобы загрузить браузеры, описанные в конфиге, отдельно от запуска самого Testplane, выполните команду:
Чтобы загрузить браузеры, которые описаны в конфиге, отдельно от запуска самого Testplane, выполните команду:

```bash
npx testplane install-deps
```

Без предварительного запуска команды недостающие браузеры будут автоматически загружены с первым запуском Testplane.
Если не запустить команду заранее, Testplane автоматически загрузит при первом запуске браузеры, которых не хватает.

## Первый запуск {#first-run}

Expand Down
Loading