淘系前端团队

找回 Node.js 里面那些遗失的 ES6 特性

作者：发布于：

由于 Babel，WebPack， React 技术的流行，小明同学已经开始在前端代码里面用上了 ECMAScript 2015 （以下称 ES6 ）的众多特性。import, export, class, arrow function, let const 等等关键词甚至都已经开始变成小明的肌肉记忆。

但是等等，对于小明这样既写 React 又写 Node.js 的的人来说，又有点分裂了。经常性的在 Node.js 里面写 import xxx from 'xxx'; 然后被 Node.js 的解析器无情的拒绝；
另外对于一致性有点追求的人肯定受不了同一个仓库，同一类脚本，同一个人维护却有两种风格。

恩，不能忍！

Node.js 对 ES6 的支持

其实 Node.js 对 ES6 的很多特性都已经开始支持了。在 Node.js 使用的 JS 引擎 V8 里面将不同状态 ES6 特性分成了 3 个等级：

shipping （已经分发并默认开启的特性）

staged （已经分发，但需要使用 --harmony 参数开启的特性）

in progress （开发中，还不稳定或者未实现的特性，不推荐使用）

『shipping』已经开启的 ES6 特性

本文使用的 Node.js 版本号：
稳定版本：4.2.4
对应 V8 引擎的版本：4.5.103.35
最新版本：5.3.0
对应 V8 引擎版本：4.6.85.31

目前默认开启的 ES6 特性如下：

Block scoping

let (strict mode only)

const

function-in-blocks (strict mode only [1])

Classes (strict mode only)

Collections

WeakMap

WeakSet

Typed arrays

Generators

Binary and Octal literals

Object literal extensions (shorthand properties and methods)

Promises

New String methods

Symbols

Template strings

Arrow Functions

new.target [2]

Object.assign

Spread operator [2]

对于这些官方引擎的特性，由于在底层实现，在性能与稳定性都有更高保障，在任何时候我们都应该优先使用。

『staged』需要使用 `--harmony` 参数开启的 ES6 特性

Symbol.toStringTag

Array.prototype.includes （可以直接使用 polyfill 支持， 5.x 版本）

Rest Parameters （可以直接用 transform-es2015-parameters 转换，支持更全面， 5.x 版本）

『in progress』开发中的 ES 特性

  --harmony_modules (enable "harmony modules")
  --harmony_array_includes (enable "harmony Array.prototype.includes")
  --harmony_regexps (enable "harmony regular expression extensions")
  --harmony_proxies (enable "harmony proxies")
  --harmony_sloppy (enable "harmony features in sloppy mode")
  --harmony_unicode_regexps (enable "harmony unicode regexps")
  --harmony_reflect (enable "harmony Reflect API")
  --harmony_destructuring (enable "harmony destructuring")
  --harmony_sharedarraybuffer (enable "harmony sharedarraybuffer")
  --harmony_atomics (enable "harmony atomics")
  --harmony_new_target (enable "harmony new.target")

『in progress』特性是那些将要支持（但具体时间未知）的特性。

开启模块的 ES6 模式

Babel 是一个插件式的 JavaScript 编译器，能将一些当前 JS 引擎中不支持的特性和语法，通过一个个特定插件，转换成当前引擎可以理解的 JS 脚本。我们可以使用 Babel 来转换我们的 Node.js 脚本。

接下来，我们就可以去 Babel 插件列表去选择对应的转换插件来为我们的 Node.js 插上隐形的翅膀了。

首先，我们需要确认我们需要 Babel 添加哪些特性支持。

选择 ES 转换的原则

优先使用原生特性

优先选择那些稳定实现的特性。由于一些 ES 特性需要引擎的底层支持才能完美支持，通过代码转换可能很难完美支持，对于这种特性只能不用或少用

基于这个原则，小明筛选出如下插件。

transform-strict-mode （由于很多 ES 特性需要严格模式才能打开，添加这个插件就会自动在所有文件上添加 'use strict';）

transform-es2015-modules-commonjs （将 ES6 模块标准转换成 Node.js 用的 CMD 模块标准）

transform-es2015-spread （支持 ES6 的 spread 操作符）

transform-es2015-destructuring （支持赋值解构）

transform-es2015-parameters （支持默认参数，参数解构，以及其他参数）

转换示例： import

from

import Mod from './mod';
new Mod();

'use strict';

var _mod = require('./mod');
var _mod2 = _interopRequireDefault(_mod);

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

new _mod2.default();

转换示例： export

from:

export default class Mod {

}

to:

"use strict";

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

上面这些选择的插件可以根据个人口味以及 Node.js 版本进行添加或删除。选好模块，我们就可以安装插件以及创建对应得babel配置文件去处理

安装插件

在 npm 模块或应用目录下执行

# 安装 core 和命令行工具
$ npm install --save-dev babel-core babel-cli 
# 安装所有插件
$ npm install --save-dev babel-plugin-transform-strict-mode babel-plugin-transform-es2015-modules-commonjs  babel-plugin-transform-es2015-spread babel-plugin-transform-es2015-destructuring babel-plugin-transform-es2015-parameters

添加配置文件

在应用根目录下面创建对应的配置文件 .babelrc,

{
  "plugins": [
    "transform-strict-mode",
    "transform-es2015-modules-commonjs",
    "transform-es2015-spread",
    "transform-es2015-destructuring",
    "transform-es2015-parameters"
  ]
}

文件组织

由于 Node.js本身有加载器，所以不需要将所有文件打包成一个文件，推荐的做法是，添加一个 src 目录，用于存放 ES6 脚本，然后将整个目录打包到 lib 目录下，对应的脚本为

babel src --out-dir lib

开发调试的时候，可以直接用 babel-cli 模块提供 babel-node 代替 node 直接启动 src 目录下面的入口脚本。

babel-node src/index.js

最后，将命令封装到 package.json 里面

{
  "name": "my-awasome-es6-package",
  "version": "1.0.0",
  "description": "use es6 in node",
  "main": "lib/index.js",
  "scripts": {
    "start": "babel-node src/index.js",
    "build": "babel src --out-dir lib"
  },
  "devDependencies": {
    "babel-cli": "~6.3.17",
    "babel-core": "~6.3.26",
    "babel-plugin-syntax-object-rest-spread": "^6.3.13",
    "babel-plugin-transform-es2015-modules-commonjs": "^6.3.16",
    "babel-plugin-transform-es2015-spread": "^6.3.14",
    "babel-plugin-transform-object-rest-spread": "^6.3.13",
    "babel-polyfill": "^6.3.14"
  }
}

我们就可以使用下面的命令启动和编译我们的代码了

# npm run build 构建脚本
# npm start 使用 babel-node 启动进程

这里的注意点：

模块入口 main 应该指向构建后的脚本，这样用你模块的用户不需要去进行编译，以及线上运行得时候不用去编译。

babel-node 不适合用于生产环境，生产环境应使用编译后的代码。不过在开发环境里面使用还是挺方便的。

接下来要做的事情

接下来你可能会问

测试怎么办

怎么 Debugging

大家可以在这里 ( Using Babel ) 查到更多感兴趣的信息

参考地址

Node.js ES6 支持文档

Babel 插件列表

ES6 兼容列表