Eximjs

Abstract
The eximjs command line utility is used to convert ECMAScript module syntax to CommonJS module syntax.

Motivation

In 2015, the ECMAScript TC39 standards committee finalized the syntax for exporting and importing modules. Implementing the full standard has been problematic, and there has been considerable delay. In the interim, developers wishing to write forward-compatible code can use the new ES Module syntax and transpile it back to the old CommonJS syntax. The eximjs command line utility can be used to do that.

Prerequisites and installation

The eximjs utility uses Node.js. Package installation is done via NPM. These are the only two prerequisites.

To install the utility and make it available to your Bash shell, use this command.

[user@host]# npm install -g eximjs
						

Usage

The software is invoked from the command line with:

[user@host]# eximjs [source file] [destination file] 
						

The following conversions are performed:

ECMAScript Modules	CommonJS Modules
import NAME from './path/to/file'	var NAME = require('./path/to/file')
import {NAME} from './path/to/file'	var NAME = require('./path/to/file').NAME
import NAME from 'nodemodule'	var NAME = require('nodemodule')
import {NAME} from 'nodemodule'	var NAME = require('nodemodule').NAME
export default	module.exports =
export class NAME {	module.exports.NAME = class NAME {
export function NAME () {	module.exports.NAME = function NAME () {

Note that absolute paths, those beginning with /, are not allowed.

Also, as of Dec 2019, the Node.js platform allows the filename extension to be omitted, but the Chrome browser module system does not.

For the most efficient use of resources, this utility should be invoked by a build tool that is sensitive to file modification timestamps, so that it is triggered for each file in a nested hierarchy only when a source file is changed. (The Read Write Tools prorenata builder has this capability.)

License

The eximjs command line utility is licensed under the MIT License.

MIT License

Copyright © 2023 Read Write Tools.

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Availability

Source code	github
Package installation	NPM
Documentation	Read Write Hub