test

명령을 실행할 프로젝트 이름입니다. 애플리케이션이나 라이브러리일 수 있습니다.

브라우저 기반 테스트에 사용할 뷰포트 크기를 widthxheight 형식으로 지정합니다.

Specifies the browsers to use for test execution. When not specified, the Vitest runner runs tests in a Node.js environment using happy-dom if it is installed, otherwise jsdom, and the Karma runner uses the browsers of its configuration. Browser names ending with Headless enable headless mode (e.g., ChromiumHeadless for Vitest with the Playwright provider, or ChromeHeadless for Karma).

단위 테스트 빌드에 사용할 빌드 대상을 project:target[:configuration] 형식으로 지정합니다. 기본값은 현재 프로젝트의 build 대상과 development 설정입니다. 설정 목록을 쉼표로 구분해 전달할 수도 있습니다. 예: project:target:production,staging.

angular.json의 "configurations" 섹션에 지정한 빌더 설정 이름을 쉼표로 구분한 목록입니다. 빌더는 지정한 대상 실행에 이 설정을 사용합니다. 자세한 내용은 https://angular.dev/reference/configs/workspace-config#alternate-build-configurations 를 참고하세요.

테스트 커버리지 보고를 활성화합니다. 지정하지 않으면 실행기 설정 파일에 커버리지 설정이 있을 때 해당 설정을 사용합니다. 그렇지 않으면 커버리지는 기본적으로 비활성화됩니다.

커버리지 보고서에서 제외할 파일의 glob 패턴을 지정합니다.

커버리지 보고서에 포함할 파일의 glob 패턴을 지정합니다.

커버리지 결과에 사용할 리포터를 지정합니다. 각 리포터는 이름을 나타내는 문자열이나 이름과 옵션 객체를 포함하는 튜플일 수 있습니다. 기본 제공 리포터는 'html', 'lcov', 'lcovonly', 'text', 'text-summary', 'cobertura', 'json', 'json-summary'입니다.

테스트의 디버깅 모드를 활성화하여 Node Inspector를 사용할 수 있도록 합니다.

테스트에서 제외할 파일의 glob 패턴을 프로젝트 소스 루트 기준으로 지정합니다.

테스트 모음과 테스트 이름에 적용할 정규식 패턴을 지정합니다. 이름이 패턴과 일치하는 테스트만 실행합니다. 예를 들어 ^App은 이름이 'App'으로 시작하는 테스트 모음의 테스트만 실행합니다.

설정한 모든 브라우저를 헤드리스 모드로 실행하도록 강제합니다. Vitest 실행기를 사용할 때 설정한 브라우저가 없으면 이 옵션은 무시됩니다. Karma 실행기는 이 옵션을 지원하지 않습니다.

이 명령의 도움말을 콘솔에 표시합니다.

테스트에 포함할 파일의 glob 패턴을 프로젝트 소스 루트 기준으로 지정합니다. 디렉터리 경로는 내부의 모든 테스트 파일을 포함하고, 파일 경로는 대응하는 테스트 파일이 있으면 포함하도록 특별히 처리합니다.

테스트 실행 격리를 활성화합니다. true이면 Vitest가 테스트를 별도 스레드나 프로세스에서 실행합니다. Vitest 실행기에서만 사용할 수 있습니다. Karma/Jasmine과 같은 사용 경험을 제공하기 위해 기본값은 false입니다.

발견한 모든 테스트 파일을 나열하고 테스트를 빌드하거나 실행하지 않은 채 프로세스를 종료합니다.

테스트 보고서 파일 경로를 지정합니다. 파일에 쓰도록 설정한 모든 리포터가 이 경로를 사용합니다. 리포터마다 별도 파일을 쓰려면 reporters 옵션 안에서 ['reporter-name', { outputFile: '...' }] 튜플 형식을 사용하세요. 지정하지 않으면 콘솔에 출력합니다.

콘솔에 빌드 진행 정보를 표시합니다. 기본값은 지정한 buildTarget의 progress 설정입니다.

테스트 환경의 Angular 제공자 배열을 제공하는 TypeScript 파일 경로를 지정합니다. 이 파일은 제공자 배열을 기본 내보내기로 내보내야 합니다.

재빌드할 때마다 출력하는 상세 빌드 요약과 통계 표를 숨깁니다. 기본값은 로컬에서 true, CI 환경에서 false입니다.

테스트 실행에 사용할 리포터를 지정합니다. 각 리포터는 이름을 나타내는 문자열이나 이름과 옵션 객체를 포함하는 튜플일 수 있습니다. 기본 제공 리포터는 'default', 'verbose', 'dots', 'json', 'junit', 'tap', 'tap-flat', 'html'입니다. 사용자 지정 리포터의 경로를 지정할 수도 있습니다.

테스트 실행에 사용할 테스트 실행기를 지정합니다.

선택한 테스트 실행기의 설정 파일을 지정합니다. 문자열이면 설정 파일 경로로 사용합니다. true이면 빌더가 기본 설정 파일(예: vitest-base.config.mts, karma.conf.js)을 찾습니다. false이면 외부 설정 파일을 사용하지 않습니다. Vitest에서는 이를 통해 고급 옵션과 사용자 지정 플러그인을 사용할 수 있습니다. 파일은 로드되지만 Angular 팀은 파일의 구체적인 내용이나 파일에서 사용하는 서드 파티 플러그인을 직접 지원하지 않습니다.

테스트 파일보다 먼저 실행할 전역 설정 파일의 경로 목록입니다. 애플리케이션의 폴리필과 Angular TestBed는 항상 이 파일들보다 먼저 초기화됩니다.

테스트 실행에 코드 분할을 활성화합니다. 활성화하면 테스트 파일 사이에서 공유하는 코드를 별도 청크로 분리합니다. Node.js 환경의 라이브 ESM 바인딩 문제(예: 초기화되지 않은 내보내기나 모킹 실패)는 분할을 비활성화하여 해결할 수 있습니다. Vitest 실행기에서만 사용할 수 있습니다.

TypeScript 설정 파일의 경로이며 작업 공간 루트 기준 상대 경로입니다. 프로젝트 루트에 tsconfig.spec.json이 있으면 기본값으로 사용합니다. 경로를 지정하지 않았고 기본 파일도 없으면 지정한 buildTarget의 tsConfig를 사용합니다.

대화형 테스트 실행을 위한 Vitest UI를 활성화합니다. Vitest 실행기에서만 사용할 수 있습니다.

소스 파일이 변경되면 테스트를 다시 실행하는 파일 감시 모드를 활성화합니다. 기본값은 TTY 환경에서 true, 그 외에는 false입니다.