@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.jsinicia a aplicação Stimulus e a exporta.index.jsimporta essa aplicação e registra seus controllers.
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 pacotestimulus 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: