Zum Hauptinhalt springen
AppSignal bietet hervorragende Unterstützung für das Abfangen von Fehlern aus Front-End-JavaScript-Anwendungen und das Senden an AppSignal. Dafür ist eine npm-Bibliothek zum Abfangen von JavaScript-Fehlern verfügbar.
Beginnen Sie bei einer neuen Front-end-Integration mit AppSignal für Browser, dem neueren Paket, das sich derzeit in der Beta befindet. Es erfasst nicht abgefangene Fehler, Breadcrumbs und Core Web Vitals ohne Plugins oder Konfiguration und meldet sie an den Browser-Bereich Ihrer Anwendung. @appsignal/javascript funktioniert weiterhin, neue Funktionen landen aber nur in @appsignal/browser. Um eine bestehende App umzustellen, folgen Sie dem Migrationsleitfaden.
HINWEIS: Nicht abgefangene Exceptions werden standardmäßig nicht erfasst. Lesen Sie diesen Abschnitt, um zu erfahren, warum. Sie können diese Funktionalität aktivieren, indem Sie das Plugin plugin-window-events aktivieren.

Unterstützte Browser

Dieses Paket kann in jedem ECMAScript-5-kompatiblen Browser verwendet werden. Wir streben Kompatibilität bis hinunter zu Internet Explorer 9 an (ungefähr 0,22 % aller heute verwendeten Browser). Alle älteren Browser können nur nach „bestem Bemühen” unterstützt werden, und volle Funktionalität kann nicht garantiert werden. Vergessen Sie bei der Entwicklung nicht, die Browser-Unterstützung auf Can I Use? und in der ES6-Kompatibilitätstabelle zu prüfen und entsprechende Polyfills oder Fallbacks bereitzustellen. In einem kleinen Prozentsatz der Browser kann ein Promise-Polyfill erforderlich sein, um diese Bibliothek zu verwenden.

Weitere unterstützte Umgebungen

@appsignal/javascript ist mehr als nur eine Front-End-Bibliothek! Sie ist auch dafür ausgelegt, in einer Vielzahl anderer JavaScript-Laufzeitumgebungen und Anwendungsfällen zu funktionieren, in denen die @appsignal/nodejs-Bibliothek möglicherweise keine geeignete Wahl ist. @appsignal/javascript unterstützt:

Serverless-Funktionen

Um Fehler aus einer Serverless-Funktion zu melden, initialisieren Sie AppSignal mit dem Front-end API key Ihrer App. AppSignal für JavaScript meldet nur Fehler, ohne Performance-Daten. Nicht abgefangene Fehler werden nicht automatisch gemeldet. Fangen Sie sie daher in Ihrem Handler ab und übergeben Sie sie an sendError. Warten Sie mit await darauf, bevor Ihre Funktion zurückkehrt. In Node.js wird sendError aufgelöst, bevor AppSignal antwortet. Es bestätigt also nicht die Zustellung:
Ein falscher Schlüssel schlägt stillschweigend fehl. sendError liest die Antwort der Push API nicht, daher erhalten Sie bei einem 401 weder eine Logzeile noch ein Incident. Lösen Sie nach Ihrem ersten Deploy einen Fehler aus und prüfen Sie, ob er in AppSignal erscheint.
Ausführliche Einrichtungsanweisungen und Konfigurationsoptionen finden Sie in der Installationsanleitung und der Konfigurationsdokumentation. Dieses Paket kann auch verwendet werden, um Fehler aus Cloudflare Workers zu melden. Für mobile Apps lesen Sie AppSignal for JavaScript mit React Native und Expo.