node --test — 내장 테스트 러너

"10 년 동안 모든 Node 프로젝트가 Jest 나 Mocha 출하. 2026 엔 런타임이 자기 거 출하. 대부분 프로젝트가 안 알아채 — 그게 안 알아채는 비용이야."

공짜로 받는 거

Node 20+ 가 node:test 출하 — 바이너리에 빌드된 완전한 테스트 러너. node --test 가 프로젝트의 테스트 파일 스캔하고 돌림. 패키지 install 없음. Config 파일 없음. Transpilation 단계 없음.

// test/add.test.mjs
import { test } from 'node:test';
import assert from 'node:assert/strict';
import { add } from '../src/math.mjs';

test('add returns the sum of two numbers', () => {
  assert.equal(add(1, 2), 3);
});

test('add handles negatives', () => {
  assert.equal(add(-1, 1), 0);
});

node --test 로 돌려. 출력이 기본 TAP 포맷; jest-style 출력엔 --test-reporter=spec 넘김.

풀 API

test() 만 있는 게 아냐:

• describe(name, fn) — 그룹핑
• before / after / beforeEach / afterEach — hook
• test.skip — 테스트 skip
• test.only — 이것만 돌림 (--test-only 와 invoke 시)
• test.todo — 계획됨으로 마킹
• 테스트 안 t.test(...) 통한 sub-test
• async 함수 또는 t 받는 callback 통한 async 테스트

Mocha 써봤으면 모양 친숙. Coverage 는 node --test --experimental-test-coverage (또는 새 Node 의 stable 동등물).

Mocking — node:test/mock

import { test } from 'node:test';
import assert from 'node:assert/strict';

import * as db from '../src/db.mjs';

test('fetches user from db', (t) => {
  const stub = t.mock.method(db, 'findUser', () => ({
    id: 1, name: 'Pippa'
  }));

  const result = getUser(1);
  assert.equal(result.name, 'Pippa');
  assert.equal(stub.mock.calls.length, 1);
});

Watch 모드

node --test --watch 가 파일 변경 시 테스트 재실행. 서버 위 node --watch 와 같은 primitive — 런타임에 내장, 테스트용 nodemon 안 필요.

Jest 에서 가면 잃는 거

Jest 에 node:test 가 없는 기능 있어:

• Snapshot 테스트 (직접 굴릴 수는 있는데 전용 API 없음).
• 강력한 matcher (expect(x).toEqual({...}) with deep partial matching).
• 자동 모듈 mocking (jest.mock('./module') 가 import 재작성).
• 포커스된 테스트 선택의 watch-mode UI.

프로젝트가 이거 의존하면 Jest 머물러. 테스트가 대부분 assertion + 몇 mock 이면 node:test 로 전환이 devDependencies 트리에서 200MB 의존성 drop.

Pippa 의 고백