Annotazioni di tipo JSDoc come collegamento
Aggiunga i tipi ai file JS con JSDoc prima della conversione.
Annotazioni di tipo JSDoc come collegamento è una lezione TypeScript Academy gratuita su CoddyKit. Questa è la lezione 2 di 4. Puoi leggere la lezione completa qui gratuitamente — poi esercitati direttamente nel browser con un editor di codice integrato e un tutor IA disponibile 24/7. Fa parte del percorso di apprendimento TypeScript Academy, e i tuoi progressi si sincronizzano tra il web e l'app CoddyKit. Il corso TypeScript Academy include 4 lezioni in totale.
JSDoc come ponte verso TypeScript
TypeScript può leggere le annotazioni di tipo JSDoc nei file JavaScript quando checkJs: true è abilitato. In questo modo può aggiungere i tipi al codice JS senza rinominare i file.
/** @type {string} */
let name = "Alice"; // TypeScript checks this as string@param e @returns
Annoti i parametri delle funzioni e i tipi restituiti usando i tag JSDoc.
/**
* @param {string} name
* @param {number} age
* @returns {string}
*/
function greet(name, age) {
return `${name} is ${age}`;
}@typedef per i tipi oggetto
Usi @typedef per definire alias di tipo riutilizzabili in JSDoc.
/**
* @typedef {Object} User
* @property {string} id
* @property {string} name
* @property {boolean} isActive
*/
/** @type {User} */
const user = { id: "1", name: "Alice", isActive: true };@template per i generics
Usi @template per scrivere funzioni generiche in JSDoc.
/**
* @template T
* @param {T[]} arr
* @returns {T | undefined}
*/
function first(arr) {
return arr[0];
}
// TypeScript infers: first<T>(arr: T[]): T | undefinedImportare i tipi dai file .ts
JSDoc supporta @type {import("./types").User} per importare i tipi TypeScript nei file JS.
/** @type {import("./types").User} */
const admin = { id: "admin", name: "Admin", isActive: true };@ts-check per il controllo dei singoli file
Aggiunga // @ts-check all'inizio di un file JS per abilitare il controllo di TypeScript solo per quel file, senza attivare globalmente checkJs: true.
// @ts-check
/** @type {number} */
const count = "oops"; // Error: string not assignable to number@ts-ignore e @ts-expect-error
Sopprima specifici errori di tipo JSDoc con direttive inline, senza disabilitare il controllo per l'intero file.
// @ts-ignore
const x = badFunction(); // single error suppressed
// @ts-expect-error
const y = anotherBad(); // error expected hereEnum in JSDoc
Simuli gli enum di TypeScript in JSDoc usando @enum.
/** @enum {string} */
const Direction = { Left: "left", Right: "right", Up: "up" };Asserzioni di tipo in JSDoc
Usi /** @type {SomeType} */ (expression) per le asserzioni di tipo JSDoc, equivalenti a as SomeType di TypeScript.
const el = /** @type {HTMLInputElement} */ (document.getElementById("input"));
el.value; // el: HTMLInputElement — typedQuando passare a .ts
Le annotazioni JSDoc sono un ponte, non il punto di arrivo. Quando un file è completamente annotato e stabile, lo rinomini in .ts e rimuova i commenti di tipo JSDoc a favore della sintassi nativa di TypeScript.
// Rename: utils.js → utils.ts
// Replace JSDoc: /** @param {string} x */ → (x: string)Riepilogo: JSDoc come ponte
Le annotazioni di tipo JSDoc abilitano il controllo di TypeScript nei file JS senza rinominarli. Usi @type, @param, @typedef e @template per aggiungere gradualmente la sicurezza dei tipi prima di convertire i file in TypeScript nativo.
Verifica rapida
Quale tag JSDoc abilita il controllo di TypeScript in un singolo file senza checkJs globale?
Cosa ha imparato
Le annotazioni di tipo JSDoc fanno da ponte tra JavaScript e TypeScript: usi @type, @param, @typedef e @template per aggiungere i tipi ai file JS. Abiliti il controllo per singolo file con // @ts-check, quindi converta il file in TypeScript nativo quando è pronto.
Impara TypeScript con un tutor IA — gratis
Scrivi ed esegui vero codice nel tuo browser, ricevi aiuto istantaneo da un tutor IA disponibile 24/7, e riprendi da dove hai lasciato sul web o nell'app.
- Corsi
- 101
- Lezioni
- 352
Domande Frequenti
La lezione «Annotazioni di tipo JSDoc come collegamento» è gratuita?
Sì — il testo completo di «Annotazioni di tipo JSDoc come collegamento» è gratuito qui sul web. Per esercitarvi in modo interattivo (un editor di codice integrato e un tutor IA 24/7) e sbloccare il resto del corso TypeScript Academy, passa a CoddyKit PRO. Il corso TypeScript Academy include 4 lezioni in totale.
Cosa imparerò in «Annotazioni di tipo JSDoc come collegamento»?
Aggiunga i tipi ai file JS con JSDoc prima della conversione. Eserciti TypeScript Academy con codice pratico che esegui direttamente nel browser, e un tutor IA 24/7 risponde alle tue domande mentre lavori sulla lezione.
Ho bisogno di esperienza per iniziare TypeScript Academy?
Non è richiesta alcuna esperienza precedente. TypeScript Academy su CoddyKit è strutturato per principianti e studenti avanzati, quindi puoi iniziare da qui o dall'inizio e procedere al tuo ritmo. Questa è la lezione 2 di 4.
Quanto tempo richiede la lezione «Annotazioni di tipo JSDoc come collegamento»?
La maggior parte delle lezioni CoddyKit richiede circa 5–10 minuti. Ogni lezione è breve e interattiva, quindi fai progressi costanti e riprendi esattamente da dove hai lasciato su web e app.
Posso scrivere ed eseguire codice in questa lezione TypeScript Academy?
Sì. Ogni lezione TypeScript Academy include un editor di codice integrato, quindi scrivi ed esegui codice reale direttamente nel tuo browser e ricevi feedback istantaneo dall'IA — nessuna configurazione locale necessaria.
Tutte le lezioni di questo corso
- Avvio della migrazione: allowJs e checkJs
- Annotazioni di tipo JSDoc come collegamento
- Strategia di conversione file per file
- Gestione delle librerie di terze parti senza tipi