babylon

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

鸣谢

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

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 并额外添加了一个节点类型:

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

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

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

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

本文档系腾讯云开发者社区成员共同维护，如有问题请联系 cloudcommunity@tencent.com

最后更新于：2018-08-24