StorageArea

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

Methoden

clear()

browser.storage.StorageArea.clear(): Promise<void>

Verwijdert alle items uit de opslag.

Retourzendingen

  • Promise<void>

    Chrome 95+ browser.* sinds Chrome 148

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

get()

browser.storage.StorageArea.get(
  keys?: string | string[] | object,
): 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.

Retourzendingen

  • Promise<object>

    Chrome 95+ browser.* sinds Chrome 148

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

getBytesInUse()

browser.storage.StorageArea.getBytesInUse(
  keys?: string | string[],
): 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.

Retourzendingen

  • Promise<number>

    Chrome 95+ browser.* sinds Chrome 148

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

getKeys()

Chrome 130+ browser.* sinds Chrome 148 
browser.storage.StorageArea.getKeys(): Promise<string[]>

Haalt alle sleutels op uit de opslag.

Retourzendingen

  • Promise<string[]>

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

remove()

browser.storage.StorageArea.remove(
  keys: string | string[],
): 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.

Retourzendingen

  • Promise<void>

    Chrome 95+ browser.* sinds Chrome 148

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

set()

browser.storage.StorageArea.set(
  items: object,
): 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).

Retourzendingen

  • Promise<void>

    Chrome 95+ browser.* sinds Chrome 148

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

setAccessLevel()

Chrome 102 of hoger browser.* sinds Chrome 148 
browser.storage.StorageArea.setAccessLevel(
  accessOptions: object,
): 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.

Retourzendingen

  • Promise<void>

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

Evenementen

onChanged

Chrome 73 of hoger browser.* sinds Chrome 148 
browser.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