Suivi des erreurs PostHog pour React
Cette skill vous aide à ajouter le suivi des erreurs PostHog aux applications React.
Fichiers de référence
references/react.md- Installation du suivi des erreurs React - docsreferences/fingerprints.md- Fingerprints - docsreferences/alerts.md- Envoyer des alertes de suivi des erreurs - docsreferences/monitoring.md- Surveiller et rechercher les problèmes - docsreferences/assigning-issues.md- Assigner les problèmes aux coéquipiers - docsreferences/upload-source-maps.md- Télécharger les source maps - docs
Consultez la documentation pour les détails de l'API et les modèles spécifiques au framework.
Principes clés
- 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.
- Modifications minimales : Ajoutez le suivi des erreurs aux côtés de la gestion des erreurs existante. Ne remplacez ni ne restructurez 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 afin que les stack traces se résolvent en code source d'origine, pas en bundles minifiés.
- Capture manuelle pour les limites : Utilisez
captureException()aux error boundaries et dans les blocs catch pour les erreurs qui ne se propagent pas au gestionnaire global.
Directives du framework
- Pour les feature flags, utilisez les hooks useFeatureFlagEnabled() ou useFeatureFlagPayload() - ils gèrent les états de chargement et la synchronisation externe automatiquement
- Ajoutez la capture analytics dans les gestionnaires d'événements où les actions utilisateur se produisent, PAS dans useEffect en réaction à des changements d'état
- N'utilisez PAS useEffect pour la transformation de données - calculez les valeurs dérivées pendant le rendu à la place
- N'utilisez PAS useEffect pour répondre aux événements utilisateur - mettez cette logique dans le gestionnaire d'événement lui-même
- N'utilisez PAS useEffect pour enchaîner les mises à jour d'état - calculez toutes les mises à jour connexes ensemble dans le gestionnaire d'événement
- N'utilisez PAS useEffect pour notifier les composants parents - appelez le callback parent aux côtés de setState dans le gestionnaire d'événement
- Pour réinitialiser l'état du composant quand une prop change, passez la prop comme clé du composant à la place d'utiliser useEffect
- useEffect est SEULEMENT pour la synchronisation avec les systèmes externes (widgets non-React, APIs du navigateur, souscriptions réseau)