TypeScript Academy · Leçon

Promise<T>, typage de async/await

Comprenez la structure de Promise , annotez les fonctions async et manipulez les valeurs attendues en toute sécurité.

Leçon 1 sur 38 étapes

Promise<T>, typage de async/await est une leçon TypeScript Academy gratuite sur CoddyKit. Ceci est la leçon 1 sur 3. 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 3 leçons au total.

Introduction

Objectif : lire et écrire du code fondé sur Promise<T>. Vous allez typer des fonctions asynchrones, attendre des valeurs et conserver des erreurs correctement typées.

Bases des Promise

Promise<T> enveloppe une valeur qui sera disponible ultérieurement. Utilisez Promise lorsqu’aucune valeur n’est résolue.

function delay(ms: number): Promise<void> {
  return new Promise(resolve => setTimeout(resolve, ms));
}

const p: Promise<void> = delay(100);

p.then(() => console.log("done"));

Typage du retour asynchrone

Les fonctions async renvoient toujours une Promise<U>. Le corps renvoie U, que TS enveloppe automatiquement.

async function fetchNumber(): Promise<number> {
  await delay(10);
  return 42; // inferred as Promise<number>
}

fetchNumber().then(n => console.log(n.toFixed(0)));

Typage de await

await désenveloppe la Promise et produit le type interne (string ici), ce qui vous fournit IntelliSense correctement.

async function readUserName(id: number): Promise<string> {
  await delay(5);
  return `user-${id}`;
}

async function main(): Promise<void> {
  const name = await readUserName(7); // name: string
  console.log(name.toUpperCase());
}

main();

Typage de Promise.all

Promise.all préserve les types des tuples ; chaque élément est attendu jusqu’à son type interne.

async function both() {
  const [n, s] = await Promise.all([
    fetchNumber(),
    readUserName(1),
  ]);
  console.log(n, s);
}

both();

Typage des erreurs

Dans catch, préférez unknown. Affinez avec instanceof Error (ou des vérifications personnalisées) avant d’accéder aux champs.

async function safe() {
  try {
    await delay(1);
    throw new Error("boom");
  } catch (e: unknown) {
    if (e instanceof Error) {
      console.error("Handled:", e.message);
    } else {
      console.error("Unknown error", e);
    }
  }
}

safe();

Vérification du type de retour asynchrone

Vérification rapide : quel est le type de retour d’une fonction asynchrone qui renvoie une valeur de type U ?

Récapitulatif

Récapitulatif : Promise<T> enveloppe les valeurs disponibles ultérieurement, les fonctions async renvoient Promise<U>, await désenveloppe les types et les erreurs dans catch doivent commencer par être de type unknown.

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 « Promise<T>, typage de async/await » est-elle gratuite ?

Oui — le texte complet de « Promise<T>, typage de async/await » 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 3 leçons au total.

Qu'est-ce que j'apprendrai dans « Promise<T>, typage de async/await » ?

Comprenez la structure de Promise , annotez les fonctions async et manipulez les valeurs attendues en toute sécurité. 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 3.

Combien de temps prend la leçon « Promise<T>, typage de async/await » ?

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. Promise , typage de async/await
  2. Typage des erreurs (unknown), réduction dans catch
  3. Motifs de concurrence (all/settled/race) et types
← Retour à TypeScript Academy