TypeScript Academy · Leçon

Typer les réponses de fetch avec des enveloppes génériques

Écrivez un utilitaire fetch typé qui renvoie des types sûrs

Leçon 1 sur 413 étapes

Typer les réponses de fetch avec des enveloppes génériques 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

Écrivez des fonctions utilitaires fetch typées pour consommer des API HTTP en toute sécurité.

Le problème de fetch

L’API fetch renvoie Promise et .json() renvoie Promise. Sans types, vous perdez toute sécurité.

const res = await fetch('/api/user');
const data = await res.json(); // data: any — unsafe

Wrapper fetch générique

Créez une fonction utilitaire fetch typée qui part de la forme attendue de la réponse.

async function fetchJson<T>(url: string): Promise<T> {
  const res = await fetch(url);
  if (!res.ok) throw new Error(`HTTP error: ${res.status}`);
  return res.json() as Promise<T>;
}

Utiliser le wrapper

Appelez le wrapper avec un argument de type explicite.

interface User { id: number; name: string; }
const user = await fetchJson<User>('/api/users/1');
console.log(user.name); // typed as string

Ajouter la gestion des erreurs

Étendez le wrapper pour qu’il renvoie un type Result.

async function safeFetch<T>(url: string): Promise<Result<T>> {
  try {
    const res = await fetch(url);
    if (!res.ok) return err(new Error(`HTTP ${res.status}`));
    return ok(await res.json() as T);
  } catch (e) { return err(e as Error); }
}

Typage des options de requête

Typez les options de fetch pour les requêtes POST et PUT.

async function postJson<T, B>(url: string, body: B): Promise<T> {
  const res = await fetch(url, {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify(body),
  });
  return res.json() as Promise<T>;
}

Validation de la réponse

Validez la forme de la réponse avant de la renvoyer comme valeur typée.

Typage d’AbortController

Typez AbortController et AbortSignal pour les requêtes annulables.

const ctrl = new AbortController();
const data = await fetchJson<User>('/api/users/1', { signal: ctrl.signal });
setTimeout(() => ctrl.abort(), 5000);

Intercepteur d’URL de base

Créez une classe de client HTTP avec une URL de base.

class ApiClient {
  constructor(private baseUrl: string) {}
  get<T>(path: string): Promise<T> {
    return fetchJson<T>(`${this.baseUrl}${path}`);
  }
}

En-têtes typés

Typez les en-têtes des requêtes et des réponses.

const headers: Record<string, string> = {
  Authorization: `Bearer ${token}`,
  'Content-Type': 'application/json',
};

Types de pagination

Typez les réponses d’API paginées.

interface Paginated<T> { data: T[]; page: number; total: number; }
const result = await fetchJson<Paginated<User>>('/api/users?page=1');

Vérification rapide

Que fait `res.json() as Promise` dans un wrapper fetch typé ?

Réponds-y dans la leçon interactive

Récapitulatif

Typer les réponses fetch avec des wrappers génériques : vous avez maîtrisé les concepts et modèles clés.

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

Commencer gratuitement Voir le cours complet

Questions Fréquemment Posées

La leçon « Typer les réponses de fetch avec des enveloppes génériques » est-elle gratuite ?

Oui — le texte complet de « Typer les réponses de fetch avec des enveloppes génériques » 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 « Typer les réponses de fetch avec des enveloppes génériques » ?

Écrivez un utilitaire fetch typé qui renvoie des types sûrs 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 « Typer les réponses de fetch avec des enveloppes génériques » ?

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

Typer les réponses de fetch avec des enveloppes génériques
Validation à l’exécution avec Zod
Génération de code OpenAPI : types générés automatiquement
Présentation du client tRPC sûr du point de vue des types

← Retour à TypeScript Academy