> ## Documentation Index
> Fetch the complete documentation index at: https://docs.appsignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Sourcemaps

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.

<CodeGroup>
  ```js JavaScript theme={null}
  const appsignal = new Appsignal({
    key: "<your frontend API key>",
    revision: "<your current revision>",
  });
  ```
</CodeGroup>

## 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.

<CodeGroup>
  ```js JavaScript theme={null}
  //# sourceMappingURL=file.js.map
  ```
</CodeGroup>

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](/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.