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.
Défi
FacileCré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
datade typeunknown - Utilise une assertion de type pour traiter
datacomme unestring - 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) etisActive(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
secondApiResponsede typeunknownavec la chaîne JSON :{"userId": 15, "username": "bob_admin", "isActive": false} - Crée
thirdApiResponsede typeunknownavec la chaîne JSON :{"userId": 99, "username": "charlie_user", "isActive": true}
Teste ta fonction et affiche les résultats suivants :
- Appelle
processUserDataavecapiResponseet affiche le résultat - Appelle
processUserDataavecsecondApiResponseet affiche le résultat - Appelle
processUserDataavecthirdApiResponseet 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));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
1Premiers pas avec TS
Qu'est-ce que TypeScript ?Pourquoi utiliser TypeScript ?Votre premier code TypeScriptProcessus de compilation et erreursRécapitulatif : Introduction à TS4Travailler avec les fonctions
Typage des paramètres et valeurs de retourTypage des fonctions fléchéesLe type de retour 'void'Paramètres optionnels avec '?'Valeurs par défaut des paramètresTypage des paramètres RestDéfinir des types de fonctionsRécapitulatif : Créer des fonctions typées2Types fondamentaux
Types de base : str, num, booleanLe type « any » : solution de secoursLe type « unknown »Travailler avec null et undefinedL’inférence de types en actionAnnotations de type explicitesRécapitulatif : pratique des types fondamentaux5Types : Alias, Unions & Intersections
Alias de types pour les primitifsTypes d'union ('|')Travailler avec les types d'unionTypes littérauxTypes d'intersection ('&')Combiner des alias de typesRécapitulatif : Combinaisons de types avancées3Structure de données : Tableaux et Tuples
Tableaux typésModificateur 'readonly' pour les tableauxQu'est-ce qu'un tuple ?Déclaration et accès aux tuplesDéstructuration de tuplesTuples readonlyTableaux typés multidimensionnelsSpread operator avec les tableauxRécapitulatif : Tableaux et tuples6Typage des objets et interfaces
Annotations de type d'objet en ligneAlias de type pour les objetsIntroduction aux interfacesInterfaces vs Alias de typePropriétés optionnelles et ReadonlyÉtendre les interfaces et les typesAjout de méthodes aux interfacesRécapitulatif : Définir la structure des objetsEntraînez-vous par vous-même : Playground TypeScript