Suivi des erreurs PostHog pour Web (JavaScript)

Cette skill vous aide à ajouter le suivi des erreurs PostHog à vos applications Web (JavaScript).

Fichiers de référence

references/web.md - Installation du suivi des erreurs Web - docs
references/fingerprints.md - Fingerprints - docs
references/alerts.md - Envoyer des alertes de suivi des erreurs - docs
references/monitoring.md - Surveiller et rechercher les problèmes - docs
references/assigning-issues.md - Assigner des problèmes aux coéquipiers - docs
references/upload-source-maps.md - Télécharger les source maps - docs

Consultez la documentation pour les détails d'API et les patterns spécifiques aux frameworks.

Variables d'environnement : Utilisez toujours les variables d'environnement pour les clés PostHog et les URLs d'hôte. Ne les codez jamais en dur.
Changements minimaux : Ajoutez le suivi des erreurs aux côtés de la gestion des erreurs existante. Ne remplacez pas ou ne restructurez pas le code de gestion des erreurs existant.
Autocapture en premier : Activez l'autocapture des exceptions dans l'initialisation du SDK avant d'ajouter des captures manuelles.
Source maps : Téléchargez les source maps pour que les stack traces se résolvent au code source original, pas aux bundles minifiés.
Capture manuelle pour les boundaries : Utilisez captureException() aux error boundaries et dans les blocs catch pour les erreurs qui ne se propagent pas au gestionnaire global.

Souvenez-vous que le code source est disponible dans le répertoire node_modules
Vérifiez package.json pour les scripts de type checking ou de build afin de valider les changements
posthog-js est le nom du package du SDK JavaScript
posthog.init() DOIT être appelé avant toute autre méthode PostHog (capture, identify, etc.)
posthog-js est réservé au navigateur — NE L'IMPORTEZ PAS dans les contextes Node.js ou côté serveur (utilisez posthog-node à la place)
L'autocapture est ACTIVÉ par défaut avec posthog-js (suit les clics, soumissions de formulaires, pageviews). NE DÉSACTIVEZ PAS l'autocapture sauf si l'utilisateur le demande explicitement.
N'ENVOYEZ JAMAIS d'informations personnelles (PII) dans les propriétés d'événements posthog.capture() — pas d'emails, noms complets, numéros de téléphone, adresses physiques, adresses IP ou contenus générés par l'utilisateur
Les PII appartiennent aux propriétés de personne posthog.identify() (email, nom, rôle), PAS aux propriétés d'événements capture()
Appelez posthog.identify(userId, { email, name, role }) à la connexion ET lors du rafraîchissement de la page si l'utilisateur est déjà connecté
Appelez posthog.reset() à la déconnexion pour délier les futurs événements de l'utilisateur actuel
Pour les SPAs sans routeur de framework, capturez les pageviews avec posthog.capture($pageview) ou utilisez l'option capture_pageview history_change dans init pour le routage History API