기본 패턴
javascript
import test from "node:test";
import assert from "node:assert/strict";
test("sum returns total", () => {
const sum = (a, b) => a + b;
assert.equal(sum(2, 3), 5);
});설명
node:test는 별도 라이브러리 없이 Node.js 자체만으로 테스트를 실행할 수 있게 해 주는 내장 테스트 러너입니다.- 작은 유틸 함수, CLI 옵션 처리, 파일 변환 로직처럼 프레임워크 없이도 검증 가능한 코드를 빠르게 묶기에 좋습니다.
- 보통 검증은
node:assert/strict와 함께 사용하며, 예외가 나면 실패, 예외가 없으면 성공이라는 흐름으로 읽으면 됩니다. - 테스트 러너가 내장되어 있다는 뜻은 "프로젝트 초기 검증 습관"을 훨씬 낮은 비용으로 시작할 수 있다는 의미이기도 합니다.
- Jest나 Vitest처럼 스냅샷, 광범위한 mocking 생태계가 바로 들어있는 것은 아니므로, 프로젝트 규모가 커지면 별도 도구와 비교해 선택하면 됩니다.
짧은 예제
bash
node --test
node --test src/**/*.test.js빠른 정리
| 항목 | 설명 |
|---|---|
node:test | 테스트 정의와 실행 |
node:assert/strict | 기본 단언 도구 |
node --test | 테스트 실행 CLI |
| 서드파티 러너 | 대규모 프로젝트 기능 확장 |
주의할 점
테스트 도구를 고를 때 기능 수만 보지 말고, 지금 필요한 검증 범위를 먼저 보는 편이 좋습니다. 작은 Node.js 프로젝트라면 내장 테스트 러너만으로도 충분히 좋은 출발점이 될 수 있습니다.
참고 링크
2 sources