babylon

Babylon is a JavaScript parser used in Babel.

• The latest ECMAScript version enabled by default (ES2017).
• Comment attachment.
• Support for JSX and Flow.
• Support for experimental language proposals (accepting PRs for anything at least stage-0).

Credits

Heavily based on acorn and acorn-jsx, thanks to the awesome work of @RReverser and @marijnh.

Significant diversions are expected to occur in the future such as streaming, EBNF definitions, sweet.js integration, interspatial parsing and more.

API

babylon.parse(code, [options])

babylon.parseExpression(code, [options])

parse() parses the provided code as an entire ECMAScript program, while parseExpression() tries to parse a single Expression with performance in mind. When in doubt, use .parse().

Options

• allowImportExportEverywhere: By default, import and export declarations can only appear at a program's top level. Setting this option to true allows them anywhere where a statement is allowed.

• allowReturnOutsideFunction: By default, a return statement at the top level raises an error. Set this to true to accept such code.

• allowSuperOutsideMethod: TODO

• sourceType: Indicate the mode the code should be parsed in. Can be either "script" or "module".

• sourceFilename: Correlate output AST nodes with their source filename. Useful when generating code and source maps from the ASTs of multiple input files.

• startLine: By default, the first line of code parsed is treated as line 1. You can provide a line number to alternatively start with. Useful for integration with other source tools.

• plugins: Array containing the plugins that you want to enable.

• strictMode: TODO

Output

Babylon generates AST according to Babel AST format. It is based on ESTree spec with the following deviations:

• Literal token is replaced with StringLiteral, NumericLiteral, BooleanLiteral, NullLiteral, RegExpLiteral
• Property token is replaced with ObjectProperty and ObjectMethod
• MethodDefinition is replaced with ClassMethod
• Program and BlockStatement contain additional directives field with Directive and DirectiveLiteral
• ClassMethod, ObjectProperty, and ObjectMethod value property's properties in FunctionExpression is coerced/brought into the main method node.

AST for JSX code is based on Facebook JSX AST with the addition of one node type:

• JSXText

Semver

Babylon follows semver in most situations. The only thing to note is that some spec-compliancy bug fixes may be released under patch versions.

For example: We push a fix to early error on something like #107 - multiple default exports per file. That would be considered a bug fix even though it would cause a build to fail.

Example

require("babylon").parse("code", {
  // parse in strict mode and allow module declarations
  sourceType: "module",

  plugins: [
    // enable jsx and flow syntax
    "jsx",
    "flow"
  ]
});

Plugins

• jsx
• flow
• doExpressions
• objectRestSpread
• decorators (Based on an outdated version of the Decorators proposal. Will be removed in a future version of Babylon)
• classProperties
• exportExtensions
• asyncGenerators
• functionBind
• functionSent
• dynamicImport

Changelog

7.0.0-beta.0 (2017-02-15)

• Reintroduce Variance node (#333) (Daniel Tschinder)
• Rename NumericLiteralTypeAnnotation to NumberLiteralTypeAnnotation (#332) (Charles Pick)
• [7.0] Remove ForAwaitStatement, add await flag to ForOfStatement (#349) (Brandon Dail)
• chore(package): update ava to version 0.18.0 (#345) (greenkeeper[bot])
• chore(package): update babel-plugin-istanbul to version 4.0.0 (#350) (greenkeeper[bot])
• Change location of ObjectTypeIndexer to match flow (#228) (Daniel Tschinder)
• Rename flow AST Type ExistentialTypeParam to ExistsTypeAnnotation (#322) (Toru Kobayashi)
• Revert "Temporary rollback for erroring on trailing comma with spread (#154)" (#290) (Daniel Tschinder)
• Remove classConstructorCall plugin (#291) (Brian Ng)
• Update yarn.lock (Daniel Tschinder)
• Update cross-env to 3.x (Daniel Tschinder)
• [7.0] Remove node 0.10, 0.12 and 5 from Travis (#284) (Sergey Rubanov)
• Remove String.fromCodePoint shim (#279) (Mathias Bynens)