https://github.com/jquery/esprima

ECMAScript parsing infrastructure for multipurpose analysis
https://github.com/jquery/esprima

ast ecmascript esprima javascript parser parsing

Last synced: 12 days ago
JSON representation

ECMAScript parsing infrastructure for multipurpose analysis

• Host: GitHub
• URL: https://github.com/jquery/esprima
• Owner: jquery
• License: bsd-2-clause
• Created: 2011-11-23T05:36:43.000Z (over 13 years ago)
• Default Branch: main
• Last Pushed: 2023-04-16T01:17:08.000Z (about 2 years ago)
• Last Synced: 2025-04-01T05:37:15.385Z (19 days ago)
• Topics: ast, ecmascript, esprima, javascript, parser, parsing
• Language: TypeScript
• Homepage: http://esprima.org
• Size: 57.3 MB
• Stars: 7,091
• Watchers: 146
• Forks: 781
• Open Issues: 148
• Metadata Files:
  • Readme: README.md
  • Changelog: ChangeLog
  • Contributing: CONTRIBUTING.md
  • License: LICENSE.BSD

Awesome Lists containing this project

• awesome-indo-projects - Esprima - ECMAScript parsing infrastructure for multipurpose analysis. (JavaScript)
• awesome-nodejs - esprima - High performance, standard-compliant ECMAScript parser.  (Repository / AST)
• awesome-github-repos - jquery/esprima - ECMAScript parsing infrastructure for multipurpose analysis (TypeScript)
• awesome-github-star - esprima
• awesome-list - esprima
• awesome-indonesia-repo - Esprima - ECMAScript parsing infrastructure for multipurpose analysis. (JavaScript)
• awesome-ast - Esprima
• awesome-vietnam-repo - Esprima - ECMAScript parsing infrastructure for multipurpose analysis. (JavaScript)

README

        
[![NPM version](https://img.shields.io/npm/v/esprima.svg)](https://www.npmjs.com/package/esprima)

[![npm download](https://img.shields.io/npm/dm/esprima.svg)](https://www.npmjs.com/package/esprima)

[![Tests](https://github.com/jquery/esprima/workflows/Tests/badge.svg)](https://github.com/jquery/esprima/actions)

[![Coverage Status](https://img.shields.io/codecov/c/github/jquery/esprima/master.svg)](https://codecov.io/github/jquery/esprima)

**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/jquery/esprima/contributors).

### Features

- Full support for ECMAScript 2019 ([ECMA-262 10th 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

> var esprima = require('esprima');

> 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).