CrashReportContext: initialize() method

Note: This feature is available in Web Workers.

The initialize() method of the CrashReportContext interface initializes a portion of memory to be used for storing crash report data specified by set(). This must be called before any other method is invoked on the object.

Syntax

js
initialize(length)

Parameters

length

A number indicating the maximum number of bytes that can be stored in the key-value store by each individual set() call. The maximum allowable value is 5 * 1024 * 1024 (5MB), which is also the maximum amount of crash report memory allowed for one origin.

Return value

A Promise that fulfills with undefined.

Exceptions

InvalidStateError DOMException

Thrown if:

  • The calling document is not fully active.
  • A crash report key-value store was already initialized by a previous initialize() call.
NotAllowedError DOMException

length is more than 5 * 1024 * 1024.

Examples

Basic usage

js
window.crashReport.initialize(1024).then(() => {
  // Do stuff with crash reporting API
});

Specifications

Specification
Crash Reporting
# dom-crashreportcontext-initialize

Browser compatibility

See also