Che cosa sono le parentesi graffe di tipo JSDoc @type?

Question

Il tag JSDoc @type consente di specificare un tipo di variabile, ad esempio /** @type {Number} */. Tuttavia ho anche visto /** @type Number */ senza le parentesi graffe e sembra altrettanto valido.

Use JSDoc ha un esempio con e senza le parentesi graffe, ma non discute la differenza. La documentazione Google Closure Compiler implica che tutte le dichiarazioni devono avere parentesi graffe, ma non specifica cosa succede se non lo fanno.

Le parentesi graffe sono importanti? Se è così, perché? E se no, dovrei usarli o no?

Answer 1

La mia ipotesi migliore è che le parentesi graffe siano lì per il parser, in quanto alcune specifiche di tipo possono avere spazi in esse.

es. Un oggetto con chiavi stringa e valori numerici:

{Object.<string, number>} 

seconda del parser di tipo semplice (es stringa) non può avere bisogno le parentesi come il parser leggerà dal primo spazio come la fine della dichiarazione del tipo.

edit: Ulteriore lettura suggerisce che sono necessari le parentesi graffe, così omettendo loro è un errore, ma alcuni (se non la maggior parte tutti i /) parser perdoneranno definizioni sciatta tipo se possono essere trattati come sopra.

tldr: Sono importanti, ma in alcuni casi è possibile scappare senza usarli.