Segun el siguiente enlace encontrado en stackoverflow en inglés:
what do @private, @public, @class and @param mean in JS
Se nos explica que estos parametros que usan el caracter @
enrealidad no es código que lee javascript, si no que hace parte del formato de documentación que usan los editores de codigo, por ejemplo en visual studio code, cuando nosotros ponemos el cursor encima de alguna función originaria de javascript, podemos ver ciertos datos descritos de manera especial:
Asi que enrealidad esto no es código ejecutable de javascript ni un nuevo paradigma ni algo nuevo de javascript, esto simplemente hace parte de la documentación, donde para poder definir documentacion deberemos usar la siguiente notación:
/**Aqui la descripcion de la documentacion...*/
function js(){
}
Nótese que al inicio deben ir dos asteriscos juntos en vez de uno solo (**), puesto que si no, no estaríamos definiendo documentación, si no simples comentarios, comentarios que no se veran en el infoarea de VSCode
.
El resultado de esto:
/**Aqui la descripcion de la documentacion...*/
function js(){
}
Es que si pones el cursor encima de nuestra nueva función por un rato, visual studio code te mostrara la descripción o documentación que pusiste en una pequeña ventana.
Y puedes usar los decoradores @
junto con ciertas palabras reservadas para "decorar" tu documentación.
Esto es aplicable también a los IDE
de java solo que ellos usan sus propios decoradores, así que en eclipse
o en netbeans
tambien puedes tener este tipo de documentación personalizada haciendo uso del formato /** */
.
También adjunto los siguientes enlaces o recursos para una mayor comprensión del tema:
Decorators
proposal-decorators