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

# Options de configuration d'AppSignal pour JavaScript

export const Compatibility = ({versions = [], label = "Available in"}) => {
  if (!Array.isArray(versions) || versions.length === 0) {
    return null;
  }
  const defaultPillStyle = {
    borderColor: "#d4d4d8",
    background: "#f4f4f5",
    color: "#3f3f46"
  };
  const pillStyles = {
    "AppSignal for Elixir": {
      background: "#f3e8ff",
      borderColor: "#d8b4fe",
      color: "#6b21a8"
    },
    "AppSignal for Front-end": {
      background: "#fef9c3",
      borderColor: "#fde047",
      color: "#854d0e"
    },
    "AppSignal for Go": {
      background: "#ccfbf1",
      borderColor: "#5eead4",
      color: "#115e59"
    },
    "AppSignal for JavaScript": {
      background: "#fef9c3",
      borderColor: "#fde047",
      color: "#854d0e"
    },
    "AppSignal for Node.js": {
      background: "#dcfce7",
      borderColor: "#86efac",
      color: "#166534"
    },
    "AppSignal for Python": {
      background: "#dbeafe",
      borderColor: "#93c5fd",
      color: "#1e40af"
    },
    "AppSignal for Ruby": {
      background: "#fee2e2",
      borderColor: "#fca5a5",
      color: "#991b1b"
    },
    "AppSignal for Rust": {
      background: "#ffedd5",
      borderColor: "#fdba74",
      color: "#9a3412"
    }
  };
  const getPillStyle = name => ({
    ...defaultPillStyle,
    ...pillStyles[name] || ({})
  });
  return <div className="not-prose my-4 rounded-lg border border-zinc-200 bg-zinc-50 px-4 py-3 text-sm dark:border-white/10 dark:bg-white/5">
      <div className="flex flex-wrap items-center gap-x-2 gap-y-1">
        <span className="font-semibold text-zinc-700 dark:text-zinc-200">
          {label}:
        </span>
        {versions.map((v, i) => <span key={`${v.name}-${v.version}-${i}`} className="inline-flex items-center gap-1 rounded-full border px-2 py-0.5 text-xs font-medium" style={getPillStyle(v.name)}>
            <span>{v.name}</span>
            <span className="opacity-70">
              {v.version}
              {v.exact ? "" : "+"}
            </span>
          </span>)}
      </div>
    </div>;
};

La liste suivante inclut toutes les options de configuration avec le nom de la variable d'environnement et le nom de la clé dans le fichier de configuration.

Pour plus d'informations sur la façon de configurer AppSignal avec un fichier de configuration, consultez notre rubrique [Configuration](/front-end/configuration).

## `key`

* **Type :** `string`

<Tip>
  Cette option de configuration est **requise** pour envoyer des données à AppSignal. Si cette
  option de configuration n'est pas définie, AppSignal pour JavaScript fonctionnera en
  mode développement et aucune donnée ne sera envoyée à AppSignal.
</Tip>

La clé API de surveillance des erreurs front-end pour votre application. Vous pouvez trouver cette clé API sous « Front-end error monitoring » dans la section [« Push & Deploy »](https://appsignal.com/redirect-to/app?to=api_keys) des paramètres de votre application.

Ce n'est **pas** la même que la clé API au niveau de l'organisation ou de l'application, qui est utilisée pour la surveillance dans nos intégrations back-end.

## `namespace`

* **Type :** `string`
* **Valeur par défaut :** `"frontend"`

L'espace de noms par défaut à utiliser pour signaler les erreurs à AppSignal. En savoir plus dans notre [guide des espaces de noms](/guides/namespaces).

## `revision`

* **Type :** `string`

Définit la révision de l'application pour la version actuellement en cours d'exécution de votre application. Ceci est utilisé pour créer des marqueurs de déploiement et étiqueter toutes les données entrantes comme appartenant à un déploiement spécifique. En savoir plus dans notre [guide des marqueurs de déploiement](/application/markers/deploy-markers).

## `ignoreErrors`

* **Type :** `RegExp[]`

Un tableau d'expressions régulières à vérifier par rapport à la propriété `message` de toute erreur signalée à AppSignal. Si l'une des expressions régulières correspond, l'erreur est ignorée. En savoir plus dans notre [guide pour ignorer les erreurs](/guides/filter-data/ignore-actions).

## `matchBacktracePaths`

<Compatibility versions={[{ name: "AppSignal for JavaScript", version: "1.5.0" }]} />

* **Type :** `RegExp[]`

<Warning>
  Cette option de configuration est utile lors du développement d'applications pour des environnements
  de bureau et mobiles, ou lors du déploiement du même environnement applicatif sur plusieurs domaines.
  **La plupart des applications n'auront pas besoin d'utiliser cette option de configuration.**

  **L'utilisation de cette option de configuration interrompt la [détection automatique des
  sourcemaps publics](/front-end/sourcemaps#public-sourcemaps).** Pour utiliser cette
  option de configuration avec une base de code utilisant des sourcemaps, vous devez téléverser des sourcemaps
  privés pour votre application.

  Cette option de configuration est **expérimentale** et peut changer dans les versions futures.
</Warning>

Un tableau d'expressions régulières avec un ou plusieurs groupes de capture. Ces expressions régulières seront vérifiées par rapport aux chemins des lignes de backtrace des erreurs signalées à AppSignal. Si l'une des expressions régulières correspond avec un ou plusieurs groupes de capture non vides, le chemin dans la ligne de backtrace est remplacé par le résultat de la concaténation des groupes de capture.

Ceci est utile lorsque le chemin auquel votre application est déployée n'est pas connu à l'avance. Par exemple, le chemin vers une
application Electron peut être différent sur la machine de chaque utilisateur. Vous pouvez faire correspondre la partie de ce chemin qui est connue pour représenter
votre application.

Par exemple, si le code source de votre application se trouve à un chemin comme celui-ci, où `${USERNAME}` change pour chaque utilisateur :

<CodeGroup>
  ```sh Shell theme={null}
  /Users/${USERNAME}/Applications/MyApp.app/Contents/Resources/bundle/app.js`
  ```
</CodeGroup>

Vous pouvez alors utiliser cette option de configuration comme suit :

<CodeGroup>
  ```javascript JavaScript theme={null}
  const appsignal = new Appsignal({
    // ... other configuration options ...
    matchBacktracePaths: [new RegExp("MyApp.app/Contents/Resources/(.*)")],
  });
  ```
</CodeGroup>

Lorsqu'une erreur est signalée, les chemins des lignes de backtrace seront remplacés par le résultat du groupe de capture, qui dans cet exemple sera `bundle/app.js`.

Cela garantit que les erreurs signalées à AppSignal sont regroupées correctement lors de l'utilisation du regroupement par ligne de backtrace, et permet le téléversement de [sourcemaps privés](/api/sourcemaps) pour le chemin nettoyé.