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