Babel 中文文档
  • 印记中文
  • 文档
  • 配置
  • 试用
  • 视频
  • 博客
  • 赞助
  • 团队
  • GitHub

›指南

指南

  • 什么是 Babel?
  • 使用指南
  • 配置 Babel
  • 学习 ES2015
  • 升级至 Babel 7

配置参考

  • 配置文件
  • Config Options
  • 预设
  • 插件
  • 插件列表
  • Compiler assumptions

预设

  • @babel/preset-env
  • @babel/preset-react
  • @babel/preset-typescript
  • @babel/preset-flow

杂项

  • 路线图
  • 注意事项
  • 新增特性时间轴
  • FAQ
  • 编辑器

集成包

  • @babel/cli
  • @babel/polyfill
  • @babel/plugin-transform-runtime
  • @babel/register
  • @babel/standalone

工具包

  • @babel/parser
  • @babel/core
  • @babel/generator
  • @babel/code-frame
  • @babel/runtime
  • @babel/template
  • @babel/traverse
  • @babel/types

帮助工具包

  • helper-compilation-targets
  • helper-module-imports
Edit

学习 ES2015

es6 特性

本文源自 Luke Hoban 优秀的 es6 特性仓库。去 GitHub 给他一个 star 吧!

REPL

一定要在线上的 REPL 中 尝试一下这些特性嗷!

简介

ECMAScript 2015 是发布于 2015 年 6 月的 ECMAScript 标准。

ES2015 是对该语言的一次重大更新,也是自 2009 年 ES5 标准化以来对该语言的第一次重大更新。在主要的 JavaScript 引擎中,这些特性的实现正在进行中。

可阅读ES2015 标准 以了解 ECMAScript 2015 完整的语言规范。

ECMAScript 2015 特性

箭头函数和 this 作用域

箭头函数是一种使用 => 语法的函数速记。 它们在语法上类似于 C#、Java 8 和 CoffeeScript 中的相关特性。 它们同时支持表达式和语句体两种写法。 不同于函数,箭头函数与其上下文代码共享相同的 this。 如果一个箭头函数在另一个函数里面,它共享其父函数的 "arguments "变量。

// 表达式写法
var odds = evens.map(v => v + 1);
var nums = evens.map((v, i) => v + i);

// 语句体写法
nums.forEach(v => {
  if (v % 5 === 0)
    fives.push(v);
});

// this 作用域
var bob = {
  _name: "Bob",
  _friends: [],
  printFriends() {
    this._friends.forEach(f =>
      console.log(this._name + " knows " + f));
  }
};

// arguments 作用域
function square() {
  let example = () => {
    let numbers = [];
    for (let number of arguments) {
      numbers.push(number * number);
    }

    return numbers;
  };

  return example();
}

square(2, 4, 7.5, 8, 11.5, 21); // returns: [4, 16, 56.25, 64, 132.25, 441]

类

ES2015 的类是基于原型的面向对象模式的语法糖。 单一方便的声明形式使类模式更易用,并提升了互通性。 类支持基于原型的继承、父类调用、实例、 静态方法以及构造函数。

class SkinnedMesh extends THREE.Mesh {
  constructor(geometry, materials) {
    super(geometry, materials);

    this.idMatrix = SkinnedMesh.defaultMatrix();
    this.bones = [];
    this.boneMatrices = [];
    //...
  }
  update(camera) {
    //...
    super.update();
  }
  static defaultMatrix() {
    return new THREE.Matrix4();
  }
}

增强的对象字面量

对象字面量被扩展到在构造时支持设置原型、简写为foo: foo的赋值、 定义方法以及进行父类调用。 这些都使对象字面量和类声明更加接近, 并使基于对象的设计 从一些相同的便利中受益。

var obj = {
    // 设置原型。"__proto__" 或者 '__proto__' 都可以。
    __proto__: theProtoObj,
    // 计算出的属性名称不会设置为原型,
    // 重复的 __proto__ 属性也不会在运行前报错。
    ['__proto__']: somethingElse,
    // ‘handler: handler’ 的简写
    handler,
    // 方法
    toString() {
     // 父类调用
     return "d " + super.toString();
    },
    // (动态)计算的属性名称
    [ "prop_" + (() => 42)() ]: 42
};

__proto__ 属性必须得引擎原生支持,在前一版 ECMAScript 中已被弃用。大多数引擎现在仍然支持此属性,但 有些已不支持了。另外,请注意,只有 web 游览器 需要实现它,因为它在 附件 B 中。它在 Node 中是可用的。

模版字符串

模版字符串为构造字符串提供语法糖。 这与 Perl、Python 等的字符串插值功能类似。 可以选择添加一个标签,以允许自定义字符串的构造, 避免注入攻击 或 从字符串内容中构造更高级别的数据结构。

// 创建字符串字面量
`This is a pretty little template string.`

// 多行字符串
`In ES5 this is
 not legal.`

// 插入变量绑定
var name = "Bob", time = "today";
`Hello ${name}, how are you ${time}?`

// 未转义的模版字符串
String.raw`In ES5 "\n" is a line-feed.`

// 构建一个 HTTP 请求前缀是用来解释可替换性和可构建性。
GET`http://foo.org/bar?a=${a}&b=${b}
    Content-Type: application/json
    X-Credentials: ${credentials}
    { "foo": ${foo},
      "bar": ${bar}}`(myOnReadyStateChangeHandler);

解构

解构允许使用模式匹配进行绑定,并支持匹配数组和对象。 解构是软失败的,类似于标准的对象查找 foo["bar"], 在没有找到时提供 undefined 值。

// 列表匹配
var [a, ,b] = [1,2,3];
a === 1;
b === 3;

// 对象匹配
var { op: a, lhs: { op: b }, rhs: c }
       = getASTNode()

// 对象匹配简写
// 在作用域内,绑定 `op`, `lhs` 和 `rhs`
var {op, lhs, rhs} = getASTNode()

// 也可用于参数
function g({name: x}) {
  console.log(x);
}
g({name: 5})

// 软失败解构
var [a] = [];
a === undefined;

// 带默认值的软失败解构
var [a = 1] = [];
a === 1;

// 解构与默认参数
function r({x, y, w = 10, h = 10}) {
  return x + y + w + h;
}
r({x:1, y:2}) === 23

默认值 + Rest + Spread

默认值就是调用执行的默认参数值。 在一个函数调用中把一个数组变成连续的参数。并将尾部参数绑定到一个数组—— Rest, 它可以取代对 arguments 的需求,也可以更直接地解决常见的情况。

function f(x, y=12) {
  // 如果没有传值,y 是 12(或者传入的是 undefined)
  return x + y;
}
f(3) == 15
function f(x, ...y) {
  // y 是一个数组
  return x * y.length;
}
f(3, "hello", true) == 6
function f(x, y, z) {
  return x + y + z;
}
// 将数组的每一项作为参数传入
f(...[1,2,3]) == 6

变量 + 常量

拥有块级作用域的 let 是替代 var 的新的变量声明关键字。 const是一次赋值。在再次赋值前,静态限制防止会生效。

function f() {
  {
    let x;
    {
      // 这是可以的,因为它是一个块范围
      const x = "sneaky";
      // 错误,因为上面是用 `const` 定义的。
      x = "foo";
    }
    // 这是可以的,因为它是用 `let` 声明的
    x = "bar";
    // 错误,因为在这个块级作用域中,x 已经声明过了
    let x = "inner";
  }
}

迭代器 + For..Of

迭代器对象实现了像 CLR IEnumerable 或 Java Iterable 一样的自定义迭代器。 将 for...in 泛化为基于自定义迭代器的 for...of 的迭代。 不需要实现一个数组,使懒惰的设计模式像 LINQ。

let fibonacci = {
  [Symbol.iterator]() {
    let pre = 0, cur = 1;
    return {
      next() {
        [pre, cur] = [cur, pre + cur];
        return { done: false, value: cur }
      }
    }
  }
}

for (var n of fibonacci) {
  // 在 1000 处截止该迭代
  if (n > 1000)
    break;
  console.log(n);
}

迭代器是基于这些鸭子类型的接口 (此处使用TypeScript类型语法举例,仅供参考)。

interface IteratorResult {
  done: boolean;
  value: any;
}
interface Iterator {
  next(): IteratorResult;
}
interface Iterable {
  [Symbol.iterator](): Iterator
}

通过 polyfill 使用

为了使用迭代器,你必须引入 Babel polyfill。

生成器

生成器使用 function* 和 yield 简化了迭代器的编写。 一个以 function* 声明的函数会返回一个生成器实例。 生成器是迭代器的子类型,包括额外的 next 和 throw。 这些使值能够回流到生成器中, 所以 yield 是一个返回值(或抛出)的表达形式。

注意:也可以用来启用类似 'await' 的异步编程,也可以参见 ES7 的 await提案。

var fibonacci = {
  [Symbol.iterator]: function*() {
    var pre = 0, cur = 1;
    for (;;) {
      var temp = pre;
      pre = cur;
      cur += temp;
      yield cur;
    }
  }
}

for (var n of fibonacci) {
  // 在 1000 处截止该序列
  if (n > 1000)
    break;
  console.log(n);
}

生成器的接口是(使用TypeScript 语法举例说明):

interface Generator extends Iterator {
    next(value?: any): IteratorResult;
    throw(exception: any);
}

通过 polyfill 使用

为了使用生成器,你必须引入 Babel polyfill。

Comprehensions

在 Babel 6.0 中已移除

Unicode

非破坏性的添加,以支持完整的 Unicode 编码, 包括字符串中新的 unicode 字面形式和新的正则 u 模式来处理代码点, 以及新的 API 来处理 21 位代码点级别的字符串。 这些新增功能支持在 JavaScript 中构建全局应用程序。

// 与 ES5.1 一样
"𠮷".length == 2

// 新的正则表达模式, opt-in ‘u’
"𠮷".match(/./u)[0].length == 2

// new form
"\u{20BB7}" == "𠮷"
"𠮷" == "\uD842\uDFB7"

// new String ops
"𠮷".codePointAt(0) == 0x20BB7

// for-of iterates code points
for(var c of "𠮷") {
  console.log(c);
}

模块化

语言层面上支持组件定义的模块。 编纂了流行的 JavaScript 模块加载器(AMD,CommonJS)的模式。 运行时行为由主机定义的默认加载器定义。 隐含的异步模式--在所请求的模块可用并被处理之前不会执行任何代码。

// lib/math.js
export function sum(x, y) {
  return x + y;
}
export var pi = 3.141593;
// app.js
import * as math from "lib/math";
console.log("2π = " + math.sum(math.pi, math.pi));
// otherApp.js
import {sum, pi} from "lib/math";
console.log("2π = " + sum(pi, pi));

一些额外的功能包括 export default 和 export *:

// lib/mathplusplus.js
export * from "lib/math";
export var e = 2.71828182846;
export default function(x) {
    return Math.exp(x);
}
// app.js
import exp, {pi, e} from "lib/mathplusplus";
console.log("e^π = " + exp(pi));

模块格式化

Babel 可以将 ES2015 模块转译成几种不同的格式, 包括 Common.js、AMD、System 和 UMD。你甚至可以创建你自己的格式。 更多细节请查看模块文档。

模块加载器

非 ES2015 标准部分

在 ECMAScript 2015 的规范中,这被留作实施定义。最终的标准将在 WHATWG 的 Loader 规范中,但那是目前正在进行的工作。下面的内容来自之前的 ES2015 草案。

模块加载器支持:

  • 动态加载
  • 状态隔离
  • 全局命名空间隔离
  • 编译钩子
  • 嵌套虚拟化

可以配置默认的模块加载器, 也可以构建新的加载器来执行和加载被隔离或受限环境中的代码。

// 动态加载 – ‘System’ 是默认的加载器
System.import("lib/math").then(function(m) {
  alert("2π = " + m.sum(m.pi, m.pi));
});

// 创建一个执行沙盒 – 新的加载器
var loader = new Loader({
  global: fixup(window) // 替代 ‘console.log’
});
loader.eval("console.log(\"hello world!\");");

// 直接操作模块缓存
System.get("jquery");
System.set("jquery", Module({$: $})); // 警告:未定稿

其他必须的 polyfill

由于 Babel 默认使用 common.js 模块, 它不包括模块加载器 API 的 polyfill。 可以从这里获取其他 polyfill。

使用模块加载器

为了使用这个,你需要告诉 Babel 使用 system 模块格式化。 也必须确保检查 System.js

Map + Set + WeakMap + WeakSet

为常见的算法提供高效的数据结构。 WeakMaps 提供无泄漏的对象键的边表。

// Sets
var s = new Set();
s.add("hello").add("goodbye").add("hello");
s.size === 2;
s.has("hello") === true;

// Maps
var m = new Map();
m.set("hello", 42);
m.set(s, 34);
m.get(s) == 34;

// Weak Maps
var wm = new WeakMap();
wm.set(s, { extra: 42 });
wm.size === undefined

// Weak Sets
var ws = new WeakSet();
ws.add({ data: 42 });
// 因为添加的对象没有其他引用,所以它不会被保存在集合中

通过 polyfill 使用

为了在所有环境中使用 Maps、 Sets、 WeakMaps 以及 WeakSets,你必须引入 Babel polyfill.

代理

代理使创建的对象具有目标对象的全部可用行为。 可用于拦截、对象虚拟化、 记录/归档等。

// 代理一个普通对象
var target = {};
var handler = {
  get: function (receiver, name) {
    return `Hello, ${name}!`;
  }
};

var p = new Proxy(target, handler);
p.world === "Hello, world!";
// 代理一个函数对象
var target = function () { return "I am the target"; };
var handler = {
  apply: function (receiver, ...args) {
    return "I am the proxy";
  }
};

var p = new Proxy(target, handler);
p() === "I am the proxy";

所有的运行时级别的元操作都有 traps 可用:

var handler =
{
  // target.prop
  get: ...,
  // target.prop = value
  set: ...,
  // 'prop' in target
  has: ...,
  // delete target.prop
  deleteProperty: ...,
  // target(...args)
  apply: ...,
  // new target(...args)
  construct: ...,
  // Object.getOwnPropertyDescriptor(target, 'prop')
  getOwnPropertyDescriptor: ...,
  // Object.defineProperty(target, 'prop', descriptor)
  defineProperty: ...,
  // Object.getPrototypeOf(target), Reflect.getPrototypeOf(target),
  // target.__proto__, object.isPrototypeOf(target), object instanceof target
  getPrototypeOf: ...,
  // Object.setPrototypeOf(target), Reflect.setPrototypeOf(target)
  setPrototypeOf: ...,
  // for (let i in target) {}
  enumerate: ...,
  // Object.keys(target)
  ownKeys: ...,
  // Object.preventExtensions(target)
  preventExtensions: ...,
  // Object.isExtensible(target)
  isExtensible :...
}

不支持的特性

由于 ES5 的限制,代理不能被转译或 polyfill。可以查看 多种 JavaScript 引擎的支持情况。

Symbols

Symbol 实现了对对象状态的访问控制。Symbol 允许属性以 string (如 ES5)或 Symbol 为键。 Symbol 是一种新的原始类型。 可选的 name 参数可在调试中使用 - 但不是身份的一部分。 Symbol 是唯一的(就像 gensym),但不是私有的, 因为它们是通过反射功能(如Object.getOwnPropertySymbols)对外暴露的。

(function() {

  // 模块范围内的符号
  var key = Symbol("key");

  function MyClass(privateData) {
    this[key] = privateData;
  }

  MyClass.prototype = {
    doStuff: function() {
      ... this[key] ...
    }
  };

  // Babel 可以有限支持 Symbol,完全支持还需要原生实现。
  typeof key === "symbol"
})();

var c = new MyClass("hello")
c["key"] === undefined

通过 polyfill 提供有限的支持

有限的支持依赖于 Babel polyfill。由于语言级别的限制,一些功能并不能被转译或 polyfilled。详情查看 core.js's caveats 章节。

内置子类化

在 ES2015,如 Array、Date 和 DOM Element等可以被子类化。

// 自定义 Array 子类
class MyArray extends Array {
    constructor(...args) { super(...args); }
}

var arr = new MyArray();
arr[1] = 12;
arr.length == 2

部分支持

内置的子类化只可以在个别基础类上执行,比如 HTMLElement 可以被子类化。然而许多像 Date、Array 以及 Error 等由于 ES5 引擎的限制不能

Math + Number + String + Object APIs

增加了许多新的库,包括核心 Math 库、数组转换方法, 以及用于复制的 Object.assign。

Number.EPSILON
Number.isInteger(Infinity) // false
Number.isNaN("NaN") // false

Math.acosh(3) // 1.762747174039086
Math.hypot(3, 4) // 5
Math.imul(Math.pow(2, 32) - 1, Math.pow(2, 32) - 2) // 2

"abcde".includes("cd") // true
"abc".repeat(3) // "abcabcabc"

Array.from(document.querySelectorAll("*")) // Returns a real Array
Array.of(1, 2, 3) // 与 new Array(...) 一样,但不具备特殊箭头函数行为。
[0, 0, 0].fill(7, 1) // [0,7,7]
[1,2,3].findIndex(x => x == 2) // 1
["a", "b", "c"].entries() // iterator [0, "a"], [1,"b"], [2,"c"]
["a", "b", "c"].keys() // iterator 0, 1, 2
["a", "b", "c"].values() // iterator "a", "b", "c"

Object.assign(Point, { origin: new Point(0,0) })

通过 polyfill 提供有限支持

Babel polyfill 支持大多数 API。 但是由于各种原因,某些功能被省略了。 (例如:String.prototype.normalize 需要大量额外代码来支持。) 你可以在这里 找到更多 polyfills。

二进制和八进制字面量

为二进制(b)和八进制(o)增加了两种新的数字字面量。

0b111110111 === 503 // true
0o767 === 503 // true

只支持字面量形式

Babel 只能转译 0o767 却不能转译 Number("0o767").

Promises

Promise 是一个用于异步编程的库。 Promise 是对未来可能提供的值的第一类表示。 Promise 在许多现有的 JavaScript 库中已有使用。

function timeout(duration = 0) {
    return new Promise((resolve, reject) => {
        setTimeout(resolve, duration);
    })
}

var p = timeout(1000).then(() => {
    return timeout(2000);
}).then(() => {
    throw new Error("hmm");
}).catch(err => {
    return Promise.all([timeout(100), timeout(200)]);
})

通过 polyfill 支持

为了支持 Promise,你必须引入 Babel polyfill.

反射 API

完整的反射 API���暴露了对象上的运行时间级别的元操作。 这实际上是代理 API 的逆向, 并允许进行与代理 trap 相同的元操作的调用。 对于实现代理特别有用。

var O = {a: 1};
Object.defineProperty(O, 'b', {value: 2});
O[Symbol('c')] = 3;

Reflect.ownKeys(O); // ['a', 'b', Symbol(c)]

function C(a, b){
  this.c = a + b;
}
var instance = Reflect.construct(C, [20, 22]);
instance.c; // 42

通过 polyfill 支持

为了支持反射,你必须引入 Babel polyfill.

尾调用

在尾部位置的调用被保证不会使堆栈无限制地增长。 使得递归算法在面对无界的输入时是安全的。

function factorial(n, acc = 1) {
    "use strict";
    if (n <= 1) return acc;
    return factorial(n - 1, n * acc);
}

// 在今天的大多数实现中,堆栈溢出。
// 但在 ES2015 中对任意输入是安全的
factorial(100000)

在 Babel 6 中暂时删除了

由于全局支持尾部调用的复杂性和性能影响, 只支持显式自引用尾部递归。 由于其他 Bug 而被删除,将被重新实现。

← 配置 Babel升级至 Babel 7 →
  • 简介
  • ECMAScript 2015 特性
    • 箭头函数和 this 作用域
    • 类
    • 增强的对象字面量
    • 模版字符串
    • 解构
    • 默认值 + Rest + Spread
    • 变量 + 常量
    • 迭代器 + For..Of
    • 生成器
    • Comprehensions
    • Unicode
    • 模块化
    • 模块加载器
    • Map + Set + WeakMap + WeakSet
    • 代理
    • Symbols
    • 内置子类化
    • Math + Number + String + Object APIs
    • 二进制和八进制字面量
    • Promises
    • 反射 API
    • 尾调用
Babel 中文文档
文档
学习 ES2015
社区
视频用户Stack OverflowSlack 频道Twitter
更多
博客GitHub 组织GitHub 仓库Website 仓库旧版网址 6.x旧版网址 5.x