Web/API/StorageManager/persist

Secure contextThis feature is available only in secure contexts (HTTPS), in some or all supporting browsers.

This is an experimental technologyCheck the Browser compatibility table carefully before using this in production.

The persist() method of the StorageManager interface requests permission to use persistent storage, and returns a Promise that resolves to true if permission is granted and box mode is persistent, and false otherwise.

Syntax

navigator.storage.persist().then(function(persistent) { ... })

Parameters

None.

Return value

A Promise that resolves to a Boolean.

Example

if (navigator.storage && navigator.storage.persist)
  navigator.storage.persist().then(function(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

Specification	Status	Comment
StorageThe definition of 'persist' in that specification.	Living Standard	Initial definition.

Browser Compatibility

Update compatibility data on GitHub

	Desktop						Mobile
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
`persist`	Chrome Full support 52 Full support 52 No support 48 — 52 Alternate Name' Alternate Name' Uses the non-standard name: `requestPersistent`	Edge Full support ≤79	Firefox Full support 55	IE No support No	Opera Full support Yes	Safari ?	WebView Android Full support 52 Full support 52 No support 48 — 52 Alternate Name' Alternate Name' Uses the non-standard name: `requestPersistent`	Chrome Android Full support 52 Full support 52 No support 48 — 52 Alternate Name' Alternate Name' Uses the non-standard name: `requestPersistent`	Firefox Android Full support 55	Opera Android Full support Yes	Safari iOS ?	Samsung Internet Android Full support 6.0 Full support 6.0 No support 5.0 — 6.0 Alternate Name' Alternate Name' Uses the non-standard name: `requestPersistent`

Legend

Full support: Full support
No support: No support
Compatibility unknown: Compatibility unknown
Uses a non-standard name.': Uses a non-standard name.

StorageManager.persist() by Mozilla Contributors is licensed under CC-BY-SA 2.5.