Esprima 3.0.5
dotnet add package Esprima --version 3.0.5
NuGet\Install-Package Esprima -Version 3.0.5
<PackageReference Include="Esprima" Version="3.0.5" />
paket add Esprima --version 3.0.5
#r "nuget: Esprima, 3.0.5"
// Install Esprima as a Cake Addin #addin nuget:?package=Esprima&version=3.0.5 // Install Esprima as a Cake Tool #tool nuget:?package=Esprima&version=3.0.5
📣 Important notices |
---|
If you are upgrading from an older version, please note that version 3 ships with numerous breaking changes to the public API because virtually all areas of the library have been revised.<br />Documentation of the previous major version is available here. |
Esprima .NET (BSD license) is a .NET port of the esprima.org project. It is a standard-compliant ECMAScript parser (also popularly known as JavaScript).
Features
- Full support for ECMAScript 2022 (ECMA-262 13th Edition)
- Support for a few upcoming (stage 3+ proposal) ECMAScript features:
- Experimental support for JSX, a syntax extension for React
- Sensible syntax tree format, which is based on the standard established by the ESTree project
- Tracking of syntax node location (index-based and line-column)
- Heavily tested
API
Esprima can be used to perform lexical analysis (tokenization) or syntactic analysis (parsing) of a JavaScript program.
A simple C# example:
var parser = new JavaScriptParser();
var program = parser.ParseScript("const answer = 42");
You can control the behavior of the parser by initializing and passing a ParserOptions
to the parser's constructor. (For the available options, see the XML documentation of the ParserOptions
class.)
Instead of ParseScript
, you may use ParseModule
or ParseExpression
to make the parser treat the input as an ES6 module or as a plain JavaScript expression respectively.
In case the input is syntactically correct, each of these methods returns the root node of the resulting abstract syntax tree (AST), which you can freely analyze or transform. The library provides the AstVisitor
and AstRewriter
visitor classes to help you with such tasks.
When the input contains a severe syntax error, a ParserException
is thrown. By catching it you can get details about the error. There are syntax errors though which can be tolerated by the parser. Such errors are ignored by default. You can record them by setting ParserOptions.ErrorHandler
to an instance of CollectingErrorHandler
. Alternatively, you can set ParserOptions.Tolerant
to false to make the parser throw exceptions also in the case of tolerable syntax errors.
The library is able to write the AST (except for comments) back to JavaScript code:
var code = program.ToJavaScriptString(format: true);
It is also possible to serialize the AST into a JSON representation:
var astJson = program.ToJsonString(indent: " ");
Considering the example above this call will return the following JSON:
{
"type": "Program",
"body": [
{
"type": "VariableDeclaration",
"declarations": [
{
"type": "VariableDeclarator",
"id": {
"type": "Identifier",
"name": "answer"
},
"init": {
"type": "Literal",
"value": 42,
"raw": "42"
}
}
],
"kind": "const"
}
],
"sourceType": "script",
"strict": false
}
Benchmarks
Here is a list of common JavaScript libraries and the time it takes to parse them, compared to the time it took for the same script using the original Esprima in Chrome.
Script | Size | Esprima .NET (.NET 6) | Esprima (Chrome 116) |
---|---|---|---|
underscore-1.5.2 | 43 KB | 1.0 ms | 1.4 ms |
backbone-1.1.0 | 59 KB | 1.2 ms | 1.6 ms |
mootools-1.4.5 | 157 KB | 5.2 ms | 7.1 ms |
jquery-1.9.1 | 262 KB | 6.6 ms | 7.9 ms |
yui-3.12.0 | 330 KB | 4.6 ms | 6.9 ms |
jquery.mobile-1.4.2 | 442 KB | 10.0 ms | 17.7 ms |
angular-1.2.5 | 702 KB | 8.5 ms | 15.1 ms |
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net5.0 was computed. net5.0-windows was computed. net6.0 was computed. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 was computed. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. |
.NET Core | netcoreapp2.0 was computed. netcoreapp2.1 was computed. netcoreapp2.2 was computed. netcoreapp3.0 was computed. netcoreapp3.1 was computed. |
.NET Standard | netstandard2.0 is compatible. netstandard2.1 is compatible. |
.NET Framework | net461 was computed. net462 is compatible. net463 was computed. net47 was computed. net471 was computed. net472 was computed. net48 was computed. net481 was computed. |
MonoAndroid | monoandroid was computed. |
MonoMac | monomac was computed. |
MonoTouch | monotouch was computed. |
Tizen | tizen40 was computed. tizen60 was computed. |
Xamarin.iOS | xamarinios was computed. |
Xamarin.Mac | xamarinmac was computed. |
Xamarin.TVOS | xamarintvos was computed. |
Xamarin.WatchOS | xamarinwatchos was computed. |
-
.NETFramework 4.6.2
- System.Memory (>= 4.5.5)
-
.NETStandard 2.0
- System.Memory (>= 4.5.5)
-
.NETStandard 2.1
- No dependencies.
NuGet packages (7)
Showing the top 5 NuGet packages that depend on Esprima:
Package | Downloads |
---|---|
PlaywrightSharp
PlaywrightSharp is a .NET library to automate Chromium, Firefox and WebKit with a single API. Playwright is built to enable cross-browser web automation that is ever-green, capable, reliable and fast. |
|
SourceMapTools
A C# library that allows for the consumption of source maps and the deminification of JavaScript stack traces. |
|
Demego.Headless.Api.Core
Package Description |
|
BlendedJint
Javascript interpreter for .NET which provides full ECMA 5.1 compliance. |
|
Drm.Core
Drm core services provides core functionality for the deployment and template operations used by the Dynamics Resource Management (DRM) Template service. Accelerate your automation of Dynamics 365 environments by compiling and deploying Drm Templates. |
GitHub repositories (4)
Showing the top 4 popular GitHub repositories that depend on Esprima:
Repository | Stars |
---|---|
openbullet/openbullet
The OpenBullet web testing application.
|
|
ape-byte/DouyinBarrageGrab
基于系统代理的抖音弹幕wss抓取程序,能够获取所有数据来源,包括chrome,抖音直播伴侣等,可进行进程过滤
|
|
FortuneN/FineCodeCoverage
Visualize unit test code coverage easily for free in Visual Studio Community Edition (and other editions too)
|
|
TeslaFly01/SmartSqlT
🔥🔥🔥 SmartSQL 是一款方便、快捷的数据库文档查询、导出工具!该工具从最初支持CHM文档格式开始,通过不断地探索开发、集思广益和不断改进,又陆续支持Word、Excel、PDF、Html、Xml、Json、MarkDown等文档格式的导出。同时支持SqlServer、MySql、PostgreSQL、SQLite等多种数据库的文档查询和导出功能。
|
Version | Downloads | Last updated |
---|---|---|
3.0.5 | 443,917 | 4/9/2024 |
3.0.4 | 483,389 | 12/31/2023 |
3.0.3 | 496 | 12/30/2023 |
3.0.2 | 133,347 | 11/4/2023 |
3.0.1 | 191,499 | 9/10/2023 |
3.0.0 | 1,010 | 9/3/2023 |
2.1.3 | 317,518 | 3/8/2022 |
2.1.2 | 348,711 | 1/2/2022 |
2.1.1 | 844 | 1/1/2022 |
2.1.0 | 2,268 | 12/20/2021 |
2.0.5 | 14,282 | 12/15/2021 |
2.0.4 | 2,357,441 | 12/1/2021 |
2.0.3 | 229,820 | 8/30/2021 |
2.0.2 | 98,107 | 7/18/2021 |
2.0.1 | 959 | 7/11/2021 |
2.0.0 | 575,515 | 5/19/2021 |
1.0.1270 | 530,289 | 3/10/2020 |
1.0.1258 | 56,674 | 2/28/2020 |
1.0.1251 | 227,413 | 10/26/2019 |
1.0.1246 | 149,830 | 10/16/2019 |