我是JSDoc的新手,我正在尝试Webstorm,所以我也是webstorm的新手.

 

我一方面用这种方式声明了一个接口：

 

/**  @interface */
function IInterface(){}
IInterface.prototype.myMethod = function(){};

另一方面,我正在开发一个模块,我正在实现这个接口：

 

window.exports.MyImplementation =  (function(){
    "use strict";

    /**
     *
     * @constructor
     * @implements {IInterface}
     */
    function MyImplementation(){}
    MyImplementation.prototype.myMethod = function(){
        // my implementation here
    };

    return MyImplementation;
})();

我遇到的问题是显然无法识别实现：

但是,如果我删除window.exports.MyImplementation分配或返回语句,则不再有警告……

..但我确实希望从我的模块返回并存储我的类型！

我有什么遗漏或做错了吗？……

编辑：

只是为了给我的问题带来更多困惑,
我正在考虑使用“完整注释”界面声明(如果有可能,我在这里试验……)：

…但在这种情况下,您可以注意到“I”符号已从左侧消失,如果方法未实现,我没有任何警告.
但是类型IInterface被识别.

编辑：
我想我在尝试jsDoc的其他东西时只是理解了一些东西.
抛出警告是因为对window.exports.MyImplementation进行了实现检查.但是在代码中没有直接赋值实现此对象.
这就是我删除return语句或“exports.MyImplementation”赋值时禁用警告的原因.

..因此,不确定这可能被视为一个错误,这可能是我用于我的模块的模式与WebStorm预期的模式不匹配,也可能是JSdoc本身……
如果有JSDoc和Webstorm经验的人可以确认…..

另一个编辑：
(我认为理解JSDoc的重要一步)

注释已经移动到目标字段和… tadaaa(注意“I”仍然在这里表明接口确实正在实现).

我的解释：
可能有一个逻辑……但老实说我真的不知道它是否相关：因为文档化的字段将在最后的“exports.MyImplementation”中导出,这很明显注释更多这里比在私人机柜中有用. WebStorm已检测到导出为“exports.MyImplementation”,因此正在等待其上的文档…

是否有意义？…

另一个编辑(再次)
调查,调查.

我找到了一个完全不同的解决方案,允许文档,完成,验证和没有警告,这似乎是一个更好的模块导出解决方案：