TestCase

TestCase соответствует каждому вызову test() в файле тестов. Если один вызов test() выполняется в нескольких проектах или повторяется несколько раз, в наборах соответствующих проектов будет несколько объектов TestCase.

Методы​

ok​

Считается ли выполнение теста успешным. Неуспешные тесты приводят к завершению запуска тестов с ненулевым кодом выхода.

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

testCase.ok();

Возвращает

• boolean

outcome​

Результат выполнения этого теста. Обратите внимание, что результат выполнения не совпадает с testResult.status:

• Тест, который должен завершиться ошибкой и действительно завершается ошибкой, считается 'expected'.
• Тест, который проходит со второй попытки, считается 'flaky'.

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

testCase.outcome();

Возвращает

• "skipped" | "expected" | "unexpected" | "flaky"

titlePath​

Возвращает список заголовков от корневого элемента до этого теста.

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

testCase.titlePath();

Возвращает

• Array<string>

Свойства​

annotations​

testResult.annotations последнего запуска теста.

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

testCase.annotations

Тип

• Array<Object>

  • type string

    Тип аннотации, например 'skip' или 'fail'.

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

    Необязательное описание.

  • location Location (необязательно)

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

expectedStatus​

Ожидаемый статус теста.

• Ожидается, что тесты, помеченные как test.skip() или test.fixme(), будут 'skipped'.
• Ожидается, что тесты, помеченные как test.fail(), будут 'failed'.
• Ожидается, что остальные тесты будут 'passed'.

Фактический статус см. также в testResult.status.

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

testCase.expectedStatus

Тип

• "passed" | "failed" | "timedOut" | "skipped" | "interrupted"

id​

Идентификатор теста, вычисляемый на основе имени файла теста, заголовка теста и имени проекта. Идентификатор уникален в рамках сеанса Playwright.

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

testCase.id

Тип

• string

location​

Расположение в исходном коде, где определён тест.

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

testCase.location

Тип

• Location

parent​

Набор, которому принадлежит этот тестовый пример.

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

testCase.parent

Тип

• Suite

repeatEachIndex​

Содержит индекс повтора при запуске в режиме «повторять каждый». Этот режим включается передачей --repeat-each в командную строку.

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

testCase.repeatEachIndex

Тип

• number

results​

Результаты каждого запуска этого теста.

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

testCase.results

Тип

• Array<TestResult>

retries​

Максимальное количество повторных попыток для этого теста, заданное в конфигурации.

Подробнее о повторных попытках тестов.

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

testCase.retries

Тип

• number

tags​

Список тегов, заданных для теста или набора с помощью test() или test.describe(), а также токенов @, извлечённых из заголовков тестов и наборов.

Подробнее о тегах тестов.

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

testCase.tags

Тип

• Array<string>

timeout​

Тайм-аут, заданный для теста. На него влияют testConfig.timeout, testProject.timeout, test.setTimeout(), test.slow() и testInfo.setTimeout().

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

testCase.timeout

Тип

• number

title​

Заголовок теста, переданный в вызов test().

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

testCase.title

Тип

• string

type​

Возвращает "test". Полезно для определения тестовых примеров в suite.entries().

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

testCase.type

Тип

• "test"