crashReporter

Soumet un rapport de plantage à un serveur distant.

Voici un exemple d'envoi automatique d'un rapport de plantage à un serveur distant :

const { crashReporter } = require('electron')

crashReporter.start({ submitURL: 'https://your-domain.com/url-to-submit' })

Pour configurer un serveur pour accepter et traiter les rapports de plantage, vous pouvez utiliser les projets suivants :

Note : Electron utilise Crashpad et non Breakpad pour collecter and enregistrer les crashs, mais pour le moment le protocole d'upload est le même .

Ou utilisez une solution hébergée par un tiers :

Les rapports de plantage sont stockés temporairement avant d'être téléchargés dans un répertoire sous le répertoire de données utilisateur de l'application, appelé 'Crashpad'. You can override this directory by calling app.setPath('crashDumps', '/path/to/crashes') before starting the crash reporter.

Electron utilise crashpad pour surveiller et signaler les plantages.

Méthodes

Le module crashReporter dispose des méthodes suivantes :

`crashReporter.start(options)`

Objet options
- submitURL string (optional) - URL that crash reports will be sent to as POST. Required unless uploadToServer is false.
- productName string (facultatif) - app.name.
- companyName string (optional) Deprecated - Deprecated alias for { globalExtra: { _companyName: ... } }.
- uploadToServer boolean (optional) - Whether crash reports should be sent to the server. If false, crash reports will be collected and stored in the crashes directory, but not uploaded. La valeur par défaut est true.
- ignoreSystemCrashHandler boolean (optional) - If true, crashes generated in the main process will not be forwarded to the system crash handler. Par défaut la valeur est false.
- rateLimit boolean (optional) macOS Windows - If true, limit the number of crashes uploaded to 1/hour. Par défaut la valeur est false.
- compress boolean (optional) - If true, crash reports will be compressed and uploaded with Content-Encoding: gzip. La valeur par défaut est true.
- extra Record<string, string> (optional) - Extra string key/value annotations that will be sent along with crash reports that are generated in the main process. Only string values are supported. Crashes generated in child processes will not contain these extra parameters to crash reports generated from child processes, call addExtraParameter from the child process.
- globalExtra Record<string, string> (optional) - Extra string key/value annotations that will be sent along with any crash reports generated in any process. These annotations cannot be changed once the crash reporter has been started. If a key is present in both the global extra parameters and the process-specific extra parameters, then the global one will take precedence. By default, productName and the app version are included, as well as the Electron version.

Cette méthode doit être appelée avant d'utiliser d'autres API crashReporter. Once initialized this way, the crashpad handler collects crashes from all subsequently created processes. The crash reporter cannot be disabled once started.

This method should be called as early as possible in app startup, preferably before app.on('ready'). If the crash reporter is not initialized at the time a renderer process is created, then that renderer process will not be monitored by the crash reporter.

Note: You can test out the crash reporter by generating a crash using process.crash().

Note: If you need to send additional/updated extra parameters after your first call start you can call addExtraParameter.

Note: Parameters passed in extra, globalExtra or set with addExtraParameter have limits on the length of the keys and values. Key names must be at most 39 bytes long, and values must be no longer than 127 bytes. Keys with names longer than the maximum will be silently ignored. Key values longer than the maximum length will be truncated.