Passer au contenu principal
Les sourcemaps sont un moyen de convertir les backtraces des fichiers JavaScript minifiés ou transpilés vers leur représentation d’origine dans votre code source. Une sourcemap contient des données sur votre code source front-end, que nous pouvons utiliser pour déduire le nom de la fonction, le numéro de ligne et de colonne, et le code source environnant à partir de la position référencée dans la backtrace.

​
Prérequis

L’enrichissement des backtraces avec des sourcemaps nécessite que chaque échantillon soit étiqueté avec une revision de votre application. Ceci est utilisé pour déterminer quand récupérer de nouvelles sourcemaps après qu’un déploiement a modifié votre code (front-end). Vous pouvez spécifier la révision dans les options fournies lors de la création d’une nouvelle instance AppSignal. 
const appsignal = new Appsignal({
  key: "<your frontend API key>",
  revision: "<your current revision>",
});

​
Sourcemaps publiques

Avec les sourcemaps publiques, la sourcemap est hébergée à côté du fichier JavaScript. Au bas du JavaScript minifié, il doit y avoir un commentaire spécial pour indiquer qu’une sourcemap est disponible pour le code. 
//# sourceMappingURL=file.js.map
L’URL dans ce commentaire peut être une URL complète vers la sourcemap, ou un chemin relatif depuis le fichier JavaScript vers la sourcemap. Par exemple, si le JS minifié est hébergé sur : https://your.app/assets/application.min.js et que le commentaire de sourcemap ressemble à //# sourceMappingURL=application.min.js.map, nous tenterons de récupérer la sourcemap à partir de l’URL suivante : https://your.app/assets/application.min.js.map. Nous tentons de mettre en cache les sourcemaps publiques, mais nous pouvons néanmoins demander la version minifiée et le fichier sourcemap plus d’une fois.

​
Sourcemaps privées

Nous recommandons généralement d’utiliser des sourcemaps publiques chaque fois que possible, car les builds qui produisent de nombreuses sourcemaps peuvent prendre beaucoup de temps à téléverser via notre point d’accès de sourcemaps privées. Cependant, si ce n’est pas possible, vous pouvez également téléverser vos sourcemaps vers notre point d’accès API sourcemaps.

​
Conservation

Les sourcemaps sont regroupées en une « release » par la chaîne revision et nous conserverons la dernière « release » jusqu’à ce qu’une nouvelle revision soit téléversée. Les anciennes « releases » seront conservées jusqu’à soixante jours.