叉线信息
这回贷被扣了,因为我们需要加注 这个 修补 我们将出版 释放 npm 地产登记册上的分支
埃斯布雷语Name
Espree最初是作为一个叉子 埃斯皮里亚 v1.2.2,Esprima在ECMAScript 6工作开始前发布的最后一张平面版. 埃斯普雷现在建在 橡子,它有一个模块化架构,允许扩展核心功能. 埃斯普雷的目标是生产出与埃斯普里马相类似的输出,具有相近的API,从而可以被用来代替埃斯普里马.
使用量
安装 :
npm i espree --save
在你的节点代码里:
var espree = require("espree");
var ast = espree.parse(code);
还有一个理由: parse() 可以指定各种选项:
var espree = require("espree");
var ast = espree.parse(code, {
// attach range information to each node
range: true,
// attach line/column location information to each node
loc: true,
// create a top-level comments array containing all comments
comment: true,
// attach comments to the closest relevant node as leadingComments and
// trailingComments
attachComment: true,
// create a top-level tokens array containing all tokens
tokens: true,
// specify the language version (3, 5, 6, or 7, default is 5)
ecmaVersion: 5,
// specify which type of script you're parsing (script or module, default is script)
sourceType: "script",
// specify additional language features
ecmaFeatures: {
// enable JSX parsing
jsx: true,
// enable return in global scope
globalReturn: true,
// enable implied strict mode (if ecmaVersion >= 5)
impliedStrict: true,
// allow experimental object rest/spread
experimentalObjectRestSpread: true
}
});
Esprima 相容性前进
首要目标是制作与Esprima完全相同的AST结构和道具,这优先于其他任何东西. (AST结构是 爱沙尼亚 API与JSX扩展. ) 除此以外,Espree还可能偏离Esprima在评论的附后位置和方式以及AST节点上有哪些补充信息。 也就是说,Espree在AST节点上添加的东西可能比Esprima多,但生产的整体AST结构会是一样的.
Espree也可能在其暴露的界面中偏离Esprima.
捐款
问题和拉动请求将分出三分,并尽快作出回应。 我们是在 ESLint 贡献者准则所以请在投稿前读一下 如果你不知道在哪里挖,检查一下 问题。 。 。 .
Espree根据允许的BSD 2 Clause许可证获得许可证.
构建命令
npm test- 运行所有的衬衣和测试npm run lint- 运行所有林丁npm run browserify- 创建可用于浏览器的 Espree 版本
与Espree 2.x的差别
- 这个
tokenize()方法不使用ecmaFeatures。任何字符串都将完全根据ECMAScript 6语义来表示. - 轨迹白地空间不再作为节点的一部分被计算.
let财务报告和审定财务报表const声明不再被默认解析。 您必须选择使用ecmaFeatures.blockBindings。 。 。 .- 这个
esparse财务报告和审定财务报表esvalidate二进制脚本已删除 . - 没有
tolerant选项。 以后我们再调查一下.
已知的不兼容性
为了帮助那些希望从其他参赛者向埃斯普雷过渡的人,下面列出了与其他参赛者明显的不相容之处. 我们不打算改变这些已知的分歧.
埃斯布里玛 1.2.2
- Esprima计算出后面的白空间作为每个AST节点的一部分,而Espree则没有. 在埃斯普雷,一个节点的终点是最后一个标志发生的地方.
- Espree 不分析
let财务报告和审定财务报表const默认声明. - 为解析错误而返回的错误消息是不同的 .
- 每个节点和信使上都有两个附加属性:
start财务报告和审定财务报表end。这些数据与range并被橡树内部使用.
埃斯布里玛 2.x
- Esprima 2.x使用不同的注释附件算法,导致一些注释被添加到与Espree不同的地方. Espree使用的算法与Esprima 1.2.2中使用的算法相同.
经常被问到的问题
为何还要再分析一下
ESLint 语录 从一开始就一直依赖埃斯普里玛作为它的解析者。 虽然在JavaScript语言缓慢地发展时这一点很好,但发展速度却急剧加快,而Esprima已经落后了. ESLint与许多其他依赖于Esprima的工具一样,一直被卡住在使用新的JavaScript语言功能上直到Esprima更新,这引起了我们的用户的挫折.
我们决定了我们前进的唯一方式是创建自己的解析器,使我们与JSHint和JSLint保持一致,并允许我们继续落实我们需要的新特征。 我们选择了用叉子Esprima而不是从零开始,以便尽快用相容的API移动.
与 Espree 2.0.0 相比,我们不再是 Esprima 的分叉,而是一个从 Acorn 到 Esprima 语法之间的翻译层. 这样,我们就可以将工作重新纳入一个社区支持的橡树园(Acorn),它正在继续成长和发展,同时为那些仍在埃斯普里马建造的公用事业维持一个与埃斯普里马兼容的园林园.
你试过和埃斯普里玛合作吗?
对 从ESLint开始,我们经常向Esprima提交错误和特征请求,并将继续这样做. 然而,在项目如何运作的问题上有一些不同的哲学观点需要通过. 最初的目标是让Espree track Esprima,并最终将两者合并为一并,但我们最终决定,由于Acorn的插件支持,在Acorn上方建设是一个更好的选择.
你为什么不用橡子?
Acorn是一款伟大的JavaScript parser,它生产出一个兼容Esprima的AST. 不幸的是,ESLint不仅仅依靠AST来完成任务. 它依靠Esprima的符和注释附件特性来获得源代码的完整图片. 我们调查了切换到Acorn的情况,但是Esprima和Acorn之间的不一致为ESLint这样的项目创造了太多的工作.
然而,我们正在橡树顶上建设,这样我们才能作出贡献,帮助使橡树变得更好.
你支持什么ECMAScript 6 特性?
所有诸相.
你支持什么ECMAScript 7 特性?
只有一个ECMAScript 7的语法变化: exproventation操作器. Espree支持这一点.
你如何确定哪些实验特征可以支持?
一般来说,我们不支持实验性的JavaScript特性. 我们可以不时根据特征的成熟程度做出例外.