Migrer du code JavaScript vers TypeScript strict sans rien casser

Prompt

Agis comme un ingénieur TypeScript senior qui a migré de grandes bases de code JavaScript de façon progressive.

Contexte :
- Code à migrer : {{code_js}}
- Projet et outils de build : {{projet}}
- Niveau de rigueur : {{rigueur}}
- Environnement d'exécution : {{environnement}}

Si le code importe des modules que je n'ai pas montrés ou reçoit des données dont la forme n'est pas claire, demande-moi avant d'inventer des types.

Livrables :
1. Un tsconfig.json recommandé pour {{rigueur}}, avec l'explication des options clés (strict, noUncheckedIndexedAccess, allowJs, checkJs, module et moduleResolution selon le build).
2. Le code converti en TypeScript, avec des types et interfaces déduits de l'usage réel. Marque chaque type supposé d'un commentaire `// HYPOTHÈSE :`.
3. Les données externes (réponses d'API, localStorage, JSON) typées en `unknown` puis validées ou affinées avant usage.
4. La liste des bugs ou comportements douteux révélés par les types (undefined possibles, comparaisons entre types différents, arguments optionnels mal gérés), avec la ligne et la correction proposée, séparée de la conversion.
5. Les paquets @types nécessaires et les changements dans les scripts du package.json ou la config ESLint.
6. Un plan pour migrer le reste du projet : ordre des fichiers (des feuilles vers la racine), cohabitation avec le JS pendant la transition et moyens d'empêcher le retour des `any`.

Contraintes :
- Conserve exactement le comportement ; ne refactorise pas la logique dans la même étape.
- Interdits : `any`, `as any`, `@ts-ignore` et assertions non nulles `!` sans justification écrite.
- Si une correction change le comportement, propose-la à part sans l'appliquer.
- Utilise [À COMPLÉTER] pour ce qui ne peut pas être déduit.

Format : tsconfig, code converti, liste des constats et plan, chacun dans sa section.

Comment l'utiliser

Exemple d'utilisation

Exemple de résultat

// HYPOTHÈSE : forme déduite de l'usage dans le fichier d'origine
export interface ArticlePanier {
  readonly id: string;
  prix: number;
  quantite: number;
}

export function totalPanier(articles: readonly ArticlePanier[], remisePct = 0): number {
  const sousTotal = articles.reduce((somme, a) => somme + a.prix * a.quantite, 0);
  return sousTotal * (1 - remisePct / 100);
}

export function chargerPanier(): ArticlePanier[] {
  const brut: unknown = JSON.parse(localStorage.getItem('panier') ?? '[]');
  return Array.isArray(brut) ? brut.filter(estArticlePanier) : [];
}

function estArticlePanier(valeur: unknown): valeur is ArticlePanier {
  if (typeof valeur !== 'object' || valeur === null) return false;
  const v = valeur as Record<string, unknown>;
  return typeof v.id === 'string' && typeof v.prix === 'number' && typeof v.quantite === 'number';
}

Informations clés

Catégorie

Programmation et développement · TypeScript

Type de résultat

Code

Niveau

Intermédiaire

Conçu pour

ChatGPT, Claude, Gemini et Microsoft Copilot

Vérifié sur

En attente de vérification éditoriale

Variables

Code JavaScript, Projet et build, Niveau de rigueur et Environnement d’exécution

Langue

Français

Prix

Gratuit, sans inscription

Mis à jour

07/11/2026

Questions fréquentes