在 ECMAScript 上使用扩展语法的 JSDoc答案

【问题标题】：Using JSDoc on ECMAScript with extended syntax在 ECMAScript 上使用扩展语法的 JSDoc
【发布时间】：2013-04-11 02:26:48
【问题描述】：

谁能告诉我是否可以在 JavaScript（更像 ECMAScript）上使用带有一些附加功能的 JSDoc？例如，我有这样的代码：

function(a : String, b : Number) : Object {
    // do some stuff here
}

正如您所见，它几乎是 JavaScript，但可以指定参数类型和返回值。那么我可以在这种语法上以某种方式使用 JSDoc 吗？有什么方法可以为它编写某种插件吗？

谢谢。

【问题讨论】：

你的东西看起来很像 Typescript，它已经支持 JSDoc。

标签： javascript jsdoc

【解决方案1】：

对不起，我之前在打电话，我现在可以更详细地回答。

首先，我认为您将 JSDoc 与其实现混淆了。 JSDoc 只是人们记录 Javascript 代码的标准方式。它本身不是一个程序，它不做任何事情。现在，有些程序知道 JSDoc 并基于它提供某些功能。例如，IDE 可能会在将鼠标悬停在方法上时显示 JSDoc。因此，如果您愿意，您可以在任何您想要的地方使用 JSDoc，包括在不同语言的代码中。但是，如果您希望利用 JSDoc 的程序来识别它，那就有点问题了。

我非常怀疑当前的任何 JSDoc 程序是否会识别除严格 Javascript 之外的任何语言的格式。我下载了 jsdoc-toolkit，这绝对是正确的，而且可能对大多数人来说都是正确的。如果您真的需要 JSDoc 来处理该代码，您可能必须自己编写某种程序（或编辑程序）。除非这个 ECMAScript 的超集是一种通用语言，否则可能会有一个程序存在。

【讨论】：