TestRun

Управляет тем, какие тесты будут запущены и каков их ожидаемый статус, а также предоставляет информацию о режимах выполнения наборов тестов. Объект TestRun доступен во время вызова reporter.preprocess(). Проекты настройки и очистки (setup и teardown) изменять нельзя.

---

Методы

exclude

Добавлено в: v1.62 testRun.exclude

Исключает тест или набор тестов из запуска. Исключённые тесты не отображаются в отчёте, а их тела не выполняются.

Использование

testRun.exclude(test);

Аргументы

• test TestCase | Suite#

  Тест или набор тестов, который нужно исключить. Корневой набор тестов исключить нельзя.

---

fail

Добавлено в: v1.62 testRun.fail

Помечает тест или каждый тест в наборе как «должен завершиться с ошибкой». Playwright запускает эти тесты и проверяет, что они действительно завершаются с ошибкой. Это полезно для документирования неработающей функциональности до её исправления.

Использование

testRun.fail(test);
testRun.fail(test, reason);

Аргументы

• test TestCase | Suite#

  Тест или набор тестов, для которого нужно отметить ожидаемое завершение с ошибкой.

• reason string (необязательно)#

  Необязательное пояснение, которое отображается в описании аннотации.

---

fixme

Добавлено в: v1.62 testRun.fixme

Помечает тест или каждый тест в наборе как fixme. Тела тестов не выполняются, а сами тесты отображаются в отчёте как пропущенные с намерением исправить их в дальнейшем.

Использование

testRun.fixme(test);
testRun.fixme(test, reason);

Аргументы

• test TestCase | Suite#

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

• reason string (необязательно)#

  Необязательное пояснение, которое отображается в описании аннотации.

---

mode

Добавлено в: v1.65 testRun.mode

Возвращает режим выполнения, настроенный для набора тестов с помощью test.describe.configure(), test.describe.serial() или test.describe.parallel(). Если для набора режим не настроен, он наследует режим родительского набора. Наборы тестов проектов используют "parallel", когда включён testProject.fullyParallel, и "default" в противном случае. Корневой набор тестов использует "default".

Набор тестов с явно заданным режимом "default" не наследует "parallel" от родительского набора: его тесты выполняются по порядку в одном и том же рабочем процессе. Сам по себе режим не определяет полностью группы выполнения тестов, которые также зависят от фикстур рабочего процесса и хуков.

Этот метод можно вызывать только во время reporter.preprocess(). Он также позволяет проверять режим проектов настройки и очистки (setup и teardown).

Использование

testRun.mode(suite);

Аргументы

• suite Suite#

  Набор тестов, режим которого нужно проверить.

Возвращает

• "serial" | "parallel" | "default"#

---

skip

Добавлено в: v1.62 testRun.skip

Пропускает тест или каждый тест в наборе. Тела тестов не выполняются, а сами тесты отображаются в отчёте как пропущенные.

Использование

testRun.skip(test);
testRun.skip(test, reason);

Аргументы

• test TestCase | Suite#

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

• reason string (необязательно)#

  Необязательное пояснение, которое отображается в описании аннотации.

---

skipSharding

Добавлено в: v1.62 testRun.skipSharding

Отключает встроенный фильтр шардов Playwright для текущего запуска, передавая распределение тестов по шардам репортёру. Репортёры обычно реализуют собственное распределение по шардам, вызывая testRun.exclude() для тестов, не входящих в текущий шард.

Использование

testRun.skipSharding();