electron/docs/api/crash-reporter.md
Joseph Dykstra b6875ad49b Renamed browser-side to main process
renamed a few occurances of "web page" to "renderer"
renamed a few files that had "browser" in their name to "main-process"
note that there are still many occurances of web page.
2015-03-26 10:20:31 -05:00

1.8 KiB

crash-reporter

An example of automatically submitting crash reporters to remote server:

crashReporter = require('crash-reporter');
crashReporter.start({
  productName: 'YourName',
  companyName: 'YourCompany',
  submitUrl: 'https://your-domain.com/url-to-submit',
  autoSubmit: true
});

crashReporter.start(options)

  • options Object
    • productName String, default: Atom-Shell
    • companyName String, default: GitHub, Inc
    • submitUrl String, default: http://54.249.141.255:1127/post
      • URL that crash reports would be sent to as POST
    • autoSubmit Boolean, default: true
      • Send the crash report without user interaction
    • ignoreSystemCrashHandler Boolean, default: false
    • extra Object
      • An object you can define which content will be send along with the report.
      • Only string properties are send correctly.
      • Nested objects are not supported.

crashReporter.getLastCrashReport()

Returns the date and ID of last crash report, when there was no crash report sent or the crash reporter is not started, null will be returned.

crash-reporter payload

The crash reporter will send the following data to the submitUrl as POST:

  • rept String - e.g. 'atom-shell-crash-service'
  • ver String - The version of atom-shell
  • platform String - e.g. 'win32'
  • process_type String - e.g. 'renderer'
  • ptime Number
  • _version String - The version in package.json
  • _productName String - The product name in the crashReporter options object
  • prod String - Name of the underlying product. In this case Atom-Shell
  • _companyName String - The company name in the crashReporter options object
  • upload_file_minidump File - The crashreport as file
  • All level one properties of the extra object in the crashReporter options object