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:
{
"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:
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.