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

# @appsignal/stimulus

## Instalação

### Com npm ou yarn

Adicione os pacotes `@appsignal/stimulus` e `@appsignal/javascript` ao seu `package.json`. Em seguida, 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/stimulus
  npm install @appsignal/javascript @appsignal/stimulus
  ```
</CodeGroup>

### Com import maps do JSPM.io

Usando o [gerador de import maps do JSPM.io](https://generator.jspm.io/), você pode gerar um import map para as dependências da sua aplicação.

Adicione `@appsignal/javascript` e `@appsignal/stimulus` à lista de dependências no gerador, depois adicione o import map gerado e o ES module shims ao código da sua aplicação.

### Com `rails-importmap`

Use o comando a seguir para adicionar esses pacotes aos import maps da sua aplicação Rails:

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

## Uso

### `Application.handleError`

A integração padrão do Stimulus é uma função que se vincula à propriedade `Application.handleError`. Em uma nova aplicação criada usando `rails new $APP_NAME --webpack=stimulus`, por exemplo, seu arquivo `javascript/controllers/index.js` se pareceria com algo assim:

<CodeGroup>
  ```js JavaScript theme={null}
  import { Application } from "stimulus";
  import { definitionsFromContext } from "stimulus/webpack-helpers";

  import { appsignal } from "./appsignal";
  import { installErrorHandler } from "@appsignal/stimulus";

  const application = Application.start();
  installErrorHandler(appsignal, application);
  const context = require.context("controllers", true, /_controller\.js$/);
  application.load(definitionsFromContext(context));
  ```
</CodeGroup>