Crash
Le report crash signale le plantage ou le blocage du renderer de page, livré une fois la page disparue.
Dernière mise à jour:
Un report crash vous indique que le processus renderer d'une page a planté ou s'est figé. Comme la page ne tourne plus, c'est le processus principal du navigateur qui construit le report quand il constate la mort du renderer. C'est pour cette raison que le crash reporting exige un endpoint serveur et ne peut pas être capté dans la page. Le payload est volontairement minimal, par souci de confidentialité.
Chromium uniquement
Le crash reporting est un brouillon du WICG, pas un standard W3C, et seul Chromium l'implémente. Le body est volontairement réduit.
Quand le navigateur l'envoie
Quand le processus renderer plante (par manque de mémoire, par exemple) ou est tué parce qu'il ne répondait plus. Chromium met le report en file dans le processus principal dès qu'il détecte le renderer mort, puis le livre au cycle de livraison suivant, comme n'importe quel report, à l'endpoint de reporting par défaut, ou à un endpoint nommé crash-reporting si la page en a déclaré un (Chrome 139+). Aucun chargement ultérieur n'est nécessaire, mais la file reste en mémoire : si le navigateur entier plante ou est fermé avant, le report est perdu. Un arrêt manuel depuis le gestionnaire de tâches ou une fermeture normale n'envoie aucun report. ReportingObserver ne peut pas le voir passer dans la page, puisque celle-ci a déjà disparu : seul l'endpoint serveur permet de le recevoir.
Exemple de payload
{
"type": "crash",
"age": 27,
"url": "https://example.com/",
"user_agent": "Mozilla/5.0 ...",
"body": {
"is_top_level": true,
"visibility_state": "visible",
"crash_report_api": {
"checkout_step": "payment"
},
"reason": "oom"
}
}Le body d'un report crash contient ces champs, à l'intérieur de l'enveloppe de report commune.
Référence des champs
| Champ | Signification |
|---|---|
reason | oom (manque de mémoire) ou unresponsive. Absent quand le navigateur ne sait pas pourquoi le renderer s'est arrêté. |
is_top_level | Si le document qui a planté était la page de premier niveau. |
visibility_state | Si la page était visible ou hidden à ce moment-là. |
crash_report_api | Les paires clé/valeur que la page a stockées avec window.crashReport.set() (Chrome 145+). Toujours présent dans Chromium, vide si la page n'a rien stocké. |
stack | Une pile d'appels JS, incluse uniquement quand reason vaut unresponsive, que la page envoie Document-Policy: include-js-call-stacks-in-crash-reports et que Chromium a pu la collecter. Quand le script bloqué appartient à un autre frame du même processus, la valeur est Unable to collect JS call stack. |
Le champ crash_report_api vient de l'API de contexte de crash : la page appelle une
fois await window.crashReport.initialize(taille) (jusqu'à 5 Mo), puis
window.crashReport.set(clé, valeur) et delete(clé) pour conserver un état
applicatif (une route, une étape de paiement) que le navigateur joint au report si la
page plante. N'y stockez jamais de données personnelles.
Comment le recevoir
Déclarez un endpoint default dans Reporting-Endpoints, ou un endpoint crash-reporting pour séparer les reports de crash du reste. Le report arrive hors bande dans le délai de livraison habituel (environ une minute) après le crash, et l'URL de son enveloppe est celle de la page qui a planté. CentralCSP collecte les signaux de crash aux côtés de vos autres reports.
Reporting-Endpoints: crash-reporting="https://<Endpoint-ID>.report.centralcsp.com"Ce qu'il vous apprend sur la sécurité
La plupart des crashs relèvent de la stabilité, mais leur répétition est un signal : des crashs par manque de mémoire ou des blocages qui se concentrent sur une page ou sur un même script peuvent trahir un déni de service, ou un script tiers défaillant (voire hostile).
Pièges
Les noms des champs du body sont en snake_case. Les contraintes de confidentialité maintiennent le body au minimum : la pile d'appels JS n'apparaît jamais en dehors de la Document-Policy indiquée ci-dessus, et crash_report_api ne contient que ce que la page a elle-même stocké.
Prise en charge par les navigateurs
Navigateurs basés sur Chromium uniquement ; pas Baseline. Les autres moteurs n'émettent pas de crash reports.
Voir aussi
- Document-Policy
- Fonctionnement de la Reporting API
- Reports de crash et de non-réponse du navigateur
- Monitoring des crashs dans CentralCSP
- Header Reporting-Endpoints
- Le format de livraison des rapports