内容简介:JavaScript language was initially invented for simple form manipulation, with no built-in features like module or namespace. In years, tons of terms, patterns, libraries, syntax, and tools are invented to modularize JavaScript. This article discusses all m
JavaScript language was initially invented for simple form manipulation, with no built-in features like module or namespace. In years, tons of terms, patterns, libraries, syntax, and tools are invented to modularize JavaScript. This article discusses all mainstream module systems, formats and tools in JavaScript, including:
- IIFE module: JavaScript module pattern
- Revealing module: JavaScript revealing module pattern
- CJS module : CommonJS module, or Node.js module
- AMD module : Asynchronous Module Definition, or RequireJS module
- UMD module : Universal Module Definition, or UmdJS module
- ES module : ECMAScript 2015, or ES6 module
- ES dynamic module : ECMAScript 2020, or ES11 dynamic module
- System module : SystemJS module
- Webpack module : transpile and bundle of CJS, AMD, ES modules
- Babel module : transpile ES module
- TypeScript module and namespace
Hopefully this article can help you understand and use all those patterns and terns in JavaScript/TypeScript/Webpack etc. Please leave a comment if any module was missing in the article.
IIFE module: JavaScript module pattern
In browser, defining a JavaScript variable is defining a global variable, which causes pollution cross all JavaScript files loaded by the current web page:
// Define global variables. let count = 0; const increase = () => ++count; const reset = () => { count = 0; console.log("Count is reset."); }; // Use global variables. increase(); reset();
To avoid the global pollution, a anonymous function can be used to wrap the code:
(() => { let count = 0; // ... });
Apparently, there is no longer any global variable. However, defining a function does not execute the code inside the function.
IIFE: Immediately invoked function expression
To execute the code inside function f, the syntax is function call () as f(). To execute the code inside anonymous function (() => {}), the same function call syntax () can be used as (() => {})():
(() => { let count = 0; // ... })();
This is called an IIFE (Immediately invoked function expression). So a basic module can be defined in this way:
// Define IIFE module. const iifeCounterModule = (() => {</span><span>let </span><span>count = 0; </span><span>return </span><span>{ increase: () => ++count, reset: () => { count = 0; console.log(</span><span>"Count is reset."</span><span>); } };
})();
// Use IIFE module. iifeCounterModule.increase(); iifeCounterModule.reset();
It wraps the module code inside a IIFE. it returns a object, which is the placeholder of exported APIs. Only 1 global variable is introduced, which is the modal name. Later the module name can be used to call the exported module APIs. This is called the module pattern of JavaScript.
Import mixins
When defining a module, some dependencies may be required. With IIFE module pattern, each other modules is a global variable. They can be directly accessed inside the anonymous function, or be passed through the anonymous function’s arguments:
// Define IIFE module with dependencies. const iifeCounterModule = ((dependencyModule1, dependencyModule2) => {</span><span>let </span><span>count = 0; </span><span>return </span><span>{ increase: () => ++count, reset: () => { count = 0; console.log(</span><span>"Count is reset."</span><span>); } };
})(dependencyModule1, dependencyModule2);
The early version of popular libraries, like jQuery, followed this pattern.
Revealing module: JavaScript revealing module pattern
Revealing module pattern is named by Christian Heilmann. This pattern is also an IIFE, but it emphasizes defining all APIs as local variables inside the anonymous function:
// Define revealing module. const revealingCounterModule = (() => {</span><span>let </span><span>count = 0; </span><span>const </span><span>increase = () => ++count; </span><span>const </span><span>reset = () => { count = 0; console.log(</span><span>"Count is reset."</span><span>); }; </span><span>return </span><span>{ increase, reset };
})();
// Use revealing module. revealingCounterModule.increase(); revealingCounterModule.reset();
With this syntax, it becomes easier when the APIs need to call each other.
CJS module: CommonJS module, or Node.js module
CommonJS, initially named ServerJS, is a pattern to define and consume modules. It is implemented by Node,js. By default, each .js file is a CommonJS module. A module variable and an exports variable are provided for a module to expose APIs. And a require function is provided to consume a module. The following code defines the counter module in CommonJS syntax:
// Define CommonJS module: commonJSCounterModule.js. const dependencyModule1 = require("./dependencyModule1"); const dependencyModule2 = require("./dependencyModule2"); let count = 0; const increase = () => ++count; const reset = () => { count = 0; console.log("Count is reset."); };exports.increase = increase; exports.reset = reset;
// Or equivalently: module.exports = { increase, reset };
The following example consumes the counter module:
// Use CommonJS module. const commonJSCounterModule = require("./commonJSCounterModule"); commonJSCounterModule.increase(); commonJSCounterModule.reset(); // Or equivelently: const { increase, reset } = require("./commonJSCounterModule"); increase(); reset();
At runtime, Node.js implements this by wrapping the code inside the file into a function, then pass the exports variable, module variable, and require function through arguments.
// Define CommonJS module: wrapped commonJSCounterModule.js. (function (exports, require, module, __filename, __dirname) { const dependencyModule1 = require("./dependencyModule1"); const dependencyModule2 = require("./dependencyModule2");</span><span>let </span><span>count = 0; </span><span>const </span><span>increase = () => ++count; </span><span>const </span><span>reset = () => { count = 0; console.log(</span><span>"Count is reset."</span><span>); }; module.exports = { increase, reset }; </span><span>return </span><span>module.exports;
}).call(thisValue, exports, require, module, filename, dirname);
// Use CommonJS module. (function (exports, require, module, __filename, __dirname) { const commonJSCounterModule = require("./commonJSCounterModule"); commonJSCounterModule.increase(); commonJSCounterModule.reset(); }).call(thisValue, exports, require, module, filename, dirname);
AMD module: Asynchronous Module Definition, or RequireJS module
AMD (Asynchronous Module Definition https://github.com/amdjs/amdjs-api ), is a pattern to define and consume module. It is implemented by RequireJS library ( https://requirejs.org/ ). AMD provides a define function to define module, which accepts the module name, dependency modules’ names, and a factory function:
// Define AMD module. define("amdCounterModule", ["dependencyModule1", "dependencyModule2"], (dependencyModule1, dependencyModule2) => { let count = 0;</span><span>const </span><span>increase = () => ++count; </span><span>const </span><span>reset = () => { count = 0; console.log(</span><span>"Count is reset."</span><span>); }; </span><span>return </span><span>{ increase, reset };
});
It also provides a require function to consume module:
// Use AMD module. require(["amdCounterModule"], amdCounterModule => { amdCounterModule.increase(); amdCounterModule.reset(); });
The AMD require function is totally different from the CommonJS require function. AMD require accept the names of modules to be consumed, and pass the module to a function argument.
Dynamic loading
AMD’s require function has another overload. It accepts a function, and pass a CommonJS-like require function to that function. So AMD modules can be loaded by calling require:
// Use dynamic AMD module. define(require => { const dynamicDependencyModule1 = require("dependencyModule1"); const dynamicDependencyModule2 = require("dependencyModule2");</span><span>let </span><span>count = 0; </span><span>const </span><span>increase = () => ++count; </span><span>const </span><span>reset = () => { count = 0; console.log(</span><span>"Count is reset."</span><span>); }; </span><span>return </span><span>{ increase, reset };
});
AMD module from CommonJS module
The above define function has a overload that can pass the require function as well as exports variable and module variable to a callback, so that CommonJS code can work inside:
// Define AMD module using CommonJS code. define((require, exports, module) => { // CommonJS code. const dependencyModule1 = require("dependencyModule1"); const dependencyModule2 = require("dependencyModule2");</span><span>let </span><span>count = 0; </span><span>const </span><span>increase = () => ++count; </span><span>const </span><span>reset = () => { count = 0; console.log(</span><span>"Count is reset."</span><span>); }; exports.increase = increase; exports.reset = reset;
});
// Consume AMD module using CommonJS code. define(require => { // CommonJS code. const counterModule = require("amdCounterModule"); counterModule.increase(); counterModule.reset(); });
UMD module: Universal Module Definition, or UmdJS module
UMD (Universal Module Definition, https://github.com/umdjs/umd ) is a set of tricky patterns to make your code file work in multiple environments.
UMD for both AMD (RequireJS) and native browser
For example, the following is a kind of UMD pattern to make module definition work with both AMD (RequireJS) and native browser:
// Define UMD module for both AMD and browser. ((root, factory) => { // Detects AMD/RequireJS"s define function. if (typeof define === "function" && define.amd) { // Is AMD/RequireJS. Call factory with AMD/RequireJS"s define function. define("umdCounterModule", ["deependencyModule1", "dependencyModule2"], factory); } else { // Is Browser. Directly call factory. // Imported dependencies are global variables(properties of window object). // Exported module is also a global variable(property of window object) root.umdCounterModule = factory(root.deependencyModule1, root.dependencyModule2); } })(typeof self !== "undefined" ? self : this, (deependencyModule1, dependencyModule2) => { // Module code goes here. let count = 0; const increase = () => ++count; const reset = () => { count = 0; console.log("Count is reset."); };</span><span>return </span><span>{ increase, reset };
});
It is more complex but just a IIFE. The anonymous function detects if AMD’s define function exists, if so, call the module factory with AMD’s define function. If not, it calls the module factory directly. At the moment, the root argument is actually browser’s window object. It gets dependency modules from global variables (properties of window object). When factory returns the module, it assigns the returned module to a global variable too (property of window object).
UMD for both AMD (RequireJS) and CommonJS (Node.js)
The following is another kind of UMD pattern to make module definition work with both AMD (RequireJS) and CommonJS (Node.js):
(define => define((require, exports, module) => { // Module code goes here. const dependencyModule1 = require("dependencyModule1"); const dependencyModule2 = require("dependencyModule2");</span><span>let </span><span>count = 0; </span><span>const </span><span>increase = () => ++count; </span><span>const </span><span>reset = () => { count = 0; console.log(</span><span>"Count is reset."</span><span>); }; module.export = { increase, reset };
}))(
// Detects module variable and exports variable of CommonJS/Node.js. // Also detect the define function of AMD/RequireJS. typeof module === "object" && module.exports && typeof define !== "function" ? // Is CommonJS/Node.js. Manually create a define function. factory => module.exports = factory(require, exports, module) : // Is AMD/RequireJS. Directly use its define function. define);
Again, don’t be scared. It is just an IIFE. When the IIFE is called, its argument is evaluated. The argument evaluation detects the environment (the module variable and exports variable of CommonJS/Node.js, as well as the define function of AMD/RequireJS). If the environment is CommonJS/Node.js, the anonymous function’s argument is a manually created define function. If the environment is AMD/RequireJS, the anonymous function’s argument is just AMD’s define function. So when the anonymous function is executed, it is guaranteed to have a working define function. In side the anonymous function, it simply calls the define function to define the module.
ES module: ECMAScript 2015, or ES6 module
After all the module mess, in 2015, JavaScript’s spec version 6 defined a totally different module system and syntax. This spec is called ECMAScript 2015 or ES2015, AKA ECMAScript 6 or ES6. The main syntax is the import keyword and the export keyword. The following example uses new syntax to demonstrate ES module’s named import/export and default import/export:
// Define ES module: esCounterModule.js or esCounterModule.mjs. import dependencyModule1 from "./dependencyModule1.mjs"; import dependencyModule2 from "./dependencyModule2.mjs"; let count = 0; // Named export: export const increase = () => ++count; export const reset = () => { count = 0; console.log("Count is reset."); }; // Or default export: export default { increase, reset };
To use this module file in browser, add a <script> tag and specify it is a module: <script type="module" src="esCounterModule.js"></script>. To use this module file in Node.js, rename its extension from .js to .mjs.
// Use ES module. // Browser: <script type="module" src="esCounterModule.js"></script> or inline. // Server: esCounterModule.mjs // Import from named export. import { increase, reset } from "./esCounterModule.mjs"; increase(); reset(); // Or import from default export: import esCounterModule from "./esCounterModule.mjs"; esCounterModule.increase(); esCounterModule.reset();
ES dynamic module: ECMAScript 2020, or ES11 dynamic module
In 2020, the latest JavaScript spec version 11 is introducing a built-in function import to consume a ES module dynamically. The import function returns a promise, so its then method can be called to consume the module:
// Use dynamic ES module with promise APIs. import("./esCounterModule.mjs").then(dynamicESCounterModule => { dynamicESCounterModule.increase(); dynamicESCounterModule.reset(); }); // Or equivalently: import("./esCounterModule.mjs").then(({ increase, reset }) => { increase(); reset(); });
By returning promise, apparently import function can also works with the await keyword:
// Use dynamic ES module with await. (async () => {</span><span>const </span><span>dynamicESCounterModule = </span><span>await import</span><span>(</span><span>"./esCounterModule.mjs"</span><span>); dynamicESCounterModule.increase(); dynamicESCounterModule.reset(); </span><span>// Or equivalently: </span><span>const </span><span>{ increase, reset } = </span><span>await import</span><span>(</span><span>"./esCounterModule.mjs"</span><span>); increase(); reset();
})();
The following is the compatibility of import/dynamic import/export, from https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Modules :
System module: SystemJS module
SystemJS is a library that can enable ES6 module syntax for older ES5. For example, the following module is defined in ES6 syntax
// Define ES module. import dependencyModule1 from "./dependencyModule1.js"; import dependencyModule2 from "./dependencyModule2.js"; dependencyModule1.api1(); dependencyModule2.api2(); let count = 0; // Named export: export const increase = function () { return ++count }; export const reset = function () { count = 0; console.log("Count is reset."); }; // Or default export: export default { increase, reset }
If your runtime, like a old browser, does not support ES6 syntax, the above code cannot work. SystemJS can transpile the module definition to a call of library API, System.register:
// Define SystemJS module. System.register(["./dependencyModule1.js", "./dependencyModule2.js"], function (exports_1, context_1) { "use strict"; var dependencyModule1_js_1, dependencyModule2_js_1, count, increase, reset; var __moduleName = context_1 && context_1.id; return { setters: [ function (dependencyModule1_js_1_1) { dependencyModule1_js_1 = dependencyModule1_js_1_1; }, function (dependencyModule2_js_1_1) { dependencyModule2_js_1 = dependencyModule2_js_1_1; } ], execute: function () { dependencyModule1_js_1.default.api1(); dependencyModule2_js_1.default.api2(); count = 0; // Named export: exports_1("increase", increase = function () { return ++count }; exports_1("reset", reset = function () { count = 0; console.log("Count is reset."); };); // Or default export: exports_1("default", { increase, reset }); } }; });
So that the import/export new ES6 syntax is gone.
SystemJS also provides an import function for dynamic import:
// Use SystemJS module with promise APIs. System.import("./esCounterModule.js").then(dynamicESCounterModule => { dynamicESCounterModule.increase(); dynamicESCounterModule.reset(); });
Webpack module: bundle of CJS, AMD, ES modules
Webpack is a bundler for modules. It uses transpile combined CommonJS module, AMD module, and ES module into a harmony module pattern, and bundle all code into one single file. For example, the following 3 files defines 3 modules in 3 different syntax:
// Define AMD module: amdDependencyModule1.js define("amdDependencyModule1", () => { const api1 = () => { }; return { api1 }; }); // Define CommonJS module: commonJSDependencyModule2.js const dependencyModule1 = require("./amdDependencyModule1"); const api2 = () => dependencyModule1.api1(); exports.api2 = api2; // Define ES module: esCounterModule.js. import dependencyModule1 from "./amdDependencyModule1"; import dependencyModule2 from "./commonJSDependencyModule2"; dependencyModule1.api1(); dependencyModule2.api2(); let count = 0; const increase = () => ++count; const reset = () => { count = 0; console.log("Count is reset."); }; export default { increase, reset }
And the following file consumes the counter module:
// Use ES module: index.js import counterModule from "./esCounterModule"; counterModule.increase(); counterModule.reset();
Webpack can bundle all the above file, even they are in 3 different module systems, into a single file mian.js:
- root
- dist
- main.js (Bundle of all files under src)
- src
- amdDependencyModule1.js
- commonJSDependencyModule2.js
- esCounterModule.js
- index.js
- webpack.config.js
Interestingly, Webpack uses CommonJS module syntax for itself. In webpack.config.js:
const path = require('path');module.exports = { entry:
'./src/index.js', mode: "none", // Do not optimize or minimize the code for readability. output: { filename: 'main.js', path: path.resolve(__dirname, 'dist'), }, };
Now run the following command to transpile and bundle all 4 files in different syntax:
npx webpack --config webpack.config.js
The following bundle file (main.js) is reformatted and variables are renamed to improve readability:
(function (modules) { // webpackBootstrap // The module cache var installedModules = {}; // The require function function require(moduleId) { // Check if module is in cache if (installedModules[moduleId]) { return installedModules[moduleId].exports;} </span><span>// Create a new module (and put it into the cache) </span><span>var </span><span>module = installedModules[moduleId] = { i: moduleId, l: </span><span>false</span><span>, exports: {} }; </span><span>// Execute the module function </span><span>modules[moduleId].call(module.exports, module, module.exports, require); </span><span>// Flag the module as loaded </span><span>module.l = </span><span>true</span><span>; </span><span>// Return the exports of the module </span><span>return </span><span>module.exports; } </span><span>// expose the modules object (__webpack_modules__) </span><span>require.m = modules; </span><span>// expose the module cache </span><span>require.c = installedModules; </span><span>// define getter function for harmony exports </span><span>require.d = </span><span>function </span><span>(exports, name, getter) { </span><span>if </span><span>(!require.o(exports, name)) { Object.defineProperty(exports, name, { enumerable: </span><span>true</span><span>, get: getter }); } }; </span><span>// define __esModule on exports </span><span>require.r = </span><span>function </span><span>(exports) { </span><span>if </span><span>(</span><span>typeof </span><span>Symbol !== </span><span>'undefined' </span><span>&& Symbol.toStringTag) { Object.defineProperty(exports, Symbol.toStringTag, { value: </span><span>'Module' </span><span>}); } Object.defineProperty(exports, </span><span>'__esModule'</span><span>, { value: </span><span>true </span><span>}); }; </span><span>// create a fake namespace object // mode & 1: value is a module id, require it // mode & 2: merge all properties of value into the ns // mode & 4: return value when already ns object // mode & 8|1: behave like require </span><span>require.t = </span><span>function </span><span>(value, mode) { </span><span>if </span><span>(mode & 1) value = require(value); </span><span>if </span><span>(mode & 8) </span><span>return </span><span>value; </span><span>if </span><span>((mode & 4) && </span><span>typeof </span><span>value === </span><span>'object' </span><span>&& value && value.__esModule) </span><span>return </span><span>value; </span><span>var </span><span>ns = Object.create(</span><span>null</span><span>); require.r(ns); Object.defineProperty(ns, </span><span>'default'</span><span>, { enumerable: </span><span>true</span><span>, value: value }); </span><span>if </span><span>(mode & 2 && </span><span>typeof </span><span>value != </span><span>'string'</span><span>) </span><span>for </span><span>(</span><span>var </span><span>key </span><span>in </span><span>value) require.d(ns, key, </span><span>function </span><span>(key) { </span><span>return </span><span>value[key]; }.bind(</span><span>null</span><span>, key)); </span><span>return </span><span>ns; }; </span><span>// getDefaultExport function for compatibility with non-harmony modules </span><span>require.n = </span><span>function </span><span>(module) { </span><span>var </span><span>getter = module && module.__esModule ? </span><span>function </span><span>getDefault() { </span><span>return </span><span>module[</span><span>'default'</span><span>]; } : </span><span>function </span><span>getModuleExports() { </span><span>return </span><span>module; }; require.d(getter, </span><span>'a'</span><span>, getter); </span><span>return </span><span>getter; }; </span><span>// Object.prototype.hasOwnProperty.call </span><span>require.o = </span><span>function </span><span>(object, property) { </span><span>return </span><span>Object.prototype.hasOwnProperty.call(object, property); }; </span><span>// __webpack_public_path__ </span><span>require.p = </span><span>""</span><span>; </span><span>// Load entry module and return exports </span><span>return </span><span>require(require.s = 0);
})([
function (module, exports, require) { "use strict"; require.r(exports); // Use ES module: index.js. var esCounterModule = require(1); esCounterModule["default"].increase(); esCounterModule["default"].reset(); }, function (module, exports, require) { "use strict"; require.r(exports); // Define ES module: esCounterModule.js. var amdDependencyModule1 = require.n(require(2)); var commonJSDependencyModule2 = require.n(require(3)); amdDependencyModule1.a.api1(); commonJSDependencyModule2.a.api2();</span><span>let </span><span>count = 0; </span><span>const </span><span>increase = () => ++count; </span><span>const </span><span>reset = () => { count = 0; console.log(</span><span>"Count is reset."</span><span>); }; exports[</span><span>"default"</span><span>] = { increase, reset }; }, </span><span>function </span><span>(module, exports, require) { </span><span>var </span><span>result; !(result = (() => { </span><span>// Define AMD module: amdDependencyModule1.js </span><span>const </span><span>api1 = () => { }; </span><span>return </span><span>{ api1 }; }).call(exports, require, exports, module), result !== undefined && (module.exports = result)); }, </span><span>function </span><span>(module, exports, require) { </span><span>// Define CommonJS module: commonJSDependencyModule2.js </span><span>const </span><span>dependencyModule1 = require(2); </span><span>const </span><span>api2 = () => dependencyModule1.api1(); exports.api2 = api2; }]);
Again, it is just an IIFE. The code of all 4 files are transpiled to the code in 4 functions. And these 4 functions are passed to anonymous function as arguments.
Babel module: transpile ES module
Babel is another transpiler to convert ES6+ JavaScript code to older syntax for older environment like older browsers. The above counter module in ES6 import/export syntax can be converted to the following babel module with new syntax replaced:
// Babel. Object.defineProperty(exports, "__esModule", { value: true }); exports["default"] = void 0; function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; } // Define ES module: esCounterModule.js. var dependencyModule1 = _interopRequireDefault(require("./amdDependencyModule1")); var dependencyModule2 = _interopRequireDefault(require("./commonJSDependencyModule2")); dependencyModule1["default"].api1(); dependencyModule2["default"].api2(); var count = 0; var increase = function () { return ++count; }; var reset = function () { count = 0; console.log("Count is reset."); };exports[
"default"] = { increase: increase, reset: reset };
And here is the code in index.js which consumes the counter module:
// Babel. function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; } // Use ES module: index.js var esCounterModule = _interopRequireDefault(require("./esCounterModule.js")); esCounterModule["default"].increase(); esCounterModule["default"].reset();
This is the default transpilation. Bbel can also work with other tools.
Babel with SystemJS
SystemJS can be used as a plugin for Babel:
npm install --save-dev @babel/plugin-transform-modules-systemjs
And it should be added to the Babel configuration:
{ "plugins": ["@babel/plugin-transform-modules-systemjs"], "presets": [ [ "@babel/env", { "targets": { "ie": "11" } } ] ] }
Now the Babel can work with SystemJS to transpile the
npx babel src --out-dir lib
The result is:
- root
- lib
- amdDependencyModule1.js (Transpiled with SystemJS)
- commonJSDependencyModule2.js (Transpiled with SystemJS)
- esCounterModule.js (Transpiled with SystemJS)
- index.js (Transpiled with SystemJS)
- src
- amdDependencyModule1.js
- commonJSDependencyModule2.js
- esCounterModule.js
- index.js
- babel.config.json
Now all the ADM, CommonJS, and ES module syntax are transpiled to SystemJS syntax:
// Babel with SystemJS: lib/amdDependencyModule1.js. System.register([], function (_export, _context) { "use strict"; return { setters: [], execute: function () { // Define AMD module: src/amdDependencyModule1.js define("amdDependencyModule1", () => { const api1 = () => { };</span><span>return </span><span>{ api1 }; }); } };
});
// Babel with SystemJS: lib/commonJSDependencyModule2.js. System.register([], function (_export, _context) { "use strict"; var dependencyModule1, api2; return { setters: [], execute: function () { // Define CommonJS module: src/commonJSDependencyModule2.js dependencyModule1 = require("./amdDependencyModule1");api2 = () => dependencyModule1.api1(); exports.api2 = api2; } };});
// Babel with SystemJS: lib/esCounterModule.js. System.register(["./amdDependencyModule1", "./commonJSDependencyModule2"], function (_export, _context) { "use strict"; var dependencyModule1, dependencyModule2, count, increase, reset; return { setters: [function (_amdDependencyModule) { dependencyModule1 = _amdDependencyModule.default; }, function (_commonJSDependencyModule) { dependencyModule2 = _commonJSDependencyModule.default; }], execute: function () { // Define ES module: src/esCounterModule.js. dependencyModule1.api1(); dependencyModule2.api2(); count = 0;increase = () => ++count; reset = () => { count = 0; console.log(</span><span>"Count is reset."</span><span>); }; _export(</span><span>"default"</span><span>, { increase, reset }); } };});
// Babel with SystemJS: lib/index.js. System.register(["./esCounterModule"], function (_export, _context) { "use strict"; var esCounterModule; return { setters: [function (_esCounterModuleJs) { esCounterModule = _esCounterModuleJs.default; }], execute: function () { // Use ES module: src/index.js esCounterModule.increase(); esCounterModule.reset(); } }; });
TypeScript module and namespace
TypeScript supports ES module syntax ( https://www.typescriptlang.org/docs/handbook/modules.html ), which can be kept as ES6, or transpiled to other formats, including CommonJS/Node.js, AMD/RequireJS, UMD/UmdJS, or System/SystemJS, acording to the specified transpiler option in tsconfig.json:
{ "compilerOptions": { "module": "ES2020", // None, CommonJS, AMD, System, UMD, ES6, ES2015, ES2020, ESNext. } }
For example:
// TypeScript and ES module. import dependencyModule from "./dependencyModule"; dependencyModule.api(); let count = 0; export const increase = function () { return ++count }; // Transpile to CommonJS/Node.js module: var __importDefault = (this && this.__importDefault) || function (mod) { return (mod && mod.__esModule) ? mod : { "default": mod }; }; exports.__esModule = true; var dependencyModule_1 = __importDefault(require("./dependencyModule")); dependencyModule_1["default"].api(); var count = 0; exports.increase = function () { return ++count; }; // Transpile to AMD/RequireJS module: var __importDefault = (this && this.__importDefault) || function (mod) { return (mod && mod.__esModule) ? mod : { "default": mod }; }; define(["require", "exports", "./dependencyModule"], function (require, exports, dependencyModule_1) { "use strict"; exports.__esModule = true;dependencyModule_1 = __importDefault(dependencyModule_1); dependencyModule_1[</span><span>"default"</span><span>].api(); </span><span>var </span><span>count = 0; exports.increase = </span><span>function </span><span>() { </span><span>return </span><span>++count; };
});
// Transpile to UMD/UmdJS module: var __importDefault = (this && this.__importDefault) || function (mod) { return (mod && mod.__esModule) ? mod : { "default": mod }; }; (function (factory) { if (typeof module === "object" && typeof module.exports === "object") { var v = factory(require, exports); if (v !== undefined) module.exports = v; } else if (typeof define === "function" && define.amd) { define(["require", "exports", "./dependencyModule"], factory); } })(function (require, exports) { "use strict"; exports.__esModule = true;</span><span>var </span><span>dependencyModule_1 = __importDefault(require(</span><span>"./dependencyModule"</span><span>)); dependencyModule_1[</span><span>"default"</span><span>].api(); </span><span>var </span><span>count = 0; exports.increase = </span><span>function </span><span>() { </span><span>return </span><span>++count; };});
// Transpile to System/SystemJS module: System.register(["./dependencyModule"], function (exports_1, context_1) { "use strict"; var dependencyModule_1, count, increase; var __moduleName = context_1 && context_1.id; return { setters: [ function (dependencyModule_1_1) { dependencyModule_1 = dependencyModule_1_1; } ], execute: function () { dependencyModule_1["default"].api(); count = 0; exports_1("increase", increase = function () { return ++count; }); } }; });
This was called external modules in TypeScript. TypeScript also has a module keyword and a namespace keyword ( https://www.typescriptlang.org/docs/handbook/namespaces-and-modules.html#pitfalls-of-namespaces-and-modules ). They were called internal modules:
module Counter { let count = 0; export const increase = () => ++count; export const reset = () => { count = 0; console.log("Count is reset."); }; } namespace Counter { let count = 0; export const increase = () => ++count; export const reset = () => { count = 0; console.log("Count is reset."); }; }
They are both transpiled to JavaScript objects:
var Counter; (function (Counter) { var count = 0; Counter.increase = function () { return ++count; }; Counter.reset = function () { count = 0; console.log("Count is reset."); }; })(Counter || (Counter = {}));
TypeScript module and namespace can have multiple levels by supporting “.” separator:
module Counter.Sub { let count = 0; export const increase = () => ++count; } namespace Counter.Sub { let count = 0; export const increase = () => ++count; }
They were transpiled to object’s properties:
var Counter; (function (Counter) { var Sub; (function (Sub) { var count = 0; Sub.increase = function () { return ++count; }; })(Sub = Counter.Sub || (Counter.Sub = {})); })(Counter|| (Counter = {}));
TypeScript module and namespace can also be used in export statement:
module Counter { let count = 0; export module Sub { export const increase = () => ++count; } } module Counter { let count = 0; export namespace Sub { export const increase = () => ++count; } }
The transpilation is the same as sub module and sub namespace:
var Counter; (function (Counter) { var count = 0; var Sub; (function (Sub) { Sub.increase = function () { return ++count; }; })(Sub = Counter.Sub || (Counter.Sub = {})); })(Counter || (Counter = {}));
Conclusion
Welcome to JavaScript, which has so much drama - 10+ systems/formats just for modularization/namespace:
- IIFE module: JavaScript module pattern
- Revealing module: JavaScript revealing module pattern
- CJS module : CommonJS module, or Node.js module
- AMD module : Asynchronous Module Definition, or RequireJS module
- UMD module : Universal Module Definition, or UmdJS module
- ES module : ECMAScript 2015, or ES6 module
- ES dynamic module : ECMAScript 2020, or ES11 dynamic module
- System module : SystemJS module
- Webpack module : transpile and bundle of CJS, AMD, ES modules
- Babel module : transpile ES module
- TypeScript module and namespace
Fortunately, now JavaScript has standard built-in language features for module, and it is supported by Node.js and all latest modern browsers. For older environments, you can still code with the new ES module syntax, then use Webpack/Babel/SystemJS/TypeScript to transpile to older or compatible syntax.
以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持 码农网
猜你喜欢:本站部分资源来源于网络,本站转载出于传递更多信息之目的,版权归原作者或者来源机构所有,如转载稿涉及版权问题,请联系我们。