CentralCSP
Reporting APITypes de rapports

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

ChampSignification
reasonoom (manque de mémoire) ou unresponsive. Absent quand le navigateur ne sait pas pourquoi le renderer s'est arrêté.
is_top_levelSi le document qui a planté était la page de premier niveau.
visibility_stateSi la page était visible ou hidden à ce moment-là.
crash_report_apiLes 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é.
stackUne 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

Sources

On this page