error-tracking-react

Par posthog · skills

Suivi des erreurs PostHog pour React

npx skills add https://github.com/posthog/skills --skill error-tracking-react

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 - 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 les 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 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)

Skills similaires