https://github.com/node-projects/esprima-next
fork of esprima, with full ES2022 support
https://github.com/node-projects/esprima-next
Last synced: 5 months ago
JSON representation
fork of esprima, with full ES2022 support
- Host: GitHub
- URL: https://github.com/node-projects/esprima-next
- Owner: node-projects
- License: bsd-2-clause
- Created: 2021-06-14T21:18:21.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2024-03-13T09:33:08.000Z (about 1 year ago)
- Last Synced: 2024-12-11T06:44:58.121Z (5 months ago)
- Language: TypeScript
- Homepage:
- Size: 55.4 MB
- Stars: 16
- Watchers: 5
- Forks: 1
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- Changelog: ChangeLog
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE.BSD
Awesome Lists containing this project
README
[](https://www.npmjs.com/package/esprima-next)
[](https://www.npmjs.com/package/esprima-next)
[](https://github.com/node-projects/esprima-next/actions)
Todo: Coverage does not work atm.
[](https://codecov.io/github/node-projects/esprima-next)
**Esprima** ([esprima.org](http://esprima.org), BSD license) is a high performance,
standard-compliant [ECMAScript](http://www.ecma-international.org/publications/standards/Ecma-262.htm)
parser written in ECMAScript (also popularly known as
[JavaScript](https://en.wikipedia.org/wiki/JavaScript)).
Esprima is created and maintained by [Ariya Hidayat](https://twitter.com/ariyahidayat),
with the help of [many contributors](https://github.com/node-projects/esprima-next/contributors).
### esprima-next
A fork of esprima (https://github.com/jquery/esprima), cause esprima has no new releases and many not merged pull req.
if development/maintenance at jquery will start again, we maybe remove this fork.
### Changes to original Esprima:
- Rename to esprima-next
- generate a ESM build
- update npm packages
- disable npm run static-analysis && npm run dynamic-analysis, seem not to work after package update
- we don't need to support node <= 12
- ES2022 Class Properties & Privates
- Support numeric seperator and BigInt
- import assertions
following Pull reqs are merged from @esprima github:
- Export Esrpima Nodes type #2045
- Fix super() in non derived class #2047
- Support for ES2020 import.meta #2052
- Support for ES2020 export ns from #2055
- Fix parsing error in exponent expressions with unary left-hand sides. #2070
- bugfix import() #2076
- Support ES2021 Logical Assignment #2082
- ESM release support #2081
### Features
- Full support for ECMAScript 2022 ([ECMA-262 13th Edition](http://www.ecma-international.org/publications/standards/Ecma-262.htm))
- Sensible [syntax tree format](https://github.com/estree/estree/blob/master/es5.md) as standardized by [ESTree project](https://github.com/estree/estree)
- Experimental support for [JSX](https://facebook.github.io/jsx/), a syntax extension for [React](https://facebook.github.io/react/)
- Optional tracking of syntax node location (index-based and line-column)
- [Heavily tested](http://esprima.org/test/ci.html) (~1600 [unit tests](https://github.com/jquery/esprima/tree/master/test/fixtures) with [full code coverage](https://codecov.io/github/jquery/esprima))
### API
Esprima can be used to perform [lexical analysis](https://en.wikipedia.org/wiki/Lexical_analysis) (tokenization) or [syntactic analysis](https://en.wikipedia.org/wiki/Parsing) (parsing) of a JavaScript program.
A simple example on Node.js REPL:
```javascript
> import { esprima } from 'esprima-next';
> var program = 'const answer = 42';
> esprima.tokenize(program);
[ { type: 'Keyword', value: 'const' },
{ type: 'Identifier', value: 'answer' },
{ type: 'Punctuator', value: '=' },
{ type: 'Numeric', value: '42' } ]
> esprima.parseScript(program);
{ type: 'Program',
body:
[ { type: 'VariableDeclaration',
declarations: [Object],
kind: 'const' } ],
sourceType: 'script' }
```
For more information, please read the [complete documentation](http://esprima.org/doc).