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

# Installation d'AppSignal pour JavaScript

Veuillez d'abord suivre le [guide d'installation](/guides/new-application) lorsque vous ajoutez une nouvelle application à AppSignal.

## Création d'une clé API Push

Avant de commencer, vous devez trouver votre clé API Push dans la section [« Push and deploy »](https://appsignal.com/redirect-to/app?to=info) de la page des paramètres de votre application. Vous trouverez votre clé API sous « Front-end error monitoring ». Une fois que vous avez votre clé, suivez les instructions de la section [Installation](#installation) pour l'utiliser dans votre application.

## Installation

### Avec npm ou yarn

Tout d'abord, ajoutez le package `@appsignal/javascript` à votre `package.json`. Ensuite, exécutez `yarn install`/`npm install`. Vous aurez également besoin d'une clé Front-end error monitoring depuis la section [« Push and deploy »](https://appsignal.com/redirect-to/app?to=info) de la page des paramètres de votre application.

Vous pouvez également ajouter ces packages à votre `package.json` en ligne de commande :

<CodeGroup>
  ```bash Bash theme={null}
  yarn add @appsignal/javascript
  npm install @appsignal/javascript
  ```
</CodeGroup>

### Avec JSPM.dev

<Warning>
  Il n'est pas recommandé d'utiliser le CDN JSPM.dev en production. Pour
  une configuration prête pour la production sans étape de build, nous recommandons d'utiliser
  [les import maps JSPM.io](#with-jspmio-import-maps).
</Warning>

Grâce au CDN JSPM, il est possible d'utiliser l'intégration AppSignal pour JavaScript sans étape de build des assets front-end. Votre application peut importer les packages directement depuis le CDN :

<CodeGroup>
  ```js JavaScript theme={null}
  import Appsignal from "https://jspm.dev/@appsignal/javascript";
  ```
</CodeGroup>

### Avec les import maps JSPM.io

Avec le [générateur d'import maps JSPM.io](https://generator.jspm.io/), vous pouvez générer une import map pour les dépendances de votre application.

Ajoutez `@appsignal/javascript` à la liste des dépendances, puis ajoutez l'import map générée et les shims des modules ES au code de votre application.

### Avec `rails-importmap`

Utilisez la commande suivante pour ajouter ces packages aux import maps de votre application Rails :

<CodeGroup>
  ```sh Shell theme={null}
  ./bin/importmap pin @appsignal/javascript
  ```
</CodeGroup>

## Utilisation

Créez un fichier `appsignal.js` pour requérir et configurer AppSignal. Depuis ce fichier, nous exportons l'instance de l'objet `Appsignal` que nous utiliserons depuis notre application. Pour plus d'informations sur la configuration, consultez notre [section configuration](/front-end/configuration).

<CodeGroup>
  ```javascript JavaScript theme={null}
  // For ES Module via npm/yarn, or with import maps
  import Appsignal from "@appsignal/javascript";
  // For CommonJS module via npm/yarn
  const Appsignal = require("@appsignal/javascript").default;
  // With the JSPM.dev CDN
  import Appsignal from "https://jspm.dev/@appsignal/javascript";

  export const appsignal = new Appsignal({
    key: "YOUR FRONTEND API KEY",
  });
  ```
</CodeGroup>

Vous pouvez alors importer et utiliser l'objet `Appsignal` dans votre application :

<CodeGroup>
  ```javascript JavaScript theme={null}
  // Place this at the top
  // Import the file created in the previous step
  import { appsignal } from "./appsignal";

  // Place your app code below this
  ```
</CodeGroup>

<Warning>
  **REMARQUE :** Si vous utilisez un CDN devant vos assets, vous devrez
  apporter [deux modifications](/front-end/troubleshooting) pour que le rapport d'erreurs
  puisse envoyer les erreurs à notre point d'accès API. Lisez-en plus sur les [modifications
  requises](/front-end/troubleshooting).

  Si vous utilisez une Content Security Policy, assurez-vous d'ajouter les bons en-têtes comme
  [décrit
  ici](/front-end/troubleshooting#content-security-policy-csp).
</Warning>

## Ajouter des intégrations

Votre application utilise peut-être un framework ou une bibliothèque qu'AppSignal prend en charge.
Veuillez consulter la section [intégrations](/front-end/integrations) pour toute bibliothèque utilisée par votre application et suivez les instructions pour ajouter l'instrumentation pour ces bibliothèques.

[Ajouter des intégrations à votre application](/front-end/integrations).

## Ajouter des plugins

AppSignal propose également des plugins pour les fonctionnalités JavaScript dans le navigateur.
Veuillez consulter la section [plugins](/front-end/plugins) pour toute instrumentation supplémentaire que vous souhaiteriez ajouter à votre application.

[Ajouter des plugins à votre application](/front-end/plugins).

## Rapport d'erreurs personnalisé

Vous n'utilisez pas de framework ou de bibliothèque, mais souhaitez signaler les erreurs JavaScript manuellement ?
Utilisez notre [API Span](/front-end/span) pour créer des spans sur lesquels signaler les erreurs, ajouter des tags et davantage de métadonnées.
Lisez ensuite notre [guide de gestion des erreurs](/front-end/error-handling) pour savoir comment signaler les erreurs à AppSignal.

***

<Note>
  📖 Poursuivez avec notre [guide d'installation](/guides/new-application).
</Note>

## Désinstallation

Désinstallez AppSignal de votre application en suivant les étapes ci-dessous. Une fois ces étapes terminées, votre application n'enverra plus de données aux serveurs AppSignal.

1. Dans le `package.json` de votre application, supprimez toutes les lignes faisant référence à un package `appsignal` : `"*appsignal/*": "*"`.

2. Exécutez `npm install` ou `yarn install` pour mettre à jour votre `package.lock`/`yarn.lock` avec l'état des packages supprimés.
   * Vous pouvez également exécuter `npm uninstall @appsignal/<package name>` ou `yarn remove @appsignal/<package name>` pour désinstaller un package AppSignal.

3. Supprimez toute [configuration](/front-end/configuration/) AppSignal de votre application.

4. Validez, déployez et redémarrez votre application.
   * Cela garantira que les serveurs AppSignal ne continueront pas à recevoir des données de votre application.

5. Enfin, [supprimez l'application](/guides/application/deleting-applications) sur AppSignal.com.

<Note>
  📖 Poursuivez avec notre [guide de
  désinstallation](/guides/application/deleting-applications).
</Note>