Node.js main, 목 함수 호출을 확인하는 테스트 API 4개 추가

이번 소식

Node.js의 개발 브랜치 main에 목(mock) 함수 호출을 확인하는 API 네 가지가 추가됐습니다. 목 함수는 테스트에서 실제 동작을 대신하며 호출 기록을 남기는 함수입니다. 이번 변경은 정식 배포 전이며, 공식 문서의 도입 버전도 아직 정해지지 않았습니다.

달라진 점

• t.assert.called()는 한 번 이상 호출됐는지, t.assert.callCount()는 지정한 횟수만큼 호출됐는지 확인합니다.
• t.assert.nthCalledWith()는 특정 순서의 호출 인자를, t.assert.lastCalledWith()는 마지막 호출 인자를 검사합니다. 호출 순번은 1부터 시작하며, 인자는 assert.deepStrictEqual()과 같은 깊은 엄격 비교를 사용합니다.
• 네 API의 검사는 다른 t.assert 메서드처럼 t.plan()에 지정한 검증 횟수에 포함됩니다.

어떤 점이 달라지나요?

기존에도 호출 횟수와 기록을 꺼내 같은 검사를 작성할 수 있었습니다. 새 기능은 검사 자체를 새로 가능하게 하기보다 자주 쓰는 검증을 더 짧고 직접적으로 표현하게 합니다. 예를 들어 콜백이 한 번만 실행됐는지, 마지막 호출에 예상한 값이 전달됐는지 확인하는 테스트에 활용할 수 있습니다.

현재 사용하는 배포 버전에서 바로 쓸 수 있다고 가정하지 마세요. 실제 포함 버전이 발표된 뒤 도입 여부를 확인해야 합니다. 이번 조사에서는 Node.js를 빌드하거나 해당 테스트를 직접 실행하지 않았습니다.

공식 출처·반영 시점

main 반영: 2026년 10월 6일 14:55:47 KST. 공식 PR의 병합 시각과 커밋을 확인했습니다. PR 제안일이 아닌 실제 변경 시점 기준입니다.

반영 커밋과 문서 변경