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

O plugin `@appsignal/plugin-window-events` se vincula aos handlers de evento `window.onerror` e `window.onunhandledrejection` para capturar quaisquer erros que de outra forma não sejam capturados em outra parte do seu código.

## Instalação

Adicione os pacotes `@appsignal/plugin-window-events` e `@appsignal/javascript` ao seu arquivo `package.json` e execute `yarn install`/`npm install`.

Você também pode adicionar esses pacotes ao seu `package.json` pela linha de comando:

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

## Uso

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

  ### Uso com Next.js

  Mesmo com `"use client"`, o Next.js pré-renderiza componentes client no servidor, onde o objeto `window` não está disponível. Proteja a inicialização do plugin com:

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

## Opções do `plugin`

O `plugin` pode ser inicializado com as seguintes opções:

| Parâmetro            | Tipo    | Descrição                                                                                                                      |
| -------------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------ |
| onerror              | Boolean | (opcional) Um valor booleano que indica se o plugin deve se vincular ao handler `window.onerror`. Padrão: `true`.              |
| onunhandledrejection | Boolean | (opcional) Um valor booleano que indica se o plugin deve se vincular ao handler `window.onunhandledrejection`. Padrão: `true`. |