тест
ng test [project] [options]
ng t [project] [options]
Принимает имя проекта, указанное в разделе projects файла конфигурации рабочей области angular.json. Если имя проекта не указано, команда будет выполнена для всех проектов.
Аргументы
project
Имя проекта для сборки. Это может быть приложение или библиотека.
Тип значения
string
Параметры
browser-viewport
Задает размеры области просмотра браузера для тестов в браузере в формате widthxheight.
Тип значения
string
browsers
Задает браузеры для выполнения тестов. Если параметр не указан, тесты запускаются в среде Node.js с использованием jsdom. Для Vitest и Karma имена браузеров, заканчивающиеся на 'Headless' (например, 'ChromeHeadless'), включают безголовый режим.
Тип значения
array
build-target
Задает цель сборки для модульных тестов в формате project:target[:configuration]. По умолчанию используется цель build текущего проекта с конфигурацией development. Также можно передать список конфигураций, разделенных запятыми. Пример: project:target:production,staging.
Тип значения
string
configuration
Одна или несколько именованных конфигураций сборщика в виде списка, разделенного запятыми, как указано в разделе "configurations" файла angular.json. Сборщик использует именованные конфигурации для запуска заданной цели. Дополнительные сведения см. в разделе https://angular.dev/reference/configs/workspace-config#alternate-build-configurations.
Тип значения
string
coverage
Включает сбор данных о покрытии тестами. Если параметр не указан, используется конфигурация покрытия из файла конфигурации средства запуска, если он есть. В противном случае сбор данных о покрытии по умолчанию отключен.
Тип значения
boolean
coverage-exclude
Задает glob-шаблоны файлов, которые нужно исключить из отчета о покрытии.
Тип значения
array
coverage-include
Задает glob-шаблоны файлов, которые нужно включить в отчет о покрытии.
Тип значения
array
coverage-reporters
Задает средства формирования отчетов о покрытии. Каждое средство можно указать строкой с его именем или кортежем, содержащим имя и объект параметров. Встроенные средства формирования отчетов: 'html', 'lcov', 'lcovonly', 'text', 'text-summary', 'cobertura', 'json' и 'json-summary'.
Тип значения
arrayДопустимые значения
cobertura, html, json, json-summary, lcov, lcovonly, text, text-summary
debug
Включает режим отладки тестов, позволяя использовать Node Inspector.
Тип значения
booleanПо умолчанию
false
exclude
Задает glob-шаблоны файлов, которые нужно исключить из тестирования относительно корневого каталога проекта.
Тип значения
array
filter
Задает шаблон регулярного выражения для сопоставления с именами наборов тестов и тестов. Будут выполнены только тесты, имена которых соответствуют шаблону. Например, ^App запустит только тесты из наборов, начинающихся с 'App'.
Тип значения
string
headless
Принудительно запускает все настроенные браузеры в безголовом режиме. При использовании средства запуска Vitest этот параметр игнорируется, если браузеры не настроены. Средство запуска Karma не поддерживает этот параметр.
Тип значения
boolean
help
Выводит справочное сообщение об этой команде в консоль.
Тип значения
boolean
include
Задает glob-шаблоны файлов для тестирования относительно корневого каталога проекта. Этот параметр также особым образом обрабатывает пути к каталогам (включает все находящиеся в них файлы тестов) и пути к файлам (включает соответствующий файл теста, если он существует).
Тип значения
arrayПо умолчанию
**/*.spec.ts,**/*.test.ts
isolate
Включает изоляцию при выполнении тестов. Если параметр имеет значение true, Vitest запускает тесты в отдельных потоках или процессах. Этот параметр доступен только для средства запуска Vitest. По умолчанию имеет значение false для соответствия поведению Karma/Jasmine.
Тип значения
boolean
list-tests
Выводит список всех найденных файлов тестов и завершает процесс без сборки и выполнения тестов.
Тип значения
booleanПо умолчанию
false
output-file
Задает путь к файлу отчета о тестировании; применяется только к первому средству формирования отчетов. Чтобы настроить выходные файлы для нескольких средств формирования отчетов, используйте формат кортежа ['reporter-name', { outputFile: '...' }] в параметре reporters. Если параметр не задан, данные выводятся в консоль.
Тип значения
string
progress
Отображает сведения о ходе сборки в консоли. По умолчанию используется значение параметра progress для указанной цели buildTarget.
Тип значения
boolean
providers-file
Задает путь к файлу TypeScript, который предоставляет массив провайдеров Angular для тестовой среды. Файл должен содержать экспорт массива провайдеров по умолчанию.
Тип значения
string
quiet
Скрывает подробную сводку сборки и таблицу статистики при каждой повторной сборке. По умолчанию имеет значение true в локальной среде и false в средах CI.
Тип значения
boolean
reporters
Задает средства формирования отчетов для выполнения тестов. Каждое средство можно указать строкой с его именем или кортежем, содержащим имя и объект параметров. Встроенные средства формирования отчетов: 'default', 'verbose', 'dots', 'json', 'junit', 'tap', 'tap-flat' и 'html'. Также можно указать путь к пользовательскому средству формирования отчетов.
Тип значения
array
runner
Задает средство запуска тестов.
Тип значения
stringДопустимые значения
karma, vitestПо умолчанию
vitest
runner-config
Задает файл конфигурации выбранного средства запуска тестов. Если указана строка, она будет использоваться как путь к файлу конфигурации. Если указано true, сборщик выполнит поиск файла конфигурации по умолчанию (например, vitest-base.config.ts или karma.conf.js). Если указано false, внешний файл конфигурации использоваться не будет.\nДля Vitest это включает расширенные параметры и возможность использовать пользовательские плагины. Обратите внимание: хотя файл загружается, команда Angular не оказывает непосредственную поддержку его содержимого или сторонних плагинов, используемых в нем.
Тип значения
string
setup-files
Список путей к глобальным файлам настройки, выполняемым перед файлами тестов. Полифиллы приложения и Angular TestBed всегда инициализируются до выполнения этих файлов.
Тип значения
array
ts-config
Путь к файлу конфигурации TypeScript относительно корня рабочей области. По умолчанию используется tsconfig.spec.json в корневом каталоге проекта, если он существует. Если параметр не указан и файл по умолчанию отсутствует, будет использован tsConfig из указанной цели buildTarget.
Тип значения
string
ui
Включает интерфейс Vitest для интерактивного выполнения тестов. Этот параметр доступен только для средства запуска Vitest.
Тип значения
boolean
watch
Включает режим наблюдения, в котором тесты запускаются повторно при изменении исходных файлов. По умолчанию имеет значение true в средах TTY и false в остальных случаях.
Тип значения
boolean
Super-powered by Google ©2010–2025.
Code licensed under an MIT-style License. Documentation licensed under CC BY 4.0.
https://angular.dev/cli/test