Menu
CoddyTech

Assertions de type

Fait partie de la section Introduction à TypeScript du Journey JavaScript de Coddy. Leçon 68 sur 73.

Parfois, TypeScript ne dispose pas de suffisamment d’informations pour déterminer le type exact d’une valeur, mais vous, en tant que développeur, en savez davantage sur ce qu’est réellement cette valeur. Les assertions de type vous permettent de dire à TypeScript : « Faites-moi confiance, je sais que cette valeur est de ce type précis. »

TypeScript propose deux syntaxes pour les assertions de type. La syntaxe as est l’approche la plus courante :

let data: unknown = '{"name": "John", "age": 30}';
let user = data as string;

Vous pouvez également utiliser la syntaxe avec chevrons, même si elle est moins courante dans TypeScript moderne :

let data: unknown = '{"name": "John", "age": 30}';
let user = <string>data;

La même chose fonctionne pour les objets. Lorsqu’une valeur arrive avec le type unknown, tu peux affirmer la forme attendue, puis lire ses propriétés :

let payload: unknown = { name: "John", age: 30 };
let user = payload as { name: string; age: number };
console.log(user.name);

Une assertion ne change que ce que TypeScript croit au sujet de la valeur. Elle ne convertit rien à l’exécution ; n’affirme donc une forme que si tu sais que la valeur la possède réellement.

challenge icon

Défi

Facile

Crée une fonction qui traite des données provenant d’une simulation d’API externe. Tu travailleras avec des valeurs de type unknown et utiliseras des assertions de type pour accéder à leurs propriétés en toute sécurité.

Crée une variable apiResponse de type unknown et attribue-lui la chaîne JSON suivante :

{"userId": 42, "username": "alice_dev", "isActive": true}

Crée une fonction nommée processUserData qui :

  • Prend un paramètre data de type unknown
  • Utilise une assertion de type pour traiter data comme une string
  • Analyse la chaîne JSON à l’aide de JSON.parse()
  • Utilise une autre assertion de type pour traiter le résultat analysé comme un objet ayant les propriétés userId (number), username (string) et isActive (boolean)
  • Renvoie une chaîne formatée : "User [userId]: [username] (Active: [isActive])"
  • A un type de retour explicite string

Crée des données de test supplémentaires :

  • Crée secondApiResponse de type unknown avec la chaîne JSON : {"userId": 15, "username": "bob_admin", "isActive": false}
  • Crée thirdApiResponse de type unknown avec la chaîne JSON : {"userId": 99, "username": "charlie_user", "isActive": true}

Teste ta fonction et affiche les résultats suivants :

  • Appelle processUserData avec apiResponse et affiche le résultat
  • Appelle processUserData avec secondApiResponse et affiche le résultat
  • Appelle processUserData avec thirdApiResponse et affiche le résultat

Essayez vous-même

// Créez les variables de réponse de l’API
const apiResponse: unknown = '{"userId": 42, "username": "alice_dev", "isActive": true}';
const secondApiResponse: unknown = '{"userId": 15, "username": "bob_admin", "isActive": false}';
const thirdApiResponse: unknown = '{"userId": 99, "username": "charlie_user", "isActive": true}';

// TODO: Créez la fonction processUserData ici

// Testez la fonction et affichez les résultats
console.log(processUserData(apiResponse));
console.log(processUserData(secondApiResponse));
console.log(processUserData(thirdApiResponse));
quiz iconTestez-vous

Cette leçon comprend un petit quiz. Commencez la leçon pour y répondre et suivre votre progression.

Toutes les leçons de Introduction à TypeScript

Entraînez-vous par vous-même : Playground TypeScript