如何使用JSDoc3记录嵌套命名空间

Question

我使用JSDoc3来记录这种结构的代码时遇到了麻烦

/**
 * @namespace MyNamespace.MySubNamespace
 */

(function (MyNamespace) {
    MyNamespace.MySubNamespace.Foo = {
        doSomething: function (someParam) {
            // doing it
        }
    }
})(window.MyNamespace)

我该如何使用JSDoc3来记录MyNamespace包含MySubNamespace，而MySubNamespace又包含Foo？此外，我该如何将doSomething与Foo关联，并记录其参数someParam？

我的限制是我不能向声明MyNamespace和MySubNamespace的文件添加文档。

非常感谢！

- Julian A.

Answer 1

搞定了，希望这个解决方案能帮到其他人。

/**
 * @namespace MyNamespace.MySubNamespace
 */

 (function (MyNamespace) {
     /**
      * Foo namespace
      * @namespace Foo
      * @memberOf MyNamespace.MySubNamespace
      */ 
     var Foo = {
         /**
          * Does something.
          * @memberOf MyNamespace.MySubNamespace.Foo
          * @param {object} someParam Some parameter.
          */
         doSomething: function (someParam) {
             // doing it
         }
     };
     MyNamespace.MySubNamespace.Foo = Foo;
 })(window.MyNamespace)    

- Julian A.

---

这仍然有助于（在2022年），当尝试将模块添加到命名空间时。 - lys