Skip to content
Vitest 3
Main Navigation 가이드 & API구성브라우저 모드고급 API
3.2.0
2.1.9
1.6.1
0.34.6

한국어

English
简体中文
繁體中文
Español
Français
Русский
Português – Brasil
Deutsch
日本語
Italiano
Polski
Türkçe
čeština
magyar

한국어

English
简体中文
繁體中文
Español
Français
Русский
Português – Brasil
Deutsch
日本語
Italiano
Polski
Türkçe
čeština
magyar

외관

Sidebar Navigation

API

Node API

고급 API

Vitest API

TestProject

TestSpecification

Test Task API

TestCase

TestSuite

TestModule

TestCollection

플러그인 API

러너 API

리포터

작업 메타데이터

가이드

테스트 실행

리포터 확장

사용자 지정 풀

Vitest 구성하기

테스트 API 참조

이 페이지에서

TestCollection ​

TestCollection은 스위트 또는 모듈 내의 최상위 스위트 및 테스트의 컬렉션을 나타냅니다. 또한 컬렉션을 순회하는 데 유용한 메서드를 제공합니다.

INFO

대부분의 메서드는 컬렉션의 모든 항목이 필요하지 않을 경우 성능 향상을 위해 배열 대신 이터레이터를 반환합니다. 배열로 작업하는 것을 선호한다면 이터레이터를 펼칠 수 있습니다: [...children.allSuites()].

또한 컬렉션 자체가 이터레이터라는 점에 유의하세요:

ts
for (const child of module.children) {
  console.log(child.type, child.name);
}

size ​

컬렉션에 포함된 최상위 테스트 및 스위트의 개수입니다.

WARNING

이 개수는 중첩된 스위트와 테스트는 포함하지 않고, 최상위 테스트와 스위트만 포함합니다.

at ​

ts
function at(index: number): TestCase | TestSuite | undefined;

특정 인덱스에 위치한 테스트 또는 스위트를 반환합니다. 이 메서드는 음수 인덱스를 허용합니다.

array ​

ts
function array(): (TestCase | TestSuite)[];

동일한 컬렉션을 배열 형태로 반환합니다. TaskCollection 구현에서 지원되지 않는 map 및 filter와 같은 Array 메서드를 사용하고자 할 때 유용합니다.

allSuites ​

ts
function allSuites(): Generator<TestSuite, undefined, void>;

이 컬렉션과 그 하위 항목에 포함된 모든 스위트를 필터링하여 반환합니다.

ts
for (const suite of module.children.allSuites()) {
  if (suite.errors().length) {
    console.log('failed to collect', suite.errors());
  }
}

allTests ​

ts
function allTests(state?: TestState): Generator<TestCase, undefined, void>;

이 컬렉션과 그 하위 항목에 포함된 모든 테스트를 필터링하여 반환합니다.

ts
for (const test of module.children.allTests()) {
  if (test.result().state === 'pending') {
    console.log('test', test.fullName, 'did not finish');
  }
}

state 값을 전달하여 상태별로 테스트를 필터링할 수 있습니다.

tests ​

ts
function tests(state?: TestState): Generator<TestCase, undefined, void>;

이 컬렉션에 직접 포함된 테스트만 필터링하여 반환합니다. state 값을 전달하여 상태별로 테스트를 필터링할 수 있습니다.

suites ​

ts
function suites(): Generator<TestSuite, undefined, void>;

이 컬렉션에 직접 포함된 스위트만 필터링하여 반환합니다.

Pager
이전TestModule
다음플러그인 API

MIT 라이선스 하에 배포되었습니다.

Copyright (c) 2021-Present Vitest Team

https://vitest.dev/advanced/api/test-collection

MIT 라이선스 하에 배포되었습니다.

Copyright (c) 2021-Present Vitest Team