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. Der Versuch, diesen Speicherbereich zu ändern, führt zu einem Fehler.

Bereitstellung von verwaltetem Speicher

Das Verfahren zur Bereitstellung von verwaltetem Speicher variiert je nach Browser. Für Anweisungen zu Chrome siehe den Artikel "Manifest for storage areas".

Für Firefox müssen Sie eine JSON-Manifeste (native Manifest) Datei in einem bestimmten Format und Ort erstellen oder die 3rdparty-Unternehmensrichtlinie verwenden.

Hier ist ein Beispiel für ein natives Manifest:

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 Code wie diesem zugreifen:

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

Hinweis: In Firefox ist ein Neustart des Browsers erforderlich, um Änderungen am JSON-Manifest oder an der Richtlinie in den verwalteten Speicher zu laden. In anderen Browsern erfolgt das Laden von Änderungen dynamisch.

Methoden

Das managed-Objekt implementiert die Methoden, die im storage.StorageArea-Typ definiert sind:

storage.managed.get()

Ruft ein oder mehrere Elemente aus dem Speicherbereich ab.

storage.managed.getBytesInUse()

Bestimmt den Speicherplatz (in Bytes), der für ein oder mehrere Elemente im Speicherbereich verwendet wird.

storage.managed.getKeys()

Ruft die Schlüssel aller Elemente im Speicherbereich ab.

Ereignisse

Das managed-Objekt implementiert die Ereignisse, die im storage.StorageArea-Typ definiert sind:

storage.managed.onChanged

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

Beispielerweiterungen

Browser-Kompatibilität

Hinweis: Diese API basiert auf Chromiums chrome.storage API. Diese Dokumentation stammt von storage.json im Chromium-Code.