JSDoc

JSDoc es una sintaxis para agregar documentación de la API al código fuente de JavaScript.

La sintaxis JSDoc es similar a la sintaxis de Javadoc, usado para documentar el código de Java, pero se ha especializado para trabajar con la sintaxis de JavaScript, es más dinámico y, por tanto único, ya que no es totalmente compatible con Javadoc. Sin embargo, como Javadoc, JSDoc permite al programador crear Doclets y Taglets que luego se pueden traducir en formatos como HTML o RTF.

Etiquetas JSDoc

EtiquetaDescripción
@authorNombre del autor.
@constructorIndica el constructor.
@deprecatedIndica que ese método es obsoleto.
@exceptionSinónimo de @throws.
@paramParámetros de documentos y métodos.
@privateIndica que el método es privado.
@returnIndica qué devuelve el método.
@seeIndica la asociación con otro objeto.
@throwsIndica la excepción que puede lanzar un método.
@versionIndica el número de versión o librería.

Enlaces externos

Página oficial (inglés)

Este artículo ha sido escrito por Wikipedia. El texto está disponible bajo la licencia Creative Commons - Atribución - CompartirIgual. Pueden aplicarse cláusulas adicionales a los archivos multimedia.