https://github.com/azu/commonjs-to-es-module-codemod

Codemod that convert CommonJS(require/exports) to ES Modules(import/export) for JavaScript/TypeScript
https://github.com/azu/commonjs-to-es-module-codemod

codemod commonjs esm esmodules migration tools

Last synced: 6 days ago
JSON representation

Codemod that convert CommonJS(require/exports) to ES Modules(import/export) for JavaScript/TypeScript

• Host: GitHub
• URL: https://github.com/azu/commonjs-to-es-module-codemod
• Owner: azu
• License: mit
• Created: 2020-08-22T13:03:26.000Z (about 4 years ago)
• Default Branch: master
• Last Pushed: 2023-05-10T21:33:54.000Z (over 1 year ago)
• Last Synced: 2024-10-23T11:42:29.067Z (28 days ago)
• Topics: codemod, commonjs, esm, esmodules, migration, tools
• Language: JavaScript
• Homepage:
• Size: 260 KB
• Stars: 80
• Watchers: 3
• Forks: 15
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# commonjs-to-es-module-codemod [![Actions Status: test](https://github.com/azu/commonjs-to-es-module-codemod/workflows/test/badge.svg)](https://github.com/azu/commonjs-to-es-module-codemod/actions?query=workflow%3A"test")

jscodeshift codemod that convert CommonJS(require/exports) to ES Modules(import/export) for JavaScript/TypeScript

## Support Patterns

### Exports

- [x] named export: `module.exports.foo = foo` & `exports.foo = foo` to `export { foo }`

- [x] named export: `module.exports.bar = foo` & `exports.bar = foo` to `export { foo as bar }`

- [x] default export: `module.exports = foo` to `export default foo`

- [x] ignore multiple `module.exports = x`

### Imports

- [x] `require("mod")` to `import "mod"`

- [x] `const foo = require("mod")` to `import foo from "mod"`

- [x] `const { foo } = require("mod")` to `import { foo } from "mod"`

- [x] `const foo = require("mod").foo` to `import { foo } from "mod"`

- [x] `const bar = require("mod").foo` to `import { foo as bar } from "mod"`

- [ ] `const o = { foo: require("foo") } ` to `import foo from "mod"; const o = { foo }`

## Usage

`commonjs-to-es-module-codemod` is published on [npm](https://www.npmjs.com/package/commonjs-to-es-module-codemod).

You can convert `index.js` and `index.ts` to ES Modules using [jscodeshift](https://github.com/facebook/jscodeshift) and [unpkg](https://unpkg.com/).

    # Install jscodeshift

    npm install --global jscodeshift

    # Transform using latest version

    LATEST_VERSION=$(npm view commonjs-to-es-module-codemod version)

    jscodeshift -t "https://unpkg.com/commonjs-to-es-module-codemod@${LATEST_VERSION}/dist/index.js" "index.js"

    # Transform TypeScript

    jscodeshift -t "https://unpkg.com/commonjs-to-es-module-codemod@${LATEST_VERSION}/dist/index.js" --extensions ts "index.ts"

Convert `src/*.js`:

    LATEST_VERSION=$(npm view commonjs-to-es-module-codemod version)

    find src -name "*.js" | xargs jscodeshift -t "https://unpkg.com/commonjs-to-es-module-codemod@${LATEST_VERSION}/dist/index.js"

## Related

- [azu/eslint-cjs-to-esm: ESLint wrapper for migration from CJS to ESM.](https://github.com/azu/eslint-cjs-to-esm)

## Tests

    yarn test

## Contributing

1. Fork it!

2. Create your feature branch: `git checkout -b my-new-feature`

3. Commit your changes: `git commit -am 'Add some feature'`

4. Push to the branch: `git push origin my-new-feature`

5. Submit a pull request :D

## License

MIT © azu

It includes [BuonOmo/CommonJS-to-ES6-codemod](https://github.com/BuonOmo/CommonJS-to-ES6-codemod).

MIT © Ulysse Buonomo 

## Related

- [lebab/lebab: Turn your ES5 code into readable ES6. Lebab does the opposite of what Babel does.](https://github.com/lebab/lebab)