WorkletSharedStorage: length() method
Deprecated: This feature is no longer recommended. Though some browsers might still support it, it may have already been removed from the relevant web standards, may be in the process of being dropped, or may only be kept for compatibility purposes. Avoid using it, and update existing code if possible; see the compatibility table at the bottom of this page to guide your decision. Be aware that this feature may cease to work at any time.
The length() method of the
WorkletSharedStorage interface returns the number of entries currently stored in shared storage for the current origin.
Syntax
js
length()
Parameters
None.
Return value
A Promise that fulfills with a number, which represents the total count of key-value pairs currently in the shared storage.
Exceptions
TypeError-
Thrown if:
- The worklet module has not yet been added with
addModule(). - The calling site does not have the Shared Storage API included in a successful privacy sandbox enrollment process.
- The browser fails to retrieve the number of entries for some other reason.
- The worklet module has not yet been added with
Examples
js
// length() available inside a shared storage worklet module
async function retrieveLength() {
const length = await this.sharedStorage.length();
console.log(length);
}