¿Cómo documentar una propiedad/método de objeto, cuando esta propiedad/método se agrega al objeto más tarde , después de que el objeto se haya inicializado?
Ejemplo:
Digamos que declaro el siguiente objeto. Documentación de ID y name funcionan bien:
let AppUser = { /** The user's id */ ID: 0, /** The user's name */ name: "guest", };Luego, decido agregar una propiedad (digamos en otro archivo js):
/** The role of the AppUser */ App.role = "admin"; En ese caso, la documentación de App.role no funciona. Al menos, VSCode no abre la información sobre herramientas para informarme sobre su descripción.
Lo que hago ahora es declarar una propiedad vacía dentro del objeto: role:null, y también escribir su documentación. Esta solución funciona bien.