피드로 돌아가기
Node.js 25.9.0 (Current)
Node.js BlogNode.js Blog
Frontend

MockModuleOptions API 통합으로 Node.js 테스트 러너 모킹 단순화함

Node.js 25.9.0 (Current)

2026년 4월 1일9intermediate

Context

기존 MockModuleOptions.defaultExport와 namedExports 옵션이 개별적으로 존재하여 사용자 혼란을 유발함. 다른 테스트 러너와의 일관성 문제도 존재함.

Technical Solution

  • MockModuleOptions.defaultExport와 namedExports를 MockModuleOptions.exports 단일 옵션으로 통합함
  • MockModuleOptions.exports.default 속성으로 기본 내보내기를 표현함
  • MockModuleOptions.exports의 자체 열거 가능한 속성으로 명명된 내보내기를 처리함
  • Automated migration 도구 제공: npx codemod @nodejs/mock-module-exports

Impact

사용자 기대와 다른 테스트 러너의 동작 방식에 맞추어 일관된 API를 제공함.

Key Takeaway

Library API 설계 시 옵션 통합을 통해 개발자 경험을 개선할 수 있음.


Node.js 25.9.0 이상으로 마이그레이션 시 테스트 파일에서 MockModuleOptions API를 사용하면 npx codemod @nodejs/mock-module-exports 명령어를 실행하여 코드를 자동 마이그레이션하는 것을 권장함.

원문 읽기