TypeScript Document and/or deprecate Node's getFullStart() vs. pos?

pkln4tw6  于 4个月前  发布在  TypeScript
关注(0)|答案(1)|浏览(42)

确认

  • 我确认使用此模板可能在维护者的酌情决定下不经进一步解释而关闭问题。

评论

typescript-eslint/typescript-eslint#8227 转换到 https://discord.com/channels/508357248330760243/640177429775777792/1194002057858916483 :看起来 ts.Node 对象既有一个 pos: number 属性,也有一个直接返回 this.posgetFullStart(): number 方法:
TypeScript/src/services/services.ts
第564行至第566行在 02f9ddf
| | publicgetFullStart(): number{ |
| | returnthis.pos; |
| | } |
在VS Code中对接口定义进行快速查找 所有引用 :

  • Node 's getFullStart() 有25个结果
  • ReadonlyTextRange s readonly pos 有407个结果

我查看了GitHub仓库和代码历史,但找不到任何证明为什么两者都存在的原因。我的猜测是,#9529(添加了 getFullStart())早于TS 2.0的 readonly(TS 2.0发布说明 > 只读)。
考虑到 getFullStart() 需要额外的函数调用,除了向后兼容之外,还有其他原因保留它吗?如果没有,团队是否愿意在JSDoc中将其标记为 @deprecated 以减少歧义?

r6hnlfcb

r6hnlfcb1#

没有人能记住关于这个的任何事情。让我们尝试一个PR来废弃它,并用 pos 替换剩余的使用。

相关问题