@appsignal/stimulus meldet Fehler aus Ihren Stimulus-Controllern an AppSignal. Es unterstützt Version 3 des Pakets @hotwired/stimulus sowie Version 1.1 und spätere 1.x-Versionen des Pakets stimulus.
Installation
Mit npm oder yarn
Fügen Sie die Pakete@appsignal/stimulus und @appsignal/javascript zu Ihrer package.json hinzu. Führen Sie dann yarn install/npm install aus.
Sie können diese Pakete auch auf der Kommandozeile zu Ihrer package.json hinzufügen:
Mit JSPM.io Import Maps
Mit dem JSPM.io Import Map Generator können Sie eine Import Map für die Abhängigkeiten Ihrer Anwendung generieren. Fügen Sie@appsignal/javascript und @appsignal/stimulus zur Liste der Abhängigkeiten im Generator hinzu, und integrieren Sie dann die generierte Import Map sowie ES-Module-Shims in den Code Ihrer Anwendung.
Mit rails-importmap
Verwenden Sie den folgenden Befehl, um diese Pakete zu den Import Maps Ihrer Rails-Anwendung hinzuzufügen:
Verwendung
Application.handleError
installErrorHandler meldet Fehler, die Stimulus abfängt, an AppSignal. Als Action-Name verwendet es den Identifier des Controllers oder [unknown Stimulus controller], wenn es keinen gibt. Außerdem fügt es die Tags framework und message hinzu. Anschließend ruft es den vorherigen handleError auf, der den Fehler standardmäßig in der Browserkonsole protokolliert.
Übergeben Sie installErrorHandler Ihre Appsignal-Instanz und Ihre Stimulus-Anwendung. Wie Sie die Appsignal-Instanz erstellen, lesen Sie in der Installationsanleitung.
Rails 7 und neuer
Apps mit Rails 7 und neuer importieren Stimulus aus dem Paket@hotwired/stimulus. Eine neue App verteilt die Stimulus-Einrichtung auf zwei Dateien in app/javascript/controllers/:
application.jsstartet die Stimulus-Anwendung und exportiert sie.index.jsimportiert diese Anwendung und registriert Ihre Controller.
application.js, nach Application.start(). Die Datei index.js muss nicht geändert werden.
Stimulus 1.x mit Webpacker
Apps, die Stimulus 1.x aus dem Paketstimulus mit Webpacker verwenden, installieren den Error-Handler in javascript/controllers/index.js. In einer neuen, beispielsweise mit rails new $APP_NAME --webpack=stimulus erstellten App würde diese Datei etwa so aussehen: