microsoft / microsoft/TypeScript
Cannot specify a JSDoc `@overload` signature using the `@type` tag
Aperta
Nessuno ha ancora preso questa issue.
Awaiting More Feedback
checkJs
Domain: JavaScript
Domain: JSDoc
Suggestion
- Lingua principale
- Go
- Stelle
- 111k
- Fork
- 14.4k
- Merge medio
- 1g 19h
- PR unite (30g)
- 117
Descrizione
Often, I use @type because the @param + @return syntax is so unwieldy; however, it's not usable with @overload.
// @ts-check
/**
* @overload
* @type {(x: number) => number}
*/
/**
* @type {(x: number) => number}
*/
function id(x) {
return x;
}
id(123).toFixed(2);
// ~~~ Expected 0 arguments, but got 1.
I'd expect the above not to error; but it does.
Guida per i contributori
Apri la guida per i contributori
Come iniziare
- Leggi tutta la issue e poi la guida ai contributi del progetto.
- Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
- Fai un fork del repository e lavora su un branch.
- Apri una pull request che faccia riferimento al numero della issue.
Direzione di ricerca
Inizia riproducendo l’esempio JavaScript minimo con @ts-check e i tag JSDoc @overload e @type associati. Segui il modo in cui il type checker gestisce le dichiarazioni @overload usando @type, quindi verifica che id(123).toFixed(2) non segnali più un errore nel numero di argomenti.
Scritto dal modello di indicizzazione a partire dal testo della issue.
Valutazione
- Stack tecnologico
- javascript, typescript
- Ambito
- compilers
- Tipo di issue
- Bug
- Difficoltà
- 4/5
- Tempo stimato
- 3-5 giorni
- Stato di attività
- Ferma
- Chiarezza
- Abbastanza chiara
- Idoneità per principianti
- 42/100