Tags:
- [Breaking Change]
- [Spec Compliance]
- [New Feature]
- [Bug Fix]
- [Documentation]
- [Internal]
- [Polish]
Semver Policy: https://github.com/babel/babel/tree/main/packages/babel-parser#semver
Note: Gaps between patch versions are faulty, broken or test releases.
See the Babel Changelog for the pre-6.8.0 version Changelog.
ranges
option [skip ci] (Henry Zhu)String.fromCodePoint
shim (#279) (Mathias Bynens)Need to modify Babel for this AST node change, so moving to 7.0.
react-native broke with this so we reverted.
ESTree compatibility as plugin (#277) (Daniel Tschinder)
We finally introduce a new compatibility layer for ESTree. To put babylon into ESTree-compatible mode the new plugin estree
can be enabled. In this mode the parser will output an AST that is compliant to the specs of ESTree
We highly recommend everyone who uses babylon outside of babel to use this plugin. This will make it much easier for users to switch between different ESTree-compatible parsers. We so far tested several projects with different parsers and exchanged their parser to babylon and in nearly all cases it worked out of the box. Some other estree-compatible parsers include acorn
, esprima
, espree
, flow-parser
, etc.
To enable estree
mode simply add the plugin in the config:
{ "plugins": [ "estree" ] }
If you want to migrate your project from non-ESTree mode to ESTree, have a look at our Readme, where all deviations are mentioned.
Add a parseExpression public method (#213) (jeromew)
Babylon exports a new function to parse a single expression
import { parseExpression } from 'babylon'; const ast = parseExpression('x || y && z', options);
The returned AST will only consist of the expression. The options are the same as for parse()
Add startLine option (#346) (Raphael Mu)
A new option was added to babylon allowing to change the initial linenumber for the first line which is usually 1
. Changing this for example to 100
will make line 1
of the input source to be marked as line 100
, line 2
as 101
, line 3
as 102
, ...
Function predicate declaration (#103) (Panagiotis Vekris)
Added support for function predicates which flow introduced in version 0.33.0
declare function is_number(x: mixed): boolean %checks(typeof x === "number");
Allow imports in declare module (#315) (Daniel Tschinder)
Added support for imports within module declarations which flow introduced in version 0.37.0
declare module "C" { import type { DT } from "D"; declare export type CT = { D: DT }; }
Forbid semicolons after decorators in classes (#352) (Kevin Gibbons)
This example now correctly throws an error when there is a semicolon after the decorator:
class A { @a; foo(){} }
Keywords are not allowed as local specifier (#307) (Daniel Tschinder)
Using keywords in imports is not allowed anymore:
import { default } from "foo"; import { a as debugger } from "foo";
Do not allow overwritting of primitive types (#314) (Daniel Tschinder)
In flow it is now forbidden to overwrite the primitive types "any"
, "mixed"
, "empty"
, "bool"
, "boolean"
, "number"
, "string"
, "void"
and "null"
with your own type declaration.
Disallow import type { type a } from … (#305) (Daniel Tschinder)
The following code now correctly throws an error
import type { type a } from "foo";
Don't parse class properties without initializers when classProperties is disabled and Flow is enabled (#300) (Andrew Levine)
Ensure that you enable the classProperties
plugin in order to enable correct parsing of class properties. Prior to this version it was possible to parse them by enabling the flow
plugin but this was not intended the behaviour.
If you enable the flow plugin you can only define the type of the class properties, but not initialize them.
Fix export default async function to be FunctionDeclaration (#324) (Daniel Tschinder)
Parsing the following code now returns a FunctionDeclaration
AST node instead of FunctionExpression
.
export default async function bar() {};
Improve error message on attempt to destructure named import (#288) (Brian Ng)
Fix negative number literal typeannotations (#366) (Daniel Tschinder)
Ensure takeDecorators is called on exported class (#358) (Brian Ng)
ESTree: correctly change literals in all cases (#368) (Daniel Tschinder)
Correctly convert RestProperty to Assignable (#339) (Daniel Tschinder)
Fix #321 by allowing question marks in type params (#338) (Daniel Tschinder)
Fix #336 by correctly setting arrow-param (#337) (Daniel Tschinder)
Fix parse error when destructuring set
with default value (#317) (Brian Ng)
Fix ObjectTypeCallProperty static (#298) (Dan Harper)
Fix generator-method-with-computed-name spec (#360) (Alex Rattray)
Fix flow type-parameter-declaration test with unintended semantic (#361) (Alex Rattray)
Cleanup and splitup parser functions (#295) (Daniel Tschinder)
chore(package): update flow-bin to version 0.38.0 (#313) (greenkeeper[bot])
Call inner function instead of 1:1 copy to plugin (#294) (Daniel Tschinder)
Update eslint-config-babel to the latest version 🚀 (#299) (greenkeeper[bot])
Update eslint-config-babel to the latest version 🚀 (#293) (greenkeeper[bot])
devDeps: remove eslint-plugin-babel (#292) (Kai Cataldo)
Correct indent eslint rule config (#276) (Daniel Tschinder)
Fail tests that have expected.json and throws-option (#285) (Daniel Tschinder)
Update contributing with more test info [skip ci] (#355) (Brian Ng)
Update API documentation (#330) (Timothy Gu)
Added keywords to package.json (#323) (Dmytro)
AST spec: fix casing of RegExpLiteral
(#318) (Mathias Bynens)
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])
Allow "plugins": ["*"]
(#229) (Daniel Tschinder)
{ "plugins": ["*"] }
Will include all parser plugins instead of specifying each one individually. Useful for tools like babel-eslint, jscodeshift, and ast-explorer.
Throw error for reserved words enum
and await
(#195) (Kai Cataldo)
11.6.2.2 Future Reserved Words
Babylon will throw for more reserved words such as enum
or await
(in strict mode).
class enum {} // throws class await {} // throws in strict mode (module)
Optional names for function types and object type indexers (#197) (Gabe Levi)
So where you used to have to write
type A = (x: string, y: boolean) => number; type B = (z: string) => number; type C = { [key: string]: number };
you can now write (with flow 0.34.0)
type A = (string, boolean) => number; type B = string => number; type C = { [string]: number };
Parse flow nested array type annotations like number[][]
(#219) (Bernhard Häussner)
Supports these form now of specifying array types:
var a: number[][][][]; var b: string[][];
Correctly eat semicolon at the end of DelcareModuleExports
(#223) (Daniel Tschinder)
declare module "foo" { declare module.exports: number } declare module "foo" { declare module.exports: number; } // also allowed now
const babylon = require('babylon'); const ast = babylon.parse('var foo = "lol";');
With that test case, there was a ~95ms savings by removing the need for node to build/traverse the dependency graph.
Without bundling
With bundling
Property variance type annotations for Flow plugin (#161) (Sam Goldman)
See https://flowtype.org/docs/variance.html for more information
type T = { +p: T }; interface T { -p: T }; declare class T { +[k:K]: V }; class T { -[k:K]: V }; class C2 { +p: T = e };
Raise error on duplicate definition of proto (#183) (Moti Zilberman)
({ __proto__: 1, __proto__: 2 }) // Throws an error now
Flow: Allow class properties to be named static
(#184) (Moti Zilberman)
declare class A { static: T; }
Allow "async" as identifier for object literal property shorthand (#187) (Andrew Levine)
var foo = { async, bar };
Fix flowtype and add inType to state (#189) (Daniel Tschinder)
This improves the performance slightly (because of hidden classes)
Fix .gitattributes line ending setting (#191) (Moti Zilberman)
Increase test coverage (#175 (Moti Zilberman)
Readd missin .eslinignore for IDEs (Daniel Tschinder)
Error on missing expected.json fixture in CI (#188) (Moti Zilberman)
Add .gitattributes and .editorconfig for LF line endings (#179) (Moti Zilberman)
Fixes two tests that are failing after the merge of #172 (#177) (Moti Zilberman)
Implement import() syntax (#163) (Jordan Gensler)
This repository contains a proposal for adding a "function-like" import() module loading syntactic form to JavaScript
import(`./section-modules/${link.dataset.entryModule}.js`) .then(module => { module.loadPageInto(main); })
Add EmptyTypeAnnotation (#171) (Sam Goldman)
Just wasn't covered before.
type T = empty;
Fix crash when exporting with destructuring and sparse array (#170) (Jeroen Engels)
// was failing due to sparse array export const { foo: [ ,, qux7 ] } = bar;
Allow keyword in Flow object declaration property names with type parameters (#146) (Dan Harper)
declare class X { foobar<T>(): void; static foobar<T>(): void; }
Allow keyword in object/class property names with Flow type parameters (#145) (Dan Harper)
class Foo { delete<T>(item: T): T { return item; } }
Allow typeAnnotations for yield expressions (#174)) (Daniel Tschinder)
function *foo() { const x = (yield 5: any); }
Annotate more errors with expected token (#172)) (Moti Zilberman)
// Unexpected token, expected ; (1:6) { set 1 }
Remove kcheck (#173)) (Daniel Tschinder)
Also run flow, linting, babel tests on separate instances (add back node 0.10)
Fix crash when exporting with destructuring and sparse array (#170) (Jeroen Engels)
// was failing with `Cannot read property 'type' of null` because of null identifiers export const { foo: [ ,, qux7 ] } = bar;
Fix: Check for duplicate named exports in exported destructuring assignments (#144) (Kai Cataldo)
// `foo` has already been exported. Exported identifiers must be unique. (2:20) export function foo() {}; export const { a: [{foo}] } = bar;
Fix: Check for duplicate named exports in exported rest elements/properties (#164) (Kai Cataldo)
// `foo` has already been exported. Exported identifiers must be unique. (2:22) export const foo = 1; export const [bar, ...foo] = baz;
Fix: Allow identifier async
for default param in arrow expression (#165) (Kai Cataldo)
// this is ok now const test = ({async = true}) => {};
Babylon will now print out the token it's expecting if there's a SyntaxError
(#150) (Daniel Tschinder)
# So in the case of a missing ending curly (`}`) Module build failed: SyntaxError: Unexpected token, expected } (30:0) 28 | } 29 | > 30 | | ^
Temporary rollback for erroring on trailing comma with spread (#154) (Henry Zhu)
Add static errors for object rest (#149) (@danez)
Object rest copies the rest of properties from the right hand side obj
starting from the left to right.
let { x, y, ...z } = { x: 1, y: 2, z: 3 }; // x = 1 // y = 2 // z = { z: 3 }
SyntaxError: The rest element has to be the last element when destructuring (1:10)
> 1 | let { ...x, y, z } = { x: 1, y: 2, z: 3}; | ^ # Previous behavior: # x = { x: 1, y: 2, z: 3 } # y = 2 # z = 3
Before, this was just a more verbose way of shallow copying obj
since it doesn't actually do what you think.
SyntaxError: Cannot have multiple rest elements when destructuring (1:13)
> 1 | let { x, ...y, ...z } = { x: 1, y: 2, z: 3}; | ^ # Previous behavior: # x = 1 # y = { y: 2, z: 3 } # z = { y: 2, z: 3 }
Before y and z would just be the same value anyway so there is no reason to need to have both.
SyntaxError: A trailing comma is not permitted after the rest element (1:16)
let { x, y, ...z, } = obj;
The rationale for this is that the use case for trailing comma is that you can add something at the end without affecting the line above. Since a RestProperty always has to be the last property it doesn't make sense.
get / set are valid property names in default assignment (#142) (@jezell)
// valid function something({ set = null, get = null }) {}
// regression with duplicate export check SyntaxError: ./typography.js: `undefined` has already been exported. Exported identifiers must be unique. (22:13) 20 | 21 | export const { rhythm } = typography; > 22 | export const { TypographyStyle } = typography
Bail out for now, and make a change to account for destructuring in the next release.
Object.prototype
. @danezexport toString from './toString';
`toString` has already been exported. Exported identifiers must be unique. (1:7) > 1 | export toString from './toString'; | ^ 2 |
// Only one default export allowed per module. (2:9) export default function() {}; export { foo as default }; // Only one default export allowed per module. (2:0) export default {}; export default function() {}; // `Foo` has already been exported. Exported identifiers must be unique. (2:0) export { Foo }; export class Foo {};
// AST interface ClassProperty <: Node { type: "ClassProperty"; key: Identifier; value: Expression; computed: boolean; // added }
// with "plugins": ["classProperties"] class Foo { [x] ['y'] } class Bar { [p] [m] () {} }
static
property falling through in the declare class Flow AST (#135) @danharperdeclare class X { a: number; static b: number; // static c: number; // this was being marked as static in the AST as well }
// Used to error with: // SyntaxError: Assigning to rvalue (1:0) // Now: // Invalid left-hand side in assignment expression (1:0) 3 = 4 // Invalid left-hand side in for-in statement (1:5) for (+i in {});
this.parseMaybeAssign
with correct arguments (#133) @danezWe plan to include some spec compliance bugs in patch versions. An example was the multiple default exports issue.
It is a Syntax Error if ContainsUseStrict of FunctionBody is true and IsSimpleParameterList of FormalParameters is false. https://tc39.github.io/ecma262/2016/#sec-function-definitions-static-semantics-early-errors
More Context: tc39-notes
For example:
// this errors because it uses destructuring and default parameters // in a function with a "use strict" directive function a([ option1, option2 ] = []) { "use strict"; }
The solution would be to use a top level "use strict" or to remove the destructuring or default parameters when using a function + "use strict" or to.
Added to flow in https://github.com/facebook/flow/commit/c710c40aa2a115435098d6c0dfeaadb023cd39b8
Looks like:
var a : {| x: number, y: string |} = { x: 0, y: 'foo' };
typeParameter
location in ArrowFunctionExpression
(#126) (Daniel Tschinder)The only change is to remove the babel-runtime
dependency by compiling with Babel's ES2015 loose mode. So using babylon standalone should be smaller.
This release contains mainly small bugfixes but also updates babylons default mode to es2017. The features for exponentiationOperator
, asyncFunctions
and trailingFunctionCommas
which previously needed to be activated via plugin are now enabled by default and the plugins are now no-ops.
(Be aware that React is not going to support this syntax)
<div> {...todos.map(todo => <Todo key={todo.id} todo={todo}/>)} </div>
declare module "foo" { declare module.exports: {} }
function* it() { yield <a></a>; }
(#31) @eldereal(...props): void => {}
(#10) @danez(arg?) => {}
(#19) @danezget
or set
class foo { get() {} }
(#55) @vkurchatkin<T>(x: T): T => x;
(#54) @gabelevitype Foo<T = string> = T
*
is not a valid type parameter.*
is a primary typeTypeParameter
nodesTypeParameter
AST Node (replaces using the Identifier
node before)interface TypeParameter <: Node { bound: TypeAnnotation; default: TypeAnnotation; name: string; variance: "plus" | "minus"; }
Method Parameter Decorators is now a TC39 stage 0 proposal.
Examples:
class Foo { constructor(@foo() x, @bar({ a: 123 }) @baz() y) {} } export default function func(@foo() x, @bar({ a: 123 }) @baz() y) {} var obj = { method(@foo() x, @bar({ a: 123 }) @baz() y) {} };
asyncGenerators
plugin) (#17)There is also a new node type, ForAwaitStatement
.
Async generators and for-await are now a stage 2 proposal.
Example:
async function f() { for await (let x of y); }