0Pricing
TypeScript Academy · Leçon

Contraintes génériques : affiner les paramètres de types

Utilisez extends pour imposer des exigences de structure aux génériques

Contraintes génériques : affiner les paramètres de types est une leçon TypeScript Academy gratuite sur CoddyKit. Ceci est la leçon 2 sur 4. Tu peux lire la leçon complète ci-dessous gratuitement — puis la pratiquer en direct dans le navigateur avec un éditeur de code intégré et un tuteur IA 24/7. Elle fait partie du parcours d'apprentissage TypeScript Academy, et ta progression se synchronise sur le web et l'application CoddyKit. Le cours TypeScript Academy comprend 4 leçons au total.

Bienvenue

Les contraintes génériques avancées permettent de limiter les types pouvant être utilisés comme arguments de type, ce qui autorise des opérations sûres du point de vue des types sur des structures complexes.

Récapitulatif des contraintes

T extends U limite T aux types qui sont des sous-types de U. Cela fournit à TypeScript des informations sur la structure de T à l’intérieur de la fonction.
function len<T extends { length: number }>(val: T): number {
  return val.length;
}

Contraindre à des méthodes spécifiques

Exigez que T possède une méthode spécifique en le contraignant à une interface qui contient cette méthode.
interface Stringable { toString(): string; }
function stringify<T extends Stringable>(val: T): string {
  return val.toString();
}

Inférer à partir d’une contrainte

Utilisez keyof dans la contrainte pour créer des accesseurs sûrs.
function pluck<T, K extends keyof T>(items: T[], key: K): T[K][] {
  return items.map(item => item[key]);
}
const names = pluck(users, 'name'); // string[]

Contraintes de type supérieur (simulées)

TypeScript ne prend pas en charge les véritables types de type supérieur, mais vous pouvez les simuler avec des types conditionnels et des contraintes.

Contraindre aux types primitifs

Limitez les paramètres de type à des types primitifs spécifiques pour les fonctions spécialisées.
type Primitive = string | number | boolean | bigint | symbol | null | undefined;
function isPrimitive<T extends Primitive>(val: T): true { return true; }

Contraintes récursives

Les contraintes peuvent se référencer elles-mêmes pour former des structures récursives.
interface Comparable<T> { compareTo(other: T): number; }
function sort<T extends Comparable<T>>(items: T[]): T[] {
  return [...items].sort((a, b) => a.compareTo(b));
}

Contrainte avec valeur par défaut

Un paramètre de type peut avoir à la fois une contrainte et une valeur par défaut. La valeur par défaut doit respecter la contrainte.
function process<T extends object = Record<string, unknown>>(data: T): void {
  console.log(Object.keys(data));
}

T extends Record<string, unknown>

Contraignez à un type d’enregistrement pour permettre l’accès dynamique aux propriétés.
function getValue<T extends Record<string, unknown>>(obj: T, key: string): unknown {
  return obj[key];
}

Inférence des contraintes dans les types de retour

Lorsque T est contraint, TypeScript utilise la contrainte pour déterminer les opérations valides sur le type de retour.
function firstKey<T extends object>(obj: T): keyof T {
  return Object.keys(obj)[0] as keyof T;
}

Utilitaire NoInfer (TS 5.4)

TypeScript 5.4 a introduit NoInfer pour empêcher l’inférence d’un paramètre de type à partir d’une position d’argument spécifique.
function createState<T>(initial: T, fallback: NoInfer<T>): T {
  return initial ?? fallback;
}

Vérification rapide

Qu’ajoute `T extends { length: number }` à T à l’intérieur d’une fonction générique ?

Récapitulatif

Les contraintes avancées limitent les types génériques à des structures, des méthodes ou des unions de types primitifs spécifiques. Combinez-les avec keyof, des structures récursives et des valeurs par défaut pour créer de puissants utilitaires sûrs du point de vue des types.

Questions Fréquemment Posées

La leçon « Contraintes génériques : affiner les paramètres de types » est-elle gratuite ?

Oui — le texte complet de « Contraintes génériques : affiner les paramètres de types » est gratuit à lire ici sur le web. Pour la pratiquer de manière interactive (un éditeur de code intégré et un tuteur IA 24/7) et déverrouiller le reste du cours TypeScript Academy, passe à CoddyKit PRO. Le cours TypeScript Academy comprend 4 leçons au total.

Qu'est-ce que j'apprendrai dans « Contraintes génériques : affiner les paramètres de types » ?

Utilisez extends pour imposer des exigences de structure aux génériques Tu pratiques TypeScript Academy avec du code pratique que tu exécutes directement dans le navigateur, et un tuteur IA 24/7 répond à tes questions au fur et à mesure que tu avances dans la leçon.

Dois-je avoir de l'expérience pour commencer TypeScript Academy ?

Aucune expérience préalable n'est requise. TypeScript Academy sur CoddyKit est structuré pour les débutants jusqu'aux apprenants avancés, donc tu peux commencer ici ou depuis le début et avancer à ton rythme. Ceci est la leçon 2 sur 4.

Combien de temps prend la leçon « Contraintes génériques : affiner les paramètres de types » ?

La plupart des leçons CoddyKit prennent environ 5–10 minutes. Chacune est courte et interactive, tu progresses régulièrement et tu repiques exactement où tu t'es arrêté sur le web et l'app.

Peux-tu écrire et exécuter du code dans cette leçon TypeScript Academy ?

Oui. Chaque leçon TypeScript Academy inclut un éditeur de code intégré, tu écris et exécutes du vrai code directement dans ton navigateur et tu reçois des retours IA instantanés — aucune configuration locale requise.

Toutes les leçons de ce cours

  1. keyof et types d’accès indexé
  2. Contraintes génériques : affiner les paramètres de types
  3. Types conditionnels : T extends U ? X : Y
  4. Types conditionnels distributifs
← Retour à TypeScript Academy