Capture d'erreurs frontend (beacon JS navigateur) : voyez enfin ce qui casse côté visiteur
Capture d'erreurs frontend (beacon JS navigateur) une fonctionnalité du module Intelligence des erreurs & RGPD de Clustraly. La capture d'erreurs frontend est un beacon JavaScript qui remonte les erreurs du navigateur de vos visiteurs vers votre console d'intelligence des erreurs.
Une erreur JavaScript côté visiteur ne laisse aucune trace dans vos logs serveur. Un beacon léger la remonte à votre console d'intelligence des erreurs caviardée, plafonnée et entièrement sous votre contrôle.
Les erreurs de vos visiteurs, enfin visibles
Vos logs serveur ne montreront jamais l'exception JavaScript qui a figé un parcours dans le navigateur d'un visiteur. Le beacon la capte au moment où elle survient et la remonte au même endroit que vos erreurs backend.
Message, source et pile d'appels arrivent automatiquement dans votre console d'intelligence des erreurs. Vous arrêtez de piloter à l'aveugle ce qui se passe côté client.
- Les exceptions JS de vos visiteurs, dans la même console que vos erreurs backend
- Message, source et pile d'appels remontés automatiquement
- Aucune action côté visiteur : le tracker est injecté pour vous
Un script injecté, un endpoint dédié
Une configuration protégée par nonce et le script error-tracker.js sont injectés dans le pied de page public, avec un taux d'échantillonnage : chaque session envoie uniquement ce qu'il faut, pas plus.
Les erreurs partent vers l'endpoint public POST /api/client-error, sans session ni CSRF, rangé dans le bucket de rate-limit « api ». La charge utile est plafonnée à 16 Ko et l'endpoint répond toujours 204.
- Script error-tracker.js injecté dans le footer avec nonce et taux d'échantillonnage
- Endpoint public POST /api/client-error, sans session ni CSRF
- Charge utile plafonnée à 16 Ko, réponse toujours 204
- Trafic rangé dans le bucket de rate-limit « api »
Là où le front vous échappe habituellement
Après un déploiement, une régression purement front peut passer inaperçue pendant des jours. Un script tiers qui casse sur un navigateur précis, un parcours qui se fige côté client : autant de pannes qui n'atteignent jamais vos serveurs.
Le beacon transforme ces angles morts en évènements exploitables, reliés au reste de votre intelligence des erreurs.
- Détecter une régression front juste après un déploiement
- Repérer un script tiers qui casse sur certains navigateurs
- Comprendre un parcours qui se fige côté client
Ouvert au public, mais tenu en laisse
L'endpoint est public, donc traité comme non fiable par principe. Le message, la source et la pile reçus sont caviardés avant d'être normalisés en évènement de type « frontend », et un plafond global anti-flood par heure borne l'ingestion.
La capture reste conditionnée par ERROR_CAPTURE_FRONTEND : désactivée, elle devient un no-op silencieux. Et parce que l'endpoint répond toujours 204, il ne révèle jamais s'il écoute ou non.
- Charge utile non fiable caviardée avant tout stockage
- Plafond global anti-flood par heure sur les beacons
- Activation contrôlée par ERROR_CAPTURE_FRONTEND (no-op silencieux si désactivé)
- Réponse 204 systématique : aucune fuite d'information
Capté côté client, traité comme le reste
Une fois normalisée, l'erreur frontend rejoint le flux commun : dédupliquée en groupe par empreinte, dotée de son cycle de vie, éligible à l'alerting et au diagnostic IA au même titre qu'une erreur backend.
L'IA peut proposer une cause probable et un correctif à partir des données déjà caviardées. La décision, elle, vous revient toujours.
- Normalisée en évènement « frontend » et dédupliquée par empreinte
- Éligible au diagnostic IA : une cause probable proposée, vous tranchez
- Alerting et cycle de vie partagés avec vos erreurs backend
L'IA propose, vous décidez
La capture frontend se contente de remonter le fait brut, caviardé. Ensuite seulement, le diagnostic IA peut suggérer une cause probable et un correctif mais c'est vous qui validez chaque décision, jamais l'inverse.
Questions fréquentes
Le beacon collecte-t-il des données personnelles de mes visiteurs ?
Que se passe-t-il si un bug déclenche des milliers d'erreurs d'un coup ?
Comment activer ou désactiver la capture frontend ?
Les erreurs frontend se retrouvent-elles avec mes erreurs backend ?
Fonctionnalités liées
Console d'intelligence des erreurs (liste groupée)
Consulter • Filtrer • Rechercher • Déclencher test
DécouvrirDétail d'un groupe d'erreurs
Afficher pile • Voir contexte • Lire breadcrumbs • Consulter timeline
DécouvrirGestion du cycle de vie (statut)
Changer statut • Résoudre • Détecter régression • Supprimer groupe
DécouvrirRendez visibles les erreurs de vos visiteurs
Activez la capture d'erreurs frontend et cessez de piloter à l'aveugle ce qui casse dans le navigateur. Beacon léger, données caviardées, plafonds anti-flood : la visibilité côté client, sans le bruit et sans jamais perdre la main sur les décisions.