Pular para o conteúdo principal
O pacote @appsignal/stimulus reporta ao AppSignal os erros dos seus controllers Stimulus. Ele suporta a versão 3 do pacote @hotwired/stimulus e a versão 1.1 e versões 1.x posteriores do pacote 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:

Com import maps do JSPM.io

Usando o gerador de import maps do 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:

Uso

Application.handleError

installErrorHandler reporta ao AppSignal os erros que o Stimulus captura. Ele usa o identificador do controller como nome da action, ou [unknown Stimulus controller] se não houver um. Ele também adiciona as tags framework e message. Em seguida, chama o handleError anterior, que por padrão registra o erro no console do navegador. Passe para installErrorHandler sua instância Appsignal e sua aplicação Stimulus. Para criar a instância Appsignal, veja o guia de instalação.

Rails 7 e posteriores

Aplicações Rails 7 e posteriores importam o Stimulus do pacote @hotwired/stimulus. Uma nova aplicação divide a configuração do Stimulus em dois arquivos em app/javascript/controllers/:
  • application.js inicia a aplicação Stimulus e a exporta.
  • index.js importa essa aplicação e registra seus controllers.
Instale o error handler em application.js, depois de Application.start(). O arquivo index.js não precisa de nenhuma alteração.

Stimulus 1.x com Webpacker

Aplicações que usam o Stimulus 1.x do pacote stimulus com Webpacker instalam o error handler em javascript/controllers/index.js. Em uma nova aplicação criada usando rails new $APP_NAME --webpack=stimulus, por exemplo, esse arquivo se pareceria com algo assim: