Les Source maps sont des fichiers JSON permettant d'associer les sources transformées (minifiés, combinés, générées) lues par le navigateur, à leurs fichiers source originels. Il est parfois possible d'avoir des problèmes avec les sources map. Cette page présente les plus communs d'entre eux ainsi que des solutions pour les corriger.

Note: En cas d'infamiliarité avec les source map, il est possible d'en apprendre plus ici : Utiliser une source map.

Gestion d'erreurs des source map

Dès lors qu'une erreur arrive, un message apparaitra dans la Console. Le message affichera le message d'erreur, l'URL de la ressource, et l'URL de la source map :

 

Error from invalid JSON

 

Ici, l'URL de la ressource URL indique que bundle.js mentionne une source map, et l'URL de la source map montre ou trouver la source map en elle-même (avec un chemin relatif à la ressource). L'erreur indique que la source map n'est pas un JSON valide.

Il y a quelques erreurs fréquentes qui reviennent avec les sources map. Elles sont décrites dans les sections suivantes.

La source map est inexistante ou inaccessible

 

Source map file is missing

 

La solution ici est de vérifier que le fichier est bien accessible par le navigateur (le fichier existe, et l'URL est bonne).

Source map invalide

Le code de la source map data peut être invalide. Soit parce que ce n'est tout simplement pas un fichier JSON, soit parce qu'il est mal formaté. Les messages d'erreurs typiques sont :

  • SyntaxError: JSON.parse: unexpected character at line 1 column 1 of the JSON data
  • Error: "version" is a required argument

 

Error: "version" is a required argument

 

Source originale manquante

Une source originale peut manquer. Il est possible d'avoir cette erreur en tentant d'ouvrir une source originale dans le Débogueur. Le message est un peu différent dans ce cas :

 

Debugger source tab showing the error

 

Ici, l'erreur sera également affichée dans l'onglet source du Débogueur :

 

Debugger source tab showing the error

 

Étiquettes et contributeurs liés au document

Contributeurs à cette page : wbamberg, maximelore
Dernière mise à jour par : wbamberg,