electron/lib/common/crash-reporter.js

'use strict'

const binding = process.electronBinding('crash_reporter')

class CrashReporter {
  constructor () {
    this.productName = null
    this.crashesDirectory = null
  }

  init (options) {
    throw new Error('Not implemented')
  }

  start (options) {
    if (options == null) options = {}

    const {
      productName,
      companyName,
      extra = {},
      ignoreSystemCrashHandler = false,
      submitURL,
      uploadToServer = true
    } = options

    if (companyName == null) throw new Error('companyName is a required option to crashReporter.start')
    if (submitURL == null) throw new Error('submitURL is a required option to crashReporter.start')

    const ret = this.init({
      submitURL,
      productName
    })

    this.productName = ret.productName
    this.crashesDirectory = ret.crashesDirectory

    if (extra._productName == null) extra._productName = ret.productName
    if (extra._companyName == null) extra._companyName = companyName
    if (extra._version == null) extra._version = ret.appVersion

    binding.start(ret.productName, companyName, submitURL, ret.crashesDirectory, uploadToServer, ignoreSystemCrashHandler, extra)
  }

  getLastCrashReport () {
    const reports = this.getUploadedReports()
      .sort((a, b) => {
        const ats = (a && a.date) ? new Date(a.date).getTime() : 0
        const bts = (b && b.date) ? new Date(b.date).getTime() : 0
        return bts - ats
      })

    return (reports.length > 0) ? reports[0] : null
  }

  getUploadedReports () {
    const crashDir = this.getCrashesDirectory()
    if (!crashDir) {
      throw new Error('crashReporter has not been started')
    }

    return binding.getUploadedReports(crashDir)
  }

  getCrashesDirectory () {
    return this.crashesDirectory
  }

  getUploadToServer () {
    if (process.type === 'browser') {
      return binding.getUploadToServer()
    } else {
      throw new Error('getUploadToServer can only be called from the main process')
    }
  }

  setUploadToServer (uploadToServer) {
    if (process.type === 'browser') {
      return binding.setUploadToServer(uploadToServer)
    } else {
      throw new Error('setUploadToServer can only be called from the main process')
    }
  }

  addExtraParameter (key, value) {
    binding.addExtraParameter(key, value)
  }

  removeExtraParameter (key) {
    binding.removeExtraParameter(key)
  }

  getParameters () {
    return binding.getParameters()
  }
}

module.exports = CrashReporter