Babylon 是 Babel 中使用的 JavaScript 解析器。
- 默认启用最新的 ECMAScript 版本(ES2017)。
- 附加注释。
- 支持 JSX, Flow, Typescript 语法。
- 支持实验阶段的语法提案（支持至少达到 stage-0 阶段的 PR）。
鸣谢
该项目中使用了大量的 acorn 和 acorn-jsx 语法，感谢 @RReverser 和 @marijnh 出色的工作。
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声明来进行_推测_。具有 ES6import和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插件来取消掉这些差别
- 文字符号会被替换为字符串，数字，布尔，Null，正则表达式
- 属性符号会被替换为 ObjectProperty 和 ObjectMethod
- 方法定义会被替换为类方法
- 指令和语法块的
directives字段中包含额外的指令和指令字符集 - 函数表达式中的类方法，对象属性和对象方法值属性的属性被强制/带入主方法节点。
JSX 的 AST 代码基于 Facebook JSX AST 并额外添加了一个节点类型:
JSXText
Semver
Babylon 在大多数情况下遵循 semver。唯一需要注意的是，某些规范遵从性错误的修复可能会在下一个补丁版本中发布。
例如：我们推送了修复早期错误的代码，就像#107 - 多个文件默认导出多个。这被视为一个错误进行修复，即时它会导致构建失败。
案例
require("babylon").parse("code", {
// 以严格模式解析并允许模块声明
sourceType: "module",
plugins: [
// 启用 jsx 和 flow 语法
"jsx",
"flow"
]
});
插件
| 插件名 | 代码示例 |
|---|---|
estree (repo) | n/a |
jsx (repo) | <a attr="b">{s}</a> |
flow (repo) | var a: string = ""; |
flowComments (文档) | /*:: type Foo = {...}; */ |
typescript (repo) | var a: string = ""; |
doExpressions | var a = do { if (true) { 'hi'; } }; |
objectRestSpread (提案) | var a = { b, ...c }; |
decorators (Stage 1) and decorators2 (Stage 2 提案) | @a class A {} |
classProperties (提案) | class A { b = 1; } |
classPrivateProperties (提案) | class A { #b = 1; } |
classPrivateMethods (提案) | class A { #c() {} } |
exportExtensions (提案 1), (提案 2) | Proposal 1: export v from "mod" Proposal 2: export * as ns from "mod" |
asyncGenerators (提案) | async function*() {}, for await (let a of b) {} |
functionBind (提案) | a::b, ::console.log |
functionSent | function.sent |
dynamicImport (提案) | import('./guy').then(a) |
numericSeparator (提案) | 1_000_000 |
optionalChaining (提案) | a?.b |
importMeta (提案) | import.meta.url |
bigInt (提案) | 100n |
optionalCatchBinding (提案) | try {throw 0;} catch{do();} |
throwExpressions (提案) | () => throw new Error("") |
pipelineOperator (提案) | a \|> b |
nullishCoalescingOperator (提案) | a ?? b |
FAQ
Babylon 会支持插件系统吗？
以前的 issues：babel/babel#1351，#500。
我们目前不愿意承诺支持插件的 API 或者由此产生的生态系统(维护 Babel 的插件系统目前足够使用)。目前还不清楚如何使 API 更有效，并且会限制重构和优化代码库的能力。
我们目前对那些想要创建定制语法的用户建议是 fork Babylon。
要使用自定义解析器，可以通过将其 npm 包名称添加到 .babelrc，或者在用 JavaScript 的时候通过 require 引入它。
{
"parserOpts": {
"parser": "custom-fork-of-babylon-on-npm-here"
}
}