storage.managed

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

Bereitstellung von managed storage

Das Verfahren zur Bereitstellung von managed storage 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 Manifeste) Datei in einem bestimmten Format und an einem bestimmten 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 folgendem Code zugreifen:

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

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

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()

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

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.

Beispielerweiterungen

Browser-Kompatibilität

Hinweis: Diese API basiert auf der chrome.storage API von Chromium. Diese Dokumentation ist aus storage.json im Chromium-Code abgeleitet.