JSDoc - 稍后定义的 object 属性的文档

Question

如何记录 object 属性/方法，当此属性/方法稍后添加到 object后，在 object 已初始化后？

例子：

假设我声明了以下 object。 ID和name的文档工作正常：

let AppUser = {
   /** The user's id */
   ID: 0,
   /** The user's name */
   name: "guest",
};

后来，我决定添加一个属性（假设在另一个 js 文件中）：

/** The role of the AppUser */
App.role = "admin";

在这种情况下， App.role的文档不起作用。 至少，VSCode 不会打开工具提示来通知我它的描述。

我现在要做的是在 object: role:null,并编写它的文档。 此解决方法工作正常。

Answer 1

为了使它工作，object 的定义应该有点不同。 类似于以下内容：

一个.js

const AppUser = {}

AppUser.ID = 0
AppUser.name = 'guest'

b.js

AppUser.role = 'admin'

c.js