Cómo hacer esto ahora se describe en la documentación de JSDoc, y usa puntos suspensivos como lo hacen los documentos de Closure.
@param {...<type>} <argName> <Argument description>
Debe proporcionar un tipo para ir después de los puntos suspensivos, pero puede usar a *
para describir la aceptación de cualquier cosa o usar |
para separar varios tipos aceptables. En la documentación generada, JSDoc describirá este argumento como repetible , de la misma manera que describe los argumentos opcionales como opcionales .
En mis pruebas no hubo necesidad de tener un argumento en la definición de la función javascript real, por lo que su código real puede tener paréntesis vacíos, es decir function whatever() { ... }
.
Tipo único:
@param {...number} terms Terms to multiply together
Cualquier tipo (en el ejemplo siguiente, los corchetes significan items
que se etiquetará como opcional y repetible):
@param {...*} [items] - zero or more items to log.
Varios tipos necesitan paréntesis alrededor de la lista de tipos, con puntos suspensivos antes del par de apertura:
@param {...(Person|string)} attendees - Meeting attendees, listed as either
String names or {@link Person} objects