Node.js프로세스와 CLI

node:test 기본

내장 테스트 러너 `node:test`로 작은 단위 테스트를 구성하는 기본 흐름을 정리합니다.

마지막 수정 2026년 3월 21일

기본 패턴

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