Node.js 20.6.0이 .env 파일 지원과 import.meta.resolve() 추가로 환경 설정 및 모듈 로드 방식 간소화

Context

Node.js 애플리케이션의 환경 변수 설정이 package.json이나 CLI 플래그에 분산되어 관리 복잡성이 높았다. 모듈 커스터마이제이션 훅의 스레드 간 통신 메커니즘이 부족하여 --experimental-loader 플래그에 의존해야 했다. ES 모듈과 CommonJS 소스 모두를 처리하는 통합 로드 훅이 없어 패키지 작성자가 deprecated API인 require.extensions에 의존해야 했다.

Technical Solution

• .env 파일을 INI 형식으로 지원: node --env-file=config.env index.js 명령으로 환경 변수와 NODE_OPTIONS를 일괄 로드
• import.meta.resolve(specifier) 추가: CommonJS의 require.resolve()와 동일한 기능을 ES 모듈에서 사용 가능하게 구현
• node:module의 register() API 도입: --import와 함께 사용하여 메인 스레드에서 훅 스레드로 데이터 및 MessageChannel 인스턴스 전달 가능
• 모듈 로드 훅의 이중 소스 지원: 애플리케이션 진입점이 ES 모듈이거나 --import 플래그 사용 시 로드 훅이 ES 모듈과 CommonJS 모두 처리 가능
• V8 CppHeap 자동 바인딩: Node.js 시작 시 v8::CppHeap을 V8 isolate에 자동 연결하고 <cppgc/*> 헤더를 addon 헤더에 포함
• node::SetCppgcReference() 헬퍼 함수 추가: JavaScript-to-C++ 참조를 생성할 때 V8 가비지 컬렉터의 인식 가능 하도록 지원

Key Takeaway

Node.js는 진입점(entry point) 전에 커스터마이제이션 훅이 등록되도록 --import와 register() 조합을 권장하고 있으며, addon 작성자는 node::ObjectWrap 대신 cppgc 기반 객체 관리로 마이그레이션할 수 있는 대안을 제공받게 되었다.