快捷導(dǎo)航

如何讓node運(yùn)行es6模塊文件及其原理詳解

更新時(shí)間：2018年12月11日 09:15:01 作者：senntyou

這篇文章主要介紹了如何讓node運(yùn)行es6模塊文件及其原理詳解，詳細(xì)的介紹了2種方式，小編覺(jué)得挺不錯(cuò)的，現(xiàn)在分享給大家，也給大家做個(gè)參考。一起跟隨小編過(guò)來(lái)看看吧

最新版的 node 支持最新版 ECMAScript 幾乎所有特性，但有一個(gè)特性卻一直到現(xiàn)在都還沒(méi)有支持，那就是從 ES2015 開(kāi)始定義的模塊化機(jī)制。而現(xiàn)在我們很多項(xiàng)目都是用 es6 的模塊化規(guī)范來(lái)寫代碼的，包括 node 項(xiàng)目，所以，node 不能運(yùn)行 es6 模塊文件就會(huì)很不便。

讓 node 運(yùn)行 es6 模塊文件的方式有兩種：

轉(zhuǎn)碼 es6 模塊為 commonjs 模塊
hook node 的 require 機(jī)制，直接讓 node 的 require 加載 import/export

1. 轉(zhuǎn)碼 es6 模塊為 commonjs 模塊

因?yàn)?node 支持幾乎所有除 import/export 外的語(yǔ)法，所以我們只需要將 import/export 轉(zhuǎn)碼成 require/exports，而不需要轉(zhuǎn)碼其他語(yǔ)法。

比如下面的項(xiàng)目：

- package.json
- src/
 - index.js
 - print.js
 - ...

# package.json
{
 "main": "lib/index.js"    # 由工具轉(zhuǎn)碼 src 目錄下源文件到 lib 目錄下
}


# src/index.js
import print from './print';

print('index');

export default print;


# src/print.js
export default str => {
 console.log('print: ' + str);
};

因?yàn)?src 目錄下的源文件都是 es6 模塊化規(guī)范的，node 并不能直接運(yùn)行，所以需要轉(zhuǎn)碼成 commonjs 規(guī)范的代碼。

這個(gè)過(guò)程有兩個(gè)方案：

如果不會(huì)單獨(dú)使用 src 目錄下的某個(gè)文件，而僅僅是以 src/index.js 為入口文件使用，可以把 src 目錄下的文件打包成一個(gè)文件到 lib/index.js：這種方式推薦使用工具 rollup
如果需要單獨(dú)使用 src 目錄下的文件，那就需要把 src 目錄下的文件一對(duì)一的轉(zhuǎn)碼到 lib 目錄下：這種方式推薦使用工具 gulp + babel

1.1 用 rollup 把 src 目錄下的文件打包成一個(gè)文件到 lib/index.js

相關(guān)文件：

# rollup.config.js
export default {
 input: 'src/index.js',
 output: {
 file: 'lib/index.js',
 format: 'cjs',
 },
};


# package.json
{
 "scripts": {
 "build": "rollup -c"
 },
 "devDependencies": {
 "rollup": "^0.66.4"
 }
}

運(yùn)行命令：

npm run build

結(jié)果：

# lib/index.js
'use strict';

var print = str => {
 console.log('print: ' + str);
};

print('index');

module.exports = print;

1.2 用 gulp + babel 把 src 目錄下的文件一對(duì)一的轉(zhuǎn)碼到 lib 目錄下

相關(guān)文件：

# build.js
const gulp = require('gulp');
const babel = require('gulp-babel');

gulp.task('babel', () =>
 gulp.src('src/**/*.js')
 .pipe(babel({
  plugins: ['@babel/plugin-transform-modules-commonjs']
 }))
 .pipe(gulp.dest('lib'))
);

gulp.series('babel')();


# package.json
{
 "scripts": {
 "build": "node build.js"
 },
 "devDependencies": {
 "@babel/core": "^7.1.2",
 "@babel/plugin-transform-modules-commonjs": "^7.2.0",
 "gulp": "^4.0.0",
 "gulp-babel": "^8.0.0"
 }
}

運(yùn)行命令：

npm run build

結(jié)果：

# lib/index.js
"use strict";

Object.defineProperty(exports, "__esModule", {
 value: true
});
exports.default = void 0;

var _print = _interopRequireDefault(require("./print"));

function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }

(0, _print.default)('index');
var _default = _print.default;
exports.default = _default;


# lib/print.js
"use strict";

Object.defineProperty(exports, "__esModule", {
 value: true
});
exports.default = void 0;

var _default = str => {
 console.log('print: ' + str);
};

exports.default = _default;

2. hook node 的 require 機(jī)制，直接加載 import/export

這種機(jī)制一般是通過(guò)對(duì) node 的 require 機(jī)制進(jìn)行 hook，劫持 require 抓取的源文件代碼，把源代碼轉(zhuǎn)碼成 commonjs 規(guī)范之后，再傳送給 require 機(jī)制原本的代碼流中。

pirates 之類的第三方 npm 包提供了這種添加 hook 的功能。

babel-register 便是使用這種方式達(dá)到 node 運(yùn)行 es6 模塊文件的目的的。

2.1 使用 babel-register 直接運(yùn)行 es6 模塊文件

示例目錄：

- package.json
- src/
 - entry.js       # 這里多了一個(gè)入口文件，專門用于注冊(cè) babel-register
 - index.js
 - print.js
 - ...

相關(guān)文件：

# package.json
{
 "scripts": {
 "run": "node src/entry.js"
 },
 "devDependencies": {
 "@babel/core": "^7.1.2",
 "@babel/plugin-transform-modules-commonjs": "^7.2.0",
 "@babel/register": "^7.0.0"
 }
}


# src/entry.js       # 入口文件必須使用 commonjs 規(guī)范來(lái)寫，因?yàn)檫€沒(méi)有注冊(cè) hook
require('@babel/register')({
 plugins: ['@babel/plugin-transform-modules-commonjs']
});
require('./index');


# src/index.js
import print from './print';

print('index');


# src/print.js
export default str => {
 console.log('print: ' + str);
};

運(yùn)行：

npm run run

結(jié)果：

# 命令行打印

print: index

這種方式因?yàn)橹虚g轉(zhuǎn)碼會(huì)有額外的性能損耗，所以不建議在生產(chǎn)環(huán)境下使用，只建議在開(kāi)發(fā)模式下使用。

2.2 使用babel-node 直接運(yùn)行 es6 模塊文件

babel-node 對(duì) babel-register 進(jìn)行了封裝，提供了在命令行直接運(yùn)行 es6 模塊文件的便捷方式。

示例目錄：

- package.json
- src/
 - index.js
 - print.js
 - ...

相關(guān)文件：

# package.json
{
 "scripts": {
 "run": "babel-node src/index.js --plugins @babel/plugin-transform-modules-commonjs"
 },
 "devDependencies": {
 "@babel/core": "^7.1.2",
 "@babel/node": "^7.2.0",
 "@babel/plugin-transform-modules-commonjs": "^7.2.0"
 }
}


# src/index.js
import print from './print';

print('index');


# src/print.js
export default str => {
 console.log('print: ' + str);
};

運(yùn)行：