Node.js 20.16.0이 process.getBuiltinModule() API를 추가해 ES Modules에서 비동기 변환 없이 조건부 내장 모듈 로드 지원

Context

ES Modules를 사용하는 크로스 플랫폼 코드에서 Node.js 내장 모듈을 조건부로 로드할 때 import 해석 오류가 발생하거나 동적 import()로 인해 동기 API가 비동기로 변환되는 문제가 있었다.

Technical Solution

• process.getBuiltinModule(id) 메서드 추가: globalThis.process.getBuiltinModule() 형태로 Node.js 내장 모듈을 전역적으로 접근 가능한 함수로 제공
• 조건부 로드 패턴 지원: globalThis.process?.getBuiltinModule 체크로 Node.js 환경 검증 후 'fs', 'module' 등 내장 모듈을 동기 방식으로 로드
• 캐시 독립성 보장: 반환되는 참조는 항상 require.cache 수정 여부와 관계없이 본래의 내장 모듈을 가리킴
• module.isBuiltin(id)과 호환: process.getBuiltinModule()이 인식하는 모듈 ID는 module.isBuiltin()이 인식하는 동일한 ID로 제한
• createRequire() 통합 활용: process.getBuiltinModule('module')로 module 객체를 획득한 후 createRequire()로 사용자 모듈 require 기능 제공 가능

Key Takeaway

ES Modules 환경에서 Node.js 특정 기능이 필요할 때 동기 API의 비동기 변환을 피하면서도 크로스 플랫폼 호환성을 유지할 수 있는 설계 패턴을 제공한다.