TypeScript 5.0 est sorti
par Makersquad ·
Date de sortie : 16 mars 2023
Mis à jour le 17 novembre 2026
Documentation officielle : Announcing TypeScript 5.0
TypeScript 5.0 est une release massive. Les décorateurs ECMAScript standard arrivent, aux côtés de l’ancienne API expérimentale qui reste disponible, les const type parameters règlent des problèmes d’inférence frustrants, et le compilateur démarre environ 11 % plus vite.
Les nouveautés principales
Décorateurs ECMAScript
Implémentation du standard ECMAScript pour les décorateurs. Exemple de l’annonce officielle, où this est typé :
function loggedMethod(originalMethod: any, _context: any) {
function replacementMethod(this: any, ...args: any[]) {
console.log("LOG: Entering method.")
const result = originalMethod.call(this, ...args);
console.log("LOG: Exiting method.")
return result;
}
return replacementMethod;
}
class Person {
name: string;
constructor(name: string) {
this.name = name;
}
@loggedMethod
greet() {
console.log(`Hello, my name is ${this.name}.`);
}
}
Ces décorateurs ne remplacent pas les décorateurs expérimentaux : l’option --experimentalDecorators reste disponible. Sans elle, les décorateurs sont valides pour du code nouveau, mais vérifiés et émis différemment.
Les const type parameters
Le modificateur const fait inférer le type comme avec as const. Pour un tableau, la contrainte doit être readonly :
// Sans const : T est string[]
declare function getNamesLoose<T extends string[]>(names: T): T;
getNamesLoose(["Alice", "Bob"]); // string[]
// Avec const et une contrainte readonly : T est readonly ["Alice", "Bob"]
declare function getNames<const T extends readonly string[]>(names: T): T;
getNames(["Alice", "Bob"]); // readonly ["Alice", "Bob"]
Avec <const T extends string[]>, le résultat reste string[], car un tableau readonly n’est pas assignable à string[]. Le modificateur n’agit que sur les littéraux écrits directement dans l’appel.
extends multiple dans tsconfig
Le champ extends accepte désormais plusieurs configurations. En cas de conflit, la dernière entrée l’emporte :
{
"extends": ["./base.json", "./strict.json"],
"compilerOptions": {
"strict": true
}
}
--moduleResolution bundler
Nouvelle stratégie de résolution pour les bundlers modernes, avec --module à esnext. --allowImportingTsExtensions n’est autorisé qu’avec --noEmit ou --emitDeclarationOnly :
{
"compilerOptions": {
"module": "esnext",
"moduleResolution": "bundler",
"allowImportingTsExtensions": true,
"noEmit": true
}
}
JSDoc @satisfies et @overload
Pour les projets JavaScript avec vérification de types :
/**
* @satisfies {Record<string, number>}
*/
const counts = { apples: 5, oranges: 3 };
/**
* @overload
* @param {string} x
* @returns {number}
*/
/**
* @overload
* @param {number} x
* @returns {string}
*/
function process(x) {
return typeof x === "string" ? x.length : String(x);
}
Performance
- Démarrage du compilateur : 89 % du temps de la version 4.9, soit environ 11 % plus rapide
- Build de material-ui : 90 % du temps de la version 4.9
- Package npm 41 % plus petit (63,8 Mo à 37,4 Mo)
- Migration interne vers les modules ES
L’équipe TypeScript annonce des gains reproductibles de 10 à 20 % sur la plupart des bases de code, selon le matériel et le projet.
Autres améliorations
- Tous les enums sont maintenant des « union enums »
--verbatimModuleSyntaxpour un meilleur contrôle des imports- Support de
export type *
À retenir
TypeScript 5.0 est une mise à jour importante. Les décorateurs standard ouvrent la voie à un écosystème plus unifié, et les gains de performance sont réels. L’annonce parle d’une release non disruptive, mais elle liste des changements à vérifier avant de migrer : cible ECMAScript 2018 et Node.js 12.20 minimum pour TypeScript lui-même, --newLine à LF et --forceConsistentCasingInFileNames à true par défaut, et des options dépréciées (--target ES3, --out, --importsNotUsedAsValues, --preserveValueImports) autorisées jusqu’à TypeScript 5.5.