babylon
Advanced tools
Changelog
6.15.0 (2017-01-10)
Add support for Flow shorthand import type (#267) (Jeff Morrison)
This change implements flows new shorthand import syntax and where previously you had to write this code:
import {someValue} from "blah";
import type {someType} from "blah";
import typeof {someOtherValue} from "blah";
you can now write it like this:
import {
someValue,
type someType,
typeof someOtherValue,
} from "blah";
For more information look at this pull request.
flow: allow leading pipes in all positions (#256) (Vladimir Kurchatkin)
This change now allows a leading pipe everywhere types can be used:
var f = (x): | 1 | 2 => 1;
Throw error when exporting non-declaration (#241) (Kai Cataldo)
Previously babylon parsed the following exports, although they are not valid:
export typeof foo;
export new Foo();
export function() {};
export for (;;);
export while(foo);
Don't set inType flag when parsing property names (#266) (Vladimir Kurchatkin)
This fixes parsing of this case:
const map = {
[age <= 17] : 'Too young'
};
Fix source location for JSXEmptyExpression nodes (fixes #248) (#249) (James Long)
The following case produced an invalid AST
<div>{/* foo */}</div>
Use fromCodePoint to convert high value unicode entities (#243) (Ryan Duffy)
When high value unicode entities (e.g. 💩) were used in the input source code they are now correctly encoded in the resulting AST.
Rename folder to avoid Windows-illegal characters (#281) (Ryan Plant)
Allow this.state.clone() when parsing decorators (#262) (Alex Rattray)
User external-helpers (#254) (Daniel Tschinder)
Add watch script for dev (#234) (Kai Cataldo)
Freeze current plugins list for "*" option, and remove from README.md (#245) (Andrew Levine)
Prepare tests for multiple fixture runners. (#240) (Daniel Tschinder)
Add some test coverage for decorators stage-0 plugin (#250) (Andrew Levine)
Refactor tokenizer types file (#263) (Sven SAULEAU)
Update eslint-config-babel to the latest version 🚀 (#273) (greenkeeper[bot])
chore(package): update rollup to version 0.41.0 (#272) (greenkeeper[bot])
chore(package): update flow-bin to version 0.37.0 (#255) (greenkeeper[bot])
Readme
Babylon is a JavaScript parser used in Babel.
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.
babylon.parse(code, [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.
plugins: Array containing the plugins that you want to enable.
Babylon generates AST according to Babel AST format. It is based on ESTree spec with the following deviations:
directives field with Directive and DirectiveLiteralAST for JSX code is based on Facebook JSX AST with the addition of one node type:
JSXTextBabylon 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.
require("babylon").parse("code", {
// parse in strict mode and allow module declarations
sourceType: "module",
plugins: [
// enable jsx and flow syntax
"jsx",
"flow"
]
});
jsxflowdoExpressionsobjectRestSpreaddecorators (Based on an outdated version of the Decorators proposal. Will be removed in a future version of Babylon)classPropertiesexportExtensionsasyncGeneratorsfunctionBindfunctionSentdynamicImportFAQs
A JavaScript parser
We found that babylon demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 5 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Ransomware costs victims an estimated $30 billion per year and has gotten so out of control that global support for banning payments is gaining momentum.
Application Security
New SEC disclosure rules aim to enforce timely cyber incident reporting, but fear of job loss and inadequate resources lead to significant underreporting.
Security News
The Python Software Foundation has secured a 5-year sponsorship from Fastly that supports PSF's activities and events, most notably the security and reliability of the Python Package Index (PyPI).