Opslagruimte

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

Methoden

clear()

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

Verwijdert alle items uit de opslag.

Retourneert

  • Promise<void>

    Chrome 95+

    Een belofte die bij succes wordt ingelost en bij mislukking wordt afgewezen.

get()

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

Haalt een of meer artikelen uit de opslag.

Parameters

  • sleutels

    string | string[] | object optioneel

    Een enkele sleutel om op te halen, een lijst met sleutels om op te halen, of een woordenboek met standaardwaarden (zie de beschrijving van het object). Een lege lijst of een leeg object levert een leeg resultaatobject op. Geef null door om de volledige inhoud van de opslag op te halen.

Retourneert

  • Promise<object>

    Chrome 95+

    Een belofte die wordt opgelost met een object dat een sleutel-waardepaar bevat voor de gevraagde items, of die wordt afgewezen bij een fout.

getBytesInUse()

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

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

Parameters

  • sleutels

    string | string[] optioneel

    Een enkele sleutel of een lijst met sleutels om het totale gebruik te verkrijgen. Een lege lijst retourneert 0. Geef null door om het totale gebruik van alle opslagruimte te verkrijgen.

Retourneert

  • Belofte<nummer>

    Chrome 95+

    Een belofte die wordt opgelost zodra de opslag de gewenste ruimte heeft bereikt, of die wordt afgewezen bij een fout.

getKeys()

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

Haalt alle sleutels uit de opslag.

Retourneert

  • Promise<string[]>

    Een belofte die wordt opgelost met behulp van opslagsleutels, of wordt afgewezen bij een fout.

remove()

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

Haalt een of meer items uit de opslag.

Parameters

  • sleutels

    string | string[]

    Een enkele sleutel of een lijst met sleutels voor items die verwijderd moeten worden.

Retourneert

  • Promise<void>

    Chrome 95+

    Een belofte die bij succes wordt ingelost en bij mislukking wordt afgewezen.

set()

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

Stelt meerdere items in.

Parameters

  • items

    voorwerp

    Een object dat elk sleutel/waarde-paar levert waarmee de opslag moet worden bijgewerkt. Andere sleutel/waarde-paren in de opslag worden niet beïnvloed.

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

Retourneert

  • Promise<void>

    Chrome 95+

    Een belofte die bij succes wordt ingelost en bij mislukking wordt afgewezen.

setAccessLevel()

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

Hiermee stelt u het gewenste toegangsniveau voor het opslaggebied in. Standaard is session beperkt tot vertrouwde contexten (extensiepagina's en service workers), terwijl managed , local en sync toegang vanuit zowel vertrouwde als niet-vertrouwde contexten toestaan.

Parameters

  • toegangsopties

    voorwerp

    • toegangsniveau

      Toegangsniveau

      Het toegangsniveau van de opslagruimte.

Retourneert

  • Promise<void>

    Een belofte die bij succes wordt ingelost en bij mislukking wordt afgewezen.

Evenementen

onChanged

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

Wordt geactiveerd wanneer een of meer items veranderen.

Parameters

  • terugbelverzoek

    functie

    De callback parameter ziet er als volgt uit: 

    (changes: object) => void

    • veranderingen

      voorwerp