storage.managed

Ein storage.StorageArea Objekt, das den managed Speicherbereich repräsentiert. Elemente im managed Speicher werden vom Domain-Administrator oder anderen nativen Anwendungen, die auf dem Computer des Benutzers installiert sind, festgelegt und sind für die Erweiterung schreibgeschützt. Versuche, diesen Speicherbereich zu ändern, führen zu einem Fehler.

Bereitstellung von verwaltetem Speicher

Das Verfahren zur Bereitstellung von verwaltetem Speicher variiert zwischen den Browsern. Für Anweisungen zu Chrome siehe den Artikel "Manifest für Speicherbereiche".

Für Firefox müssen Sie eine JSON-Manifestdatei in einem bestimmten Format und Standort erstellen. Für die Details zur Manifestsyntax und zum Standort siehe Native Manifeste.

Hier ist ein Beispielmanifest:

json
{
  "name": "favourite-colour-examples@mozilla.org",
  "description": "ignored",
  "type": "storage",
  "data": {
    "colour": "management thinks it should be blue!"
  }
}

Mit diesem Manifest könnte die favourite-colour Erweiterung auf die Daten mit folgendem Code zugreifen:

js
let storageItem = browser.storage.managed.get("colour");
storageItem.then((res) => {
  console.log(`Managed colour is: ${res.colour}`);
});

Methoden

Das managed Objekt implementiert die auf dem storage.StorageArea Typ definierten Methoden:

storage.managed.get()

Ruft ein oder mehrere Elemente aus dem Speicherbereich ab.

storage.managed.getBytesInUse()

Gibt den für ein oder mehrere Elemente im Speicherbereich genutzten Speicherplatz (in Bytes) zurück.

Ereignisse

Das managed Objekt implementiert die auf dem storage.StorageArea Typ definierten Ereignisse:

storage.managed.onChanged

Wird ausgelöst, wenn sich ein oder mehrere Elemente im Speicherbereich ändern.

Beispiel-Erweiterungen

Browser-Kompatibilität

BCD tables only load in the browser

Hinweis: Diese API basiert auf der chrome.storage API von Chromium. Diese Dokumentation leitet sich von storage.json im Chromium-Code ab.