StorageArea

refresh date: 2026-09-25 robots: noindex

De StorageArea-interface wordt gebruikt door de chrome.storage API.

Methoden

clear()

Promise 
chrome.storage.StorageArea.clear(
  callback?: function,
): Promise<void>

Verwijdert alle items uit de opslag.

Parameters

  • callback

    functie optioneel

    De parameter callback ziet er zo uit: 

    () => void

Retourzendingen

  • Promise<void>

    Chrome 95+

    Promise die wordt opgelost bij succes of wordt afgewezen bij mislukking.

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

get()

Promise 
chrome.storage.StorageArea.get(
  keys?: string | string[] | object,
  callback?: function,
): Promise<object>

Haalt een of meer items op uit de opslag.

Parameters

  • sleutels

    string | string[] | object optioneel

    Eén sleutel die moet worden opgehaald, een lijst met sleutels die moeten worden opgehaald of een woordenboek met standaardwaarden (zie de beschrijving van het object). Een lege lijst of een leeg object retourneert een leeg resultaatobject. Geef null door om de hele content van de opslag op te halen.

  • callback

    functie optioneel

    De parameter callback ziet er zo uit: 

    (items: object) => void

    • items

      object

      Object met items in de sleutel/waarde-toewijzingen.

Retourzendingen

  • Promise<object>

    Chrome 95+

    Promise die wordt omgezet met een object dat een sleutel/waarde-toewijzing bevat voor de gevraagde items of die wordt geweigerd bij een fout.

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

getBytesInUse()

Promise 
chrome.storage.StorageArea.getBytesInUse(
  keys?: string | string[],
  callback?: function,
): Promise<number>

Haalt de hoeveelheid ruimte (in bytes) op die door een of meer items wordt gebruikt.

Parameters

  • sleutels

    string | string[] optioneel

    Eén sleutel of een lijst met sleutels waarvoor je het totale gebruik wilt ophalen. Een lege lijst retourneert 0. Geef null door om het totale gebruik van alle opslag te krijgen.

  • callback

    functie optioneel

    De parameter callback ziet er zo uit: 

    (bytesInUse: number) => void

    • bytesInUse

      getal

      De hoeveelheid gebruikte opslagruimte, in bytes.

Retourzendingen

  • Promise<number>

    Chrome 95+

    Promise die wordt omgezet in de hoeveelheid ruimte die wordt gebruikt door opslag of die wordt afgewezen bij een fout.

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

getKeys()

Promise Chrome 130+ 
chrome.storage.StorageArea.getKeys(
  callback?: function,
): Promise<string[]>

Haalt alle sleutels op uit de opslag.

Parameters

  • callback

    functie optioneel

    De parameter callback ziet er zo uit: 

    (keys: string[]) => void

    • sleutels

      tekenreeks[]

      Matrix met sleutels die zijn gelezen uit de opslag.

Retourzendingen

  • Promise<string[]>

    Promise die wordt omgezet met opslagsleutels of wordt afgewezen bij een fout.

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

remove()

Promise 
chrome.storage.StorageArea.remove(
  keys: string | string[],
  callback?: function,
): Promise<void>

Verwijdert een of meer items uit de opslag.

Parameters

  • sleutels

    tekenreeks | tekenreeks[]

    Eén sleutel of een lijst met sleutels voor items die je wilt verwijderen.

  • callback

    functie optioneel

    De parameter callback ziet er zo uit: 

    () => void

Retourzendingen

  • Promise<void>

    Chrome 95+

    Promise die wordt opgelost bij succes of wordt afgewezen bij mislukking.

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

set()

Promise 
chrome.storage.StorageArea.set(
  items: object,
  callback?: function,
): Promise<void>

Stelt meerdere items in.

Parameters

  • items

    object

    Een object dat elk sleutel/waarde-paar geeft waarmee de opslag moet worden geüpdatet. Andere sleutel/waarde-paren in de opslag worden niet beïnvloed.

    Primitieve waarden zoals getallen worden geserialiseerd zoals verwacht. Waarden met een typeof "object" en "function" worden meestal geserialiseerd naar {}, met uitzondering van Array (wordt geserialiseerd zoals verwacht), Date en Regex (worden geserialiseerd met hun String-weergave).

  • callback

    functie optioneel

    De parameter callback ziet er zo uit: 

    () => void

Retourzendingen

  • Promise<void>

    Chrome 95+

    Promise die wordt opgelost bij succes of wordt afgewezen bij mislukking.

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

setAccessLevel()

Promise Chrome 102+ 
chrome.storage.StorageArea.setAccessLevel(
  accessOptions: object,
  callback?: function,
): Promise<void>

Hiermee stel je het gewenste toegangsniveau voor de opslagruimte in. Standaard is session-opslag beperkt tot vertrouwde contexten (extensiepagina's en servicemedewerkers), terwijl managed-, local- en sync-opslag toegang bieden vanuit zowel vertrouwde als niet-vertrouwde contexten.

Parameters

  • accessOptions

    object

    • accessLevel

      AccessLevel

      Het toegangsniveau van de opslagruimte.

  • callback

    functie optioneel

    De parameter callback ziet er zo uit: 

    () => void

Retourzendingen

  • Promise<void>

    Promise die wordt opgelost bij succes of wordt afgewezen bij mislukking.

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

Evenementen

onChanged

Chrome 73+ 
chrome.storage.StorageArea.onChanged.addListener(
  callback: function,
)

Wordt geactiveerd als een of meer items worden gewijzigd.

Parameters

  • callback

    functie

    De parameter callback ziet er zo uit: 

    (changes: object) => void

    • veranderingen

      object