Spec-Zone.ru › Angular

тест

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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API