microsoft / microsoft/TypeScript
JSDoc multi-line properties within Array<Object> syntax parse differently than Object[]
Dieses Issue hat noch niemand übernommen.
- Vorherrschende Sprache
- Go
- Sterne
- 111k
- Forks
- 14.3k
- Ø Merge
- 1 T. 19 Std.
- Gemergte PRs (30 T.)
- 117
Beschreibung
TypeScript Version: 3.5.0-dev.20190416
Search Terms:
JSDoc @type @param @arg multi-line type literal Array<>
Code
/**
* @param {Array<Object>} os - has a string and a number
* @param {string} os[].s - the string
* @param {number} os[].n - the number
*/
function f(os) { return os[0].s; }
Expected behavior:
It appears that #17352 implemented this correctly for when the first @param is @param {Object[]} but failed to consider the other syntax to write this in JSDoc: @param {Array<Object>}.
For ease of debugging I am looking at the output of Intellisense when hovering over os in the function. I'd expect the output to look as iti does when @param {Object[]} is used:

Actual behavior:

Playground Link:
Playground Link
Related Issues:
#11597
Beitragsleitfaden
Erste Schritte
- Lies das ganze Issue und danach den Beitragsleitfaden des Projekts.
- Schreib ins Issue, dass du es übernimmst — das erspart doppelte Arbeit.
- Forke das Repository und arbeite in einem Branch.
- Öffne einen Pull Request, der die Issue-Nummer nennt.
Rechercherichtung
Beginne mit der verknüpften Playground-Reproduktion und vergleiche die beim Überfahren angezeigten Informationen für Array<Object> mit der entsprechenden Syntax Object[]. Lies das in #17352 beschriebene Verhalten und vergleiche das zugehörige Issue #11597; abgeschlossen ist die Aufgabe, wenn beide Formen dieselben mehrzeiligen Eigenschaftsinformationen für os erzeugen.
Vom Indexierungsmodell aus dem Issue-Text verfasst.
Bewertung
- Tech-Stack
- javascript, typescript
- Bereich
- compilers
- Issue-Typ
- Bug
- Schwierigkeit
- 3/5
- Geschätzter Aufwand
- 1-2 Tage
- Aktivitätsstatus
- Veraltet
- Klarheit
- Größtenteils klar
- Anfängerfreundlichkeit
- 38/100