Suivi des erreurs PostHog pour Next.js

Cette skill vous aide à ajouter le suivi des erreurs PostHog aux applications Next.js.

Fichiers de référence

references/nextjs.md - Installation du suivi des erreurs Next.js - docs
references/fingerprints.md - Fingerprints - docs
references/alerts.md - Envoyer des alertes de suivi des erreurs - docs
references/monitoring.md - Surveiller et rechercher des 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 de l'API et les motifs spécifiques au framework.

Variables d'environnement : Utilisez toujours les variables d'environnement pour les clés PostHog et les URL d'hôte. Ne les codez jamais en dur.
Changements minimes : 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 d'abord : Activez la capture automatique 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 en code source original, 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.

Pour Next.js 15.3+, initialisez PostHog dans instrumentation-client.ts pour la configuration la plus simple
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 d'analytics dans les gestionnaires d'événements où les actions utilisateur se produisent, PAS dans useEffect réagissant aux 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 chaîner les mises à jour d'état - calculez toutes les mises à jour associées 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 au lieu d'utiliser useEffect
useEffect ne doit être utilisé QUE pour synchroniser avec les systèmes externes (widgets non-React, APIs du navigateur, souscriptions réseau)