StorageManager.persisted()

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

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

The persisted property of the StorageManager interface returns a Promise that resolves to true if box mode is persistent for your site's storage.

Syntax

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

Parameters

None.

Returns

A Promise that resolves to a Boolean.

Example

if (navigator.storage && navigator.storage.persist) 
  navigator.storage.persisted().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
Storage
The definition of 'persisted' in that specification.
Living Standard Initial definition.

Browser Compatibility

Update compatibility data on GitHub
DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidEdge MobileFirefox for AndroidOpera for AndroidiOS SafariSamsung Internet
Basic supportChrome Full support 52
Full support 52
No support 48 — 52
Alternate Name
Alternate Name Uses the non-standard name: persistentPermission
Edge ? Firefox Full support 55IE ? Opera Full support YesSafari ? WebView Android Full support 52
Full support 52
No support 48 — 52
Alternate Name
Alternate Name Uses the non-standard name: persistentPermission
Chrome Android Full support 52
Full support 52
No support 48 — 52
Alternate Name
Alternate Name Uses the non-standard name: persistentPermission
Edge Mobile ? Firefox Android Full support 55Opera Android Full support YesSafari iOS ? Samsung Internet Android ?

Legend

Full support  
Full support
Compatibility unknown  
Compatibility unknown
Uses a non-standard name.
Uses a non-standard name.

Document Tags and Contributors

Contributors to this page: ddbeck, chrisdavidmills, YourDoge, shawn_huang, david_ross, jpmedley
Last updated by: ddbeck,