The maximum number of items that can be stored in sync storage. Updates
that would cause this limit to be exceeded will fail immediately and set
runtime.lastError when using a callback, or when a Promise is rejected.
The maximum number of set, remove, or clear operations that can be
performed each hour. This is 1 every 2 seconds, a lower ceiling than the
short term higher writes-per-minute limit.
The maximum number of set, remove, or clear operations that can be
performed each minute. This is 2 per second, providing higher throughput
than writes-per-hour over a shorter period of time.
The maximum total amount (in bytes) of data that can be stored in sync
storage, as measured by the JSON stringification of every value plus every
key's length. Updates that would cause this limit to be exceeded fail
immediately and set runtime.lastError when using a callback, or when a
Promise is rejected.
The maximum size (in bytes) of each individual item in sync storage, as
measured by the JSON stringification of its value plus its key length.
Updates containing items larger than this limit will fail immediately and
set runtime.lastError when using a callback, or when a Promise is
rejected.
Gets one or more items from storage.
keys A single key to get, list of keys to get, or a dictionary
specifying default values (see description of the object). An empty
list or object will return an empty result object. Pass in null to
get the entire contents of storage.
returns Promise that resolves with an object containing a key-value
map for the requested items, or rejects on failure.
Gets the amount of space (in bytes) being used by one or more items.
keys A single key or list of keys to get the total usage for. An empty
list will return 0. Pass in null to get the total usage of all of
storage.
returns Promise that resolves with the amount of space being used by
storage, or rejects on failure.
Removes one or more items from storage.
keys A single key or a list of keys for items to remove.
returns Promise that resolves on success, or rejects on failure.
Sets multiple items.
items An object which gives each key/value pair to update storage
with. Any other key/value pairs in storage will not be affected.
Sets the desired access level for the storage area. By default, session
storage is restricted to trusted contexts (extension pages and service
workers), while managed, local, and sync storage allow access from
both trusted and untrusted contexts.
returns Promise that resolves on success, or rejects on failure.