KO
|
EN
gitlite — search
Search
#typescript
#ai-agents
#deepseek-harness
#dsh-plugin
#open-source
#ai
#cli
#dsh
#claude-code
#codex
#developer-tools
#react
swc_mut_cjs_exports
★ 64
Open GitHub ↗
[SWC plugin] mutable CJS exports
Download README (.md)
Explore Similar Repositories
SWCNN
:
A self-supervised CNN for image watermark removal (IEEE Transactions on Circuits and Systems for Video 2024)
next-superjson
:
Automatically transform your Next.js Pages to use SuperJSON, without losing swc support
flexmojos
:
A collection of maven goals to allow maven to compile, optimize, and test Flex SWF, Flex SWC, Air SWF, Air SWC and Air package
swc-plugins
:
SWC plugins and binding
storybook-addon-swc
:
Storybook add-on to enable SWC builds.
// repository documentation
Was this content helpful?
★ 0
(0 ratings)
Select Rating:
★
★
★
★
★
Submit Feedback
Recent Feedback
×
Download README
Do you want to download the
README.md
file for
swc_mut_cjs_exports
?
Download (.md)
# [SWC plugin] mutable CJS exports > [!IMPORTANT] > This plugin has been migrated to the [swc official plugin repository](https://github.com/swc-project/plugins) and is available as [`@swc-contrib/mut-cjs-exports` on npm](https://www.npmjs.com/package/@swc-contrib/mut-cjs-exports). [](https://crates.io/crates/swc_mut_cjs_exports) [](https://www.npmjs.com/package/swc_mut_cjs_exports) [](https://github.com/magic-akari/swc_mut_cjs_exports/actions/workflows/test.yml) [](https://github.com/magic-akari/swc_mut_cjs_exports/actions/workflows/swc-compat-test.yml) [](https://github.com/magic-akari/swc_mut_cjs_exports/actions/workflows/cron-latest.yml) [](https://github.com/magic-akari/swc_mut_cjs_exports/actions/workflows/cron-nightly.yml) This is a SWC plugin to emit mutable CJS exports. This SWC plugin has only been tested for compatibility with jest. It should be used with `@swc/jest`. This project was previously called jest_workaround ## plugin version | swc_mut_cjs_exports | @swc/core version | | ------------------- | ----------------- | | 0.79.69 | >=1.3.78 <1.3.81 | | 0.85.0 | >=1.3.81 <1.3.106 | | 0.86.17 | >=1.3.81 <1.3.106 | | 0.89.2 | >=1.3.106 <1.4.0 | | 0.90.3 | 1.4.0 | | 0.90.6 | >=1.4.0 <1.7.0 | | 0.90.24 | >=1.4.0 <1.7.0 | | 0.99.0 | >=1.7.0 <1.7.28 | | 0.109.1 | >=1.7.28 <1.10.0 | | 8.0.1 | >=1.10.0 <1.13.0 | | 8.0.2 | >=1.10.0 <1.13.0 | | 10.7.0 | >=1.10.0 <1.13.0 | > [!NOTE] > The version of this plugin after 10.7.0 is migrated to the [swc official plugin repository](https://github.com/swc-project/plugins) and is available as [`@swc-contrib/mut-cjs-exports` on npm](https://www.npmjs.com/package/@swc-contrib/mut-cjs-exports). > > Please refer to https://swc.rs/docs/plugin/selecting-swc-core for version compatibility. ## usage install ```bash npm i -D jest @swc/core @swc/jest swc_mut_cjs_exports ``` ```js // jest.config.js const fs = require("node:fs"); const swcrc = JSON.parse(fs.readFileSync(".swcrc", "utf8")); // If you have other plugins, change this line. ((swcrc.jsc ??= {}).experimental ??= {}).plugins = [ ["swc_mut_cjs_exports", {}], ]; module.exports = { transform: { "^.+\\.(t|j)sx?$": ["@swc/jest", swcrc], }, }; ``` Alternative implementation without .swcrc file ```JavaScript // jest.config.js module.exports = { transform: { "^.+\\.(t|j)sx?$": [ "@swc/jest", { jsc: { experimental: { plugins: [["swc_mut_cjs_exports", {}]], }, }, }, ], }, }; ``` Make sure that `module.type` is `commonjs` in your `.swcrc` since this plugin does not touch non-workaround parts, such as import statements. ## FAQ #### 1. When do I need this? If you're using the swc compiler to transform your code to comply with the ESM specification, but you're also using Jest to test it in a CJS environment, you may encounter issues due to the immutable issue of `exports`. This plugin can help by transforming the `export` statements into mutable `exports`. #### 2. Do I have a better choice? You may have other options depending on your specific needs: - If you're able to run Jest in an ESM environment, you can use swc to transpile TypeScript/JSX syntax or downgrade JavaScript syntax without module conversion. Simply set the value of `module.type` to `es6` to achieve this. - It's possible that some issues related to running Jest in an ESM environment will be resolved over time. Keep an eye on [facebook/jest#9430](https://github.com/facebook/jest/issues/9430) for updates. - If you don't need the behavior of ESM specifically, you can stick with the CJS syntax to get the CJS behavior of `exports`. These options may be worth considering before using this plugin. CJS syntax ```JavaScript exports.foo = function foo() { return 42; }; ``` CTS(CJS in TypeScript) syntax ```TypeScript export = { foo: function foo() { return 42; }, }; ``` Notes: - ESM style export means immutable exports when transformed into CJS - ESM style import means hoisted require when transformed into CJS #### 3. After upgrading the plugin version, the changes have not taken effect. This is a known issue. You could remove the Jest cache by running [`jest --clearCache`](https://jestjs.io/docs/cli#--clearcache) as a workaround.
