Opslagruimte

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

Methoden

clear()

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

Verwijdert alle items uit de opslag.

Parameters

  • terugbelverzoek

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    () => void

Retourneert

  • Promise<void>

    Chrome 95+

    Promises worden alleen ondersteund voor Manifest V3 en later; voor andere platforms moeten callbacks worden gebruikt.

get()

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

  • terugbelverzoek

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    (items: object) => void

    • items

      voorwerp

      Object met items in hun sleutel-waardeparen.

Retourneert

  • Promise<object>

    Chrome 95+

    Promises worden alleen ondersteund voor Manifest V3 en later; voor andere platforms moeten callbacks worden gebruikt.

getBytesInUse()

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

  • terugbelverzoek

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    (bytesInUse: number) => void

    • bytesInUse

      nummer

      De hoeveelheid gebruikte opslagruimte, in bytes.

Retourneert

  • Belofte<nummer>

    Chrome 95+

    Promises worden alleen ondersteund voor Manifest V3 en later; voor andere platforms moeten callbacks worden gebruikt.

getKeys()

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

Haalt alle sleutels uit de opslag.

Parameters

  • terugbelverzoek

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    (keys: string[]) => void

    • sleutels

      snaar[]

      Array met sleutels die uit het geheugen zijn gelezen.

Retourneert

  • Promise<string[]>

    Promises worden alleen ondersteund voor Manifest V3 en later; voor andere platforms moeten callbacks worden gebruikt.

remove()

Belofte
chrome.storage.StorageArea.remove(
  keys: string | string[],
  callback?: function,
): 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.

  • terugbelverzoek

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    () => void

Retourneert

  • Promise<void>

    Chrome 95+

    Promises worden alleen ondersteund voor Manifest V3 en later; voor andere platforms moeten callbacks worden gebruikt.

set()

Belofte
chrome.storage.StorageArea.set(
  items: object,
  callback?: function,
): 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).

  • terugbelverzoek

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    () => void

Retourneert

  • Promise<void>

    Chrome 95+

    Promises worden alleen ondersteund voor Manifest V3 en later; voor andere platforms moeten callbacks worden gebruikt.

setAccessLevel()

Promise Chrome 102+
chrome.storage.StorageArea.setAccessLevel(
  accessOptions: object,
  callback?: function,
): 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.

  • terugbelverzoek

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    () => void

Retourneert

  • Promise<void>

    Promises worden alleen ondersteund voor Manifest V3 en later; voor andere platforms moeten callbacks worden gebruikt.

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