Description
As Node.js continues to move toward an ESM-first ecosystem, we need a clear, well-documented Node.js ESM story along with practical samples that demonstrate recommended patterns and best practices.
Today, customers and contributors frequently run into confusion around:
- When and how to use ESM vs CommonJS
- Interop between ESM and CJS dependencies
- Bundling with tools like esbuild
- Package configuration (type: module, exports, conditional exports)
- Runtime behavior differences in Node.js
- This issue tracks the work required to define and publish a cohesive ESM narrative and supporting samples.
Goals
- Clearly explain why and when to use ESM in Node.js
- Document the recommended ESM setup for modern Node.js projects
- Provide actionable samples that users can copy and adapt
- Reduce confusion and support burden around ESM adoption
Internal Tracking feature: https://github.com/Azure/azure-functions-bucees-planning/issues/863
Description
As Node.js continues to move toward an ESM-first ecosystem, we need a clear, well-documented Node.js ESM story along with practical samples that demonstrate recommended patterns and best practices.
Today, customers and contributors frequently run into confusion around:
Goals
Internal Tracking feature: https://github.com/Azure/azure-functions-bucees-planning/issues/863