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

# plugin-window-events

Le plugin `@appsignal/plugin-window-events` se lie aux gestionnaires d'événements `window.onerror` et `window.onunhandledrejection` pour intercepter toutes les erreurs qui ne sont pas autrement interceptées ailleurs dans votre code.

## Installation

Ajoutez les packages `@appsignal/plugin-window-events` et `@appsignal/javascript` à votre fichier `package.json` et exécutez `yarn install`/`npm install`.

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

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

## Utilisation

<CodeGroup>
  ```javascript JavaScript theme={null}
  import { plugin } from `@appsignal/plugin-window-events`
  appsignal.use(plugin(options));
  ```

  ### Utilisation avec Next.js

  Même avec `"use client"`, Next.js effectue le pré-rendu des composants client côté serveur, où l'objet `window` n'est pas disponible. Protégez l'initialisation du plugin avec :

  ```javascript JavaScript theme={null}
  if (typeof window !== "undefined") {
    appsignal.use(plugin(options));
  }
  ```
</CodeGroup>

## Options de `plugin`

Le `plugin` peut être initialisé avec les options suivantes :

| Param                | Type    | Description                                                                                                                                 |
| -------------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
| onerror              | Boolean | (optionnel) Une valeur booléenne indiquant si le plugin doit se lier au gestionnaire `window.onerror`. Vaut `true` par défaut.              |
| onunhandledrejection | Boolean | (optionnel) Une valeur booléenne indiquant si le plugin doit se lier au gestionnaire `window.onunhandledrejection`. Vaut `true` par défaut. |