Migrare da JavaScript a TypeScript

Migrare senza fermare lo sviluppo

Riscrivere da zero un progetto JavaScript in TypeScript e quasi sempre un errore. La strada giusta e una migrazione graduale: TypeScript e progettato per convivere con JavaScript, permettendo di adottarlo file per file senza bloccare il lavoro del team.

Partire in modalita permissiva

Il primo passo e aggiungere TypeScript e un tsconfig.json tollerante, che accetti i file .js esistenti. Si attiva allowJs e si parte con i controlli al minimo, per non essere sommersi da errori.

{
  "compilerOptions": {
    "allowJs": true,
    "checkJs": false,
    "strict": false,
    "outDir": "dist"
  }
}

Convertire un file alla volta

Si rinomina un file da .js a .ts, si aggiungono i tipi alle firme delle funzioni e si risolvono gli errori che emergono. Conviene iniziare dai moduli piu stabili e centrali, come utility e modelli di dati, su cui dipende il resto.

Stringere le viti progressivamente

Man mano che il codice viene tipizzato, si alzano i controlli: prima noImplicitAny, poi strictNullChecks, infine strict completo. Ogni passo intercetta una classe di bug in piu.

Sfruttare le definizioni

Per le librerie esterne si installano i tipi da DefinitelyTyped (@types/...), ottenendo autocompletamento e controlli anche sul codice di terze parti.

In MUSTNODE SRL gestiamo le migrazioni a TypeScript in modo incrementale, cosi i clienti ottengono codice piu sicuro e manutenibile senza interrompere la consegna di nuove funzionalita.