Comment convertir une chaîne en enum en TypeScript : tutoriel complet

Comment convertir une chaîne en enum en TypeScript : guide étape par étape

Avez-vous déjà été confronté à une situation où l'API renvoie une chaîne, alors que votre modèle TypeScript est strictement typé via un enum ? Ou peut-être recevez-vous une valeur depuis localStorage et souhaitez-vous la convertir en toute sécurité en énumération ? Si oui, vous êtes au bon endroit. Dans cet article, nous allons voir comment convertir une chaîne en enum en TypeScript — des solutions simples aux techniques avancées avec gestion des erreurs.

Ce sujet est l'un des plus populaires sur Stack Overflow (des milliers de vues !), et ce n'est pas pour rien. Même les développeurs expérimentés se trompent souvent lorsqu'il s'agit de convertir en toute sécurité des chaînes en énumérations. Mettons les choses au clair.

Qu'est-ce qu'un enum en TypeScript et pourquoi le convertir ?

Un enum (énumération) est un outil puissant de TypeScript qui permet de définir un ensemble de constantes nommées. Au lieu d'utiliser des "chaînes magiques" comme 'active' ou 'pending', vous définissez un enum et travaillez avec des valeurs typées. Mais voici le problème : les données provenant de sources externes (API, formulaires, fichiers de configuration) arrivent souvent sous forme de chaînes ordinaires. Et la question se pose alors : comment convertir une chaîne en enum TypeScript de manière sûre et élégante ?

// Exemple d'enum\nenum Status {\n  Active = 'active',\n  Inactive = 'inactive',\n  Pending = 'pending'\n}\n\n// Chaîne provenant de l'API\nconst apiStatus: string = 'active';\n// Comment obtenir Status.Active ? 🤔

Méthode 1 : Assertion de type directe (Type Assertion)

La méthode la plus simple, mais aussi la plus dangereuse. Vous dites simplement à TypeScript : "Fais-moi confiance, c'est la bonne valeur".

const status = apiStatus as Status;\n// ou\nconst status = <Status>apiStatus;

Avantage : Minimum de code. Inconvénient : Si la chaîne ne correspond à aucune valeur de l'enum, vous obtiendrez undefined sans avertissement. TypeScript ne lèvera pas d'erreur, et vous ne découvrirez le problème qu'à l'exécution, quand quelque chose se cassera.

Cette méthode ne doit être utilisée que si vous êtes absolument certain de la source des données. Pour la production, elle est déconseillée.

Méthode 2 : Utilisation d'une fonction utilitaire personnalisée

C'est le juste milieu entre simplicité et sécurité. Écrivons une fonction qui prend une chaîne et vérifie si cette valeur existe dans l'enum.

function stringToEnum<T>(value: string, enumObject: T): T[keyof T] | undefined {\n  // Vérifions si la valeur est dans l'enum\n  const enumValues = Object.values(enumObject) as string[];\n  if (enumValues.includes(value)) {\n    return value as unknown as T[keyof T];\n  }\n  return undefined;\n}\n\n// Utilisation\nconst status = stringToEnum(apiStatus, Status);\nif (status) {\n  console.log(status); // Status.Active\n} else {\n  console.error('Valeur de statut incorrecte');\n}

Cette fonction convertit en toute sécurité une chaîne en enum TypeScript. Si la valeur n'est pas trouvée, elle retourne undefined, et vous pouvez traiter ce cas. Notez le générique <T> — il rend la fonction universelle pour n'importe quel enum.

Méthode 3 : Approche stricte avec levée d'erreur

Parfois, undefined n'est pas ce dont vous avez besoin. Il est préférable de lever explicitement une erreur pour détecter rapidement le problème.

function stringToEnumStrict<T>(value: string, enumObject: T): T[keyof T] {\n  const enumValues = Object.values(enumObject) as string[];\n  if (enumValues.includes(value)) {\n    return value as unknown as T[keyof T];\n  }\n  throw new Error(`La valeur "${value}" n'a pas été trouvée dans l'enum`);\n}\n\n// Utilisation\ntry {\n  const status = stringToEnumStrict(apiStatus, Status);\n  // Travailler avec status\n} catch (error) {\n  console.error(error.message);\n  // Enregistrer l'erreur dans Sentry ou un autre système de surveillance\n}

                
                

                    

                        Blogs                    
                    

                                                    
                                

                                    

                                        
                                    
                                    
Travailler avec JSON en Go : parsing et sérialisation en pratique
                                
                            
                                                    
                                

                                    

                                        
                                    
                                    
Kotlin : comment corriger l'erreur "Module was compiled with an incompatible version of Kotlin"
                                
                            
                                            
                

                
                

                    

                        Book Recommendations                    
                    

                                                    
                                

                                    

                                        
                                    
                                    
Modèles de conception en Kotlin
                                
                            
                                                    
                                

                                    

                                        
                                    
                                    
Rust professionnel : techniques avancées
                                
                            
                                                    
                                

                                    

                                        
                                    
                                    
Apprentissage automatique et Go (Golang) : Guide pratique
                                
                            
                                                    
                                

                                    

                                        
                                    
                                    
Développement d'API en Rust : création de services web haute performance
                                
                            
                                            
                
            
    

  
Lire aussi
  

                
                  
                 Algorithmes et structures de données en C++ : guide pratique pour développeurs
      
                
                  
                 Swift : Remplacement de caractères dans une chaîne — analyse complète pour débutants
      
                
                  
                 Generics en Go : pourquoi en a-t-on besoin et comment les utiliser pour les débutants
      
                
                  
                 Travailler avec les bases de données en TypeScript : PostgreSQL et MongoDB pour débutants
      
                
                  
                 Architecture événementielle en Swift : transformez votre code en orchestre d'événements