Corriger l'erreur Unexpected token en JSON

Le message Unexpected token, littéralement jeton inattendu, est produit par l'analyseur JSON lorsqu'il rencontre un caractère à un emplacement où la grammaire du format n'en prévoit pas. Un analyseur lit le document de gauche à droite en construisant une structure, et à chaque étape il n'attend qu'un ensemble restreint de caractères possibles. Par exemple, après une valeur dans un objet, il attend soit une virgule, soit une accolade fermante. S'il trouve autre chose, il ne peut pas continuer et signale un jeton inattendu. Le terme jeton désigne l'unité élémentaire que l'analyseur essaie de lire: un guillemet, une accolade, un nombre, une virgule. Comprendre cette logique aide à interpréter le message, car le caractère mentionné n'est pas toujours la cause, mais l'endroit où l'incohérence devient visible.

Plusieurs causes reviennent sans cesse derrière ce message. La plus fréquente est une virgule en trop, notamment une virgule finale avant une accolade ou un crochet fermant, qui fait apparaître la fermeture comme un jeton inattendu. Vient ensuite l'oubli d'un guillemet, qui laisse une chaîne non terminée ou une clé sans délimiteur. Les guillemets simples, valides en JavaScript mais interdits en JSON, produisent aussi cette erreur, tout comme les guillemets typographiques copiés depuis un traitement de texte. On rencontre également des valeurs écrites sans guillemets, un mot laissé tel quel là où une chaîne était attendue, ou encore deux valeurs collées sans virgule entre elles. Enfin, un caractère parasite invisible, comme un espace insécable ou un marqueur d'ordre d'octets en tête de fichier, suffit à déclencher un jeton inattendu dès la première position.

Techniquement, ce message provient de la fonction JSON.parse, présente dans tous les navigateurs et environnements JavaScript. Cette fonction lève une exception dès qu'elle bute sur un caractère impossible, et le texte de l'exception mentionne le jeton fautif ainsi que sa position. Selon l'environnement, le format du message varie, mais l'information essentielle reste la même: quel caractère a posé problème et où. L'outil s'appuie sur ce même mécanisme, puis vous présente la position sous une forme lisible, avec la ligne et la colonne. Cette localisation est déterminante, car le message brut d'une console indique parfois une position numérique dans la chaîne, difficile à relier à un endroit précis d'un long document. En traduisant cette position en coordonnées de ligne et de colonne, l'outil vous conduit directement au caractère à examiner.

Pour corriger, un réflexe efficace consiste à examiner non seulement le caractère signalé, mais aussi ce qui le précède immédiatement. Souvent, le jeton inattendu n'est que la conséquence d'un problème situé juste avant: une chaîne non fermée, une virgule manquante ou un guillemet oublié plus tôt dans la ligne. Si le message pointe une accolade fermante, cherchez une virgule finale juste avant. S'il pointe une lettre, vérifiez qu'une chaîne n'a pas été laissée sans guillemets ou qu'une virgule ne manque pas entre deux valeurs. Si l'erreur se situe à la toute première position, méfiez-vous d'un caractère invisible en tête de fichier. Une fois le caractère fautif ajouté, supprimé ou corrigé, la structure redevient cohérente et l'analyseur peut poursuivre sa lecture au-delà de ce point.

Comme pour toute erreur de syntaxe, l'analyseur s'arrête au premier problème. Après avoir corrigé le jeton inattendu signalé, relancez la validation: un autre peut se révéler plus loin, masqué jusque-là par le premier. Procéder par itérations, en corrigeant puis en revalidant, est la façon la plus fiable d'assainir un document. Il faut garder à l'esprit le rôle exact de l'outil: il identifie la validité, localise l'erreur et en explique la raison, mais il ne réécrit pas votre JSON à votre place. La correction reste votre décision, ce qui protège vos données de toute modification automatique indésirable. Et comme tout s'exécute localement dans le navigateur, votre JSON n'est jamais téléversé: il est analysé sur votre machine puis oublié à la fermeture de la page, gratuitement et sans inscription.