TypeScript Academy · Leçon

Fonctions génériques : paramètres de types

Ajoutez des paramètres de types aux fonctions pour les rendre réutilisables

Leçon 1 sur 413 étapes

Fonctions génériques : paramètres de types est une leçon TypeScript Academy gratuite sur CoddyKit. Ceci est la leçon 1 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 génériques vous permettent d’écrire des fonctions qui fonctionnent avec n’importe quel type tout en préservant la sûreté des types. Au lieu d’utiliser `any`, vous utilisez un paramètre de type résolu lors de l’appel de la fonction.

Le problème résolu par les génériques

Une fonction qui renvoie `any` perd les informations de type. Les génériques préservent la relation entre les types d’entrée et de sortie.
// Without generics — loses type info
function first(arr: any[]): any { return arr[0]; }

// With generics — type-safe
function first<T>(arr: T[]): T { return arr[0]; }

Syntaxe des paramètres de type

Déclarez un paramètre de type entre chevrons `` avant la liste des paramètres. Utilisez T dans les paramètres et le type de retour.
function identity<T>(value: T): T {
  return value;
}
const n = identity(42);       // T is number
const s = identity('hello');  // T is string

Inférence de type pour les fonctions génériques

TypeScript déduit l’argument de type à partir de l’argument réel. Vous devez rarement le spécifier explicitement.
function wrap<T>(val: T): T[] { return [val]; }
const nums = wrap(42);    // T inferred as number -> number[]
const strs = wrap('hi');  // T inferred as string -> string[]

Plusieurs paramètres de type

Les fonctions peuvent posséder plusieurs paramètres de type.
function pair<A, B>(a: A, b: B): [A, B] {
  return [a, b];
}
const p = pair(1, 'hello'); // [number, string]

Fonctions génériques pour les tableaux

Les génériques sont essentiels pour les fonctions utilitaires de tableau qui fonctionnent avec n’importe quel type d’élément.
function filterNull<T>(arr: (T | null)[]): T[] {
  return arr.filter((x): x is T => x !== null);
}

Arguments de type explicites

Vous pouvez fournir explicitement des arguments de type lorsque TypeScript ne parvient pas à les déduire.
function create<T>(): T | null { return null; }
const user = create<User>(); // T cannot be inferred — must be explicit

Génériques et `any`

Contrairement à `any`, les génériques maintiennent la relation entre les types dans toute la fonction. Le type de retour est lié au type d’entrée.
function echo<T>(val: T): T { return val; }
const n: number = echo(42);   // OK
// const s: string = echo(42); // Error — T is number

Fonctions fléchées génériques

Les fonctions fléchées utilisent la même syntaxe, mais nécessitent une virgule dans les fichiers .tsx pour être distinguées des balises JSX.
const identity = <T>(val: T): T => val;
// In .tsx files:
const identity2 = <T,>(val: T): T => val;

Renvoyer un type différent

Les fonctions génériques peuvent utiliser le paramètre de type de manière transformée.
function mapArray<T, U>(arr: T[], fn: (item: T) => U): U[] {
  return arr.map(fn);
}
const lengths = mapArray(['hello', 'world'], s => s.length);
// lengths: number[]

Paramètres génériques avec valeurs par défaut

Fournissez un type par défaut pour un paramètre de type afin de le rendre facultatif.
function createList<T = string>(): T[] { return []; }
const list = createList(); // T defaults to string

Vérification rapide

Quel est le type de retour de `identity(42)` ?

Récapitulatif

Les fonctions génériques utilisent des paramètres de type (T) pour préserver les relations entre les entrées et les sorties. TypeScript déduit automatiquement les arguments de type. Utilisez les génériques plutôt que any pour écrire des fonctions utilitaires réutilisables et sûres du point de vue des types.
Gratuit pour commencer

Apprends TypeScript avec un tuteur IA — gratuit

Écris et exécute du vrai code dans ton navigateur, obtiens de l'aide instantanée d'un tuteur IA disponible 24h/24, et reprends là où tu t'es arrêté sur le web ou dans l'app.

Cours
101
Leçons
352

Questions Fréquemment Posées

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

Oui — le texte complet de « Fonctions génériques : 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 « Fonctions génériques : paramètres de types » ?

Ajoutez des paramètres de types aux fonctions pour les rendre réutilisables 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 1 sur 4.

Combien de temps prend la leçon « Fonctions génériques : 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. Fonctions génériques : paramètres de types
  2. Interfaces et alias de types génériques
  3. Contraintes génériques avec extends
  4. Paramètres de types par défaut
← Retour à TypeScript Academy