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 zu einem Array aufgelöst wird, das die Speicherobjektschlü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 Zugriff 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 dem fehlenden Support für den storage.managed_schema Manifest-Schlüssel (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}`));