Babel babylon

Babel babylon

Babylon 是 Babel 中使用的 JavaScript 解析器。

  • 默认启用最新的 ECMAScript 版本(ES2017)。

  • 附加注释。

  • 支持 JSX, Flow, Typescript 语法。

  • 支持实验阶段的语法提案(支持至少达到 stage-0 阶段的 PR)。

API

babylon.parse(code, [options])

babylon.parseExpression(code, [options])

parse() 将提供的 code 解析为完整的 ECMAScript 程序,而 parseExpression() 试图解析表达式,并会考虑性能问题。如果有疑问,请使用 .parse()。

选项

  • allowImportExportEverywhere: 默认情况下,import 和 export 声明只能出现在代码头部。设置该选项为 true 时,则允许他们在代码的任何地方使用。

  • allowReturnOutsideFunction: 默认情况下,顶级的 return 语句会引发错误。设置该选项为 true 时,则会接受错误的代码。

  • allowSuperOutsideMethod: TODO

  • sourceType: 表明代码应该解析的模式。可以是 "script","module" 或者 "unambiguous" 中任意一个。默认为 "script"。"unambiguous" 将使得 Babylon 尝试根据 ES6 的 import 或者 export 声明来进行推测。具有 ES6 import 和 export 的文件被认为是 "module",否则被认为是 "script"。

  • sourceFilename: 将输出的 AST 节点与其源文件名相关联。多用于多个输入文件的 AST 生成代码和 source map 时。

  • startLine: 默认情况下,解析的第一行代码被视为第 1 行。你可以提供一个行号来作为起始。多用于与其他源工具集成。

  • plugins: 数组,包含要启用的插件。

  • strictMode: TODO

  • ranges: 为每个节点添加 ranges 属性: [node.start, node.end]

  • tokens: 将所有解析的 token 添加到 File 节点的上的 tokens 属性中。

输出

Babylon 根据 Babel AST 的格式 生成 AST 。它基于 ESTree 规范,具有以下差别:

现在可以使用 estree 插件来取消掉这些差别

JSX 的 AST 代码基于 Facebook JSX AST 并额外添加了一个节点类型:

  • JSXText

Semver

Babylon 在大多数情况下遵循 semver。唯一需要注意的是,某些规范遵从性错误的修复可能会在下一个补丁版本中发布。

例如:我们推送了修复早期错误的代码,就像#107 - 多个文件默认导出多个。这被视为一个错误进行修复,即时它会导致构建失败。

案例

require("babylon").parse("code", {
  // 以严格模式解析并允许模块声明
  sourceType: "module",

  plugins: [
    // 启用 jsx 和 flow 语法
    "jsx",
    "flow"
  ]});

插件

  • estree

  • jsx

  • flow

  • doExpressions

  • objectRestSpread

  • decorators(基于过时版本的 Decorators 提案。将在 Babylon 的未来版本中删除。)

  • classProperties

  • exportExtensions

  • asyncGenerators

  • functionBind

  • functionSent

  • dynamicImport

  • templateInvalidEscapes

鸣谢

该项目中使用了大量的 acorn 和 acorn-jsx 语法,感谢 @RReverser 和 @marijnh 出色的工作。