Aller au contenu
Makersquad

TypeScript 5.0 est sorti

par Makersquad ·

Logo de TypeScript sur fond dégradé

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 »
  • --verbatimModuleSyntax pour 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.

Échanger avec un expert TypeScript

De l’idée au marché. Makersquad conçoit des logiciels sur mesure, pensés pour durer, avec de petites équipes d’experts autonomes. Depuis 2018.