Wofür sind JSDoc @ type geschweifte Klammern?

Question

Das Tag JSDoc @type ermöglicht die Angabe eines Variablentyps, z. B. /** @type {Number} */. Allerdings habe ich auch /** @type Number */ ohne die geschweiften Klammern gesehen, und es scheint ebenso gültig.

Use JSDoc hat ein Beispiel sowohl mit als auch ohne die geschweiften Klammern, aber diskutiert nicht den Unterschied. Die Dokumentation Google Closure Compiler impliziert, dass alle Deklarationen geschweifte Klammern haben müssen, aber nicht angeben, was passiert, wenn sie nicht ausgeführt werden.

Sind die geschweiften Klammern wichtig? Wenn ja warum? Und wenn nicht, sollte ich sie benutzen oder nicht?

Answer 1

Meine beste Vermutung ist, dass die geschweiften Klammern für den Parser da sind, da einige Typspezifikationen Leerzeichen in ihnen haben können.

z. Ein Objekt mit String-Schlüssel und Zahlenwerten:

{Object.<string, number>} 

auf dem Parser benötigt eine einfache Art (zB string) kann nicht die geschweiften Klammern Je nach dem Parser das erste Leerzeichen als Ende der Typdeklaration lesen.

edit: Weitere Informationen deuten darauf hin, dass geschweifte Klammern erforderlich sind, daher ist es ein Fehler, sie wegzulassen, ABER einige (wenn nicht die meisten/alle) Parser verwerfen schlampige Typdefinitionen, wenn sie wie oben behandelt werden können.

tldr: Sie sind wichtig, aber Sie können wegkommen, ohne sie in einigen Fällen zu verwenden.