StorageArea.getKeys()
Ruft die Schlüssel aller Elemente in einem Speicherbereich ab.
Syntax
let results = browser.storage.<storageType>.getKeys();
Wobei <storageType> einer der Speichertypen ist — sync, local, session, oder managed.
Parameter
Diese Methode nimmt keine Parameter entgegen.
Rückgabewert
Ein Promise, das in ein Array aufgelöst wird, das die Speicherartikel-Schlüssel enthält.
Wenn die Operation fehlschlägt, wird das Promise mit einer Fehlermeldung abgelehnt.
Wenn verwalteter Speicher nicht gesetzt ist, wird undefined zurückgegeben.
Warnung:
In Firefox wird eine Ausnahme ausgelöst, wenn der verwaltete Speicher einer Erweiterung nicht mit einem nativen Manifest oder mittels der 3rdparty Unternehmensrichtlinie konfiguriert wurde und diese Funktion zum Zugreifen auf verwalteten Speicher verwendet wird (siehe Firefox-Bug 1868153). Dieses Problem kann vermieden werden, indem der Fehler abgefangen wird. Dieses Problem steht im Zusammenhang mit der fehlenden Unterstützung des storage.managed_schema Manifest-Schlüssels (siehe Firefox-Bug 1771731).
Beispiele
Angenommen, der Speicher enthält zwei Elemente:
// storage contains two items, "kitten" and "monster"
browser.storage.local.set({
kitten: { name: "Mog", eats: "mice" },
monster: { name: "Kraken", eats: "people" },
});
Rufen Sie die Schlüssel aller Elemente in storage.local ab und protokollieren Sie das Ergebnis.
browser.storage.local
.getKeys()
.then((keys) => console.log(keys)) // [ "kitten", "monster" ]
.catch((err) => console.error(`Error: ${err}`));
Browser-Kompatibilität
Loading…