TypeScript 5.8 est sorti
par Makersquad ·
Date de sortie : 28 février 2025
Mis à jour le 17 novembre 2026
Documentation officielle : Announcing TypeScript 5.8
TypeScript 5.8 vérifie chaque branche d’une expression conditionnelle dans un return et laisse require() charger des modules ESM sous Node.js 22. Le nouveau flag --erasableSyntaxOnly prépare la compatibilité avec l’exécution native de TypeScript par Node.js.
Les nouveautés principales
Vérification granulaire des retours conditionnels
Avant, le type d’une expression conditionnelle était l’union des types de ses branches : une branche de type any pouvait masquer une erreur. TypeScript 5.8 vérifie chaque branche d’un conditionnel placé directement dans un return contre le type de retour déclaré :
declare const untypedCache: Map<any, any>;
function getUrlObject(urlString: string): URL {
return untypedCache.has(urlString)
? untypedCache.get(urlString)
: urlString;
// Erreur : Type 'string' is not assignable to type 'URL'.
}
Le travail annoncé sur la vérification des fonctions à type de retour conditionnel a été retiré de cette version, pour viser la 5.9.
require() de modules ESM sous Node.js 22
Node.js 22 autorise require() depuis CommonJS vers un module ES, sauf si ce module contient un await de premier niveau. Sous --module nodenext, TypeScript ne signale donc plus d’erreur sur ces appels :
// Depuis un fichier CommonJS
const { myFunction } = require("./my-esm-module.mjs");
Avec Node.js 22 et plus, les packages n’ont plus besoin d’être publiés en double (CJS et ESM) pour être importables depuis CommonJS. À la sortie de la 5.8, il n’existe pas d’option stable --module nodeXXXX pour ce comportement et l’annonce prévoit qu’une version future pourrait la stabiliser sous node20 (c’est ce que fait la 5.9 avec --module node20). Les auteurs de bibliothèques et les utilisateurs de versions plus anciennes de Node.js devaient rester sur --module node16 ou passer à --module node18.
--erasableSyntaxOnly
Node.js 23.6 exécute directement des fichiers TypeScript, à condition que la syntaxe propre à TypeScript puisse simplement être effacée du fichier. Avec ce flag, TypeScript signale les constructions qui ont une sémantique au runtime :
// Autorisé : les types sont effacés
type User = { name: string };
interface Config { port: number }
// Erreur avec --erasableSyntaxOnly
enum Status { Active, Inactive }
namespace Utils { export const x = 1; } // namespace avec du code runtime
import fs = require("fs"); // alias import =
class Foo {
constructor(public name: string) {} // parameter property
}
Les enum, les namespace et module contenant du code runtime, les parameter properties et les alias import = sont signalés. L’annonce recommande de l’associer à --verbatimModuleSyntax.
--module node18
Option stable pour cibler Node.js 18 : sous node18, le require() d’ESM est interdit et les import assertions sont autorisées. Sous nodenext, c’est l’inverse pour les deux.
{
"compilerOptions": {
"module": "node18"
}
}
--libReplacement
Depuis TypeScript 4.5, les fichiers lib par défaut peuvent être remplacés par des packages @typescript/lib-*. TypeScript cherchait toujours ces packages et surveillait node_modules, même sans usage de la fonctionnalité, ce qui coûte en performance. Ce flag désactive cette recherche :
{
"compilerOptions": {
"libReplacement": false
}
}
L’annonce précise que false pourrait devenir la valeur par défaut : qui s’appuie sur le remplacement de lib doit poser --libReplacement true.
Autres améliorations
- Noms de propriétés calculées préservés dans les fichiers de déclaration (
[propName]: number;au lieu d’une signature d’index) - Optimisations de performance pour la normalisation de chemins et pour la revalidation des options après une modification
- Sous
--module nodenext, Node.js 22 n’accepte plusassert: il faut utiliserwith(import attributes)
À retenir
TypeScript 5.8 prépare l’écosystème à la cohabitation ESM/CJS et à l’exécution native de TypeScript par Node.js. Si vous visez cette exécution, activez --erasableSyntaxOnly dès que possible pour identifier les constructions problématiques.