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

Das `@appsignal/plugin-window-events`-Plugin bindet sich an die Event-Handler `window.onerror` und `window.onunhandledrejection`, um alle Fehler abzufangen, die andernfalls an anderer Stelle in Ihrem Code nicht erfasst würden.

## Installation

Fügen Sie die Pakete `@appsignal/plugin-window-events` und `@appsignal/javascript` zu Ihrer `package.json`-Datei hinzu und führen Sie `yarn install`/`npm install` aus.

Sie können diese Pakete auch auf der Kommandozeile zu Ihrer `package.json` hinzufügen:

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

## Verwendung

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

  ### Verwendung mit Next.js

  Auch mit `"use client"` rendert Next.js Client-Komponenten serverseitig vor, wo das `window`-Objekt nicht verfügbar ist. Schützen Sie die Plugin-Initialisierung mit:

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

## `plugin`-Optionen

Das `plugin` kann mit den folgenden Optionen initialisiert werden:

| Param                | Typ     | Beschreibung                                                                                                                                |
| -------------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
| onerror              | Boolean | (optional) Ein Boolean-Wert, der angibt, ob das Plugin sich an den `window.onerror`-Handler binden soll. Standardwert: `true`.              |
| onunhandledrejection | Boolean | (optional) Ein Boolean-Wert, der angibt, ob das Plugin sich an den `window.onunhandledrejection`-Handler binden soll. Standardwert: `true`. |