Skip to content

Commit 9fe1075

Browse files
authored
Update isomorphism-support.md
1 parent 166e5f8 commit 9fe1075

1 file changed

Lines changed: 8 additions & 1 deletion

File tree

docs/adr/isomorphism-support.md

Lines changed: 8 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -37,7 +37,13 @@ Ambiguity and uncertainty for the community, alongside clear guidance for reposi
3737

3838
## Decision
3939

40-
During [working session](https://github.com/expressjs/discussions/issues/320) we have decided to not revisit, investigate or discuss this topic further. That means ESM exports won't be available for expressjs as well for pillarjs and jshttp packages.
40+
During the [working session](https://github.com/expressjs/discussions/issues/320), we had an in-depth discussion about this topic. After careful consideration, we concluded that we will not make a dedicated effort to export our libraries in the ESM format. Instead, we will continue exporting the libraries as we have done historically.
41+
42+
This decision is motivated by the lack of resources to maintain such an effort in the long term. It is also worth noting that Express is specifically designed to run with Node.js. While some of our libraries can be considered "isomorphic," this was unintended and can currently be classified as an "unofficial but functional feature." Consequently, our CI systems do not include browsers or other runtimes as part of their testing workflows.
43+
44+
At present, our libraries function seamlessly in Node.js, supporting both CommonJS and ESM. Transitioning to support additional scenarios, such as direct ESM exports, would require significant changes to our CI systems and additional maintenance overhead.
45+
46+
**TL;DR**: Dedicated ESM exports will not be available for Express.js, PillarJS, or JSHTTP packages. PR with such a change will not be accepted.
4147

4248
**What will be done?**
4349

@@ -75,3 +81,4 @@ Support for ESM modules imports in commonjs is available since node v20 behind t
7581
Track changes or updates to this ADR over time. Include the date, author, and a brief description of each change.
7682

7783
- **[2025-01-15]**: [@kjugi] - document init
84+
- **[2025-01-18]**: [@kjugi] - applied code review suggestions

0 commit comments

Comments
 (0)