Firefox Tomorrow

web api instance method

StorageManager: persisted() method

View on MDN ↗

Secure context Available in workers

The persisted() method of the StorageManager interface returns a Promise that resolves to true if your site’s storage bucket is persistent.

Syntax

persisted()

Parameters

None.

Return value

A Promise that resolves to a Boolean.

Exceptions

  • TypeError
    • : Thrown if obtaining a local storage shelf failed. For example, if the current origin is an opaque origin or if the user has disabled storage.

Example

if (navigator.storage && navigator.storage.persist) {
  navigator.storage.persisted().then((persistent) => {
    if (persistent) {
      console.log("Storage will not be cleared except by explicit user action");
    } else {
      console.log("Storage may be cleared by the UA under storage pressure.");
    }
  });
}

Specifications

SpecificationsStandards references are available on the canonical MDN page.

Browser compatibility

Browser compatibilityCompatibility data is available on the canonical MDN page.