StorageArea.get()
Récupère un ou plusieurs éléments de la zone de stockage.
C'est une fonction asynchrone qui renvoie une Promise
.
Syntaxe
Paramètres
keys
-
Une clé (chaîne) ou des clés (un tableau de chaînes ou un objet spécifiant des valeurs par défaut) pour identifier le ou les articles à extraire du stockage. Si vous passez un objet ou un tableau vide ici, un objet vide sera récupéré. Si vous passez
null
, ou une valeur indéfinie, le contenu entier du stockage sera récupéré.
Valeur retournée
Une Promise
qui sera remplie avec un objet de resultat
contenant tous les objets dans les clefs
trouvées dans la zone de stockage. Si l'opération a échoué, la promesse sera rejetée avec un message d'erreur. Si le stockage géré n'est pas défini, les données non définies
seront retournées.
Attention : Lorsqu'elle est utilisée dans un script de contenu dans les versions de Firefox antérieures à 52, la promesse retournée par browser.storage.local.get()
est remplie avec un tableau contenant un objet. L'objet dans le tableau contient les clefs
trouvées dans la zone de stockage, comme décrit ci-dessus. La promesse est correctement remplie avec un objet lorsqu'il est utilisé dans le contexte d'arrière-plan
(scripts d'arrière-plan, popups, pages d'options, etc.). Lorsque cette API est utilisée en tant que chrome.storage.local.get()
, elle transmet correctement un objet à la fonction de rappel.
Compatibilité des navigateurs
BCD tables only load in the browser
Exemples
Supposons que le stockage contienne deux éléments :
// storage contains two items,
// "kitten" and "monster"
browser.storage.local.set({
kitten: { name: "Mog", eats: "mice" },
monster: { name: "Kraken", eats: "people" },
});
Définissez les gestionnaires de réussite et d'échec pour la promesse:
function onGot(item) {
console.log(item);
}
function onError(error) {
console.log(`Error: ${error}`);
}
Sans arguments clefs
, tout récupérez :
let gettingItem = browser.storage.local.get();
gettingItem.then(onGot, onError);
// -> Object { kitten: Object, monster: Object }
Avec un argument de clefs vide, ne retourne rien:
// with an empty array, retrieve nothing
let gettingItem = browser.storage.local.get([]);
gettingItem.then(onGot, onError);
// -> Object { }
Avec le nom d'un objet, récupérez la correspondance :
let gettingItem = browser.storage.local.get("kitten");
gettingItem.then(onGot, onError);
// -> Object { kitten: Object }
Avec un tableau de noms d'objets, récupérez toutes les correspondances :
let gettingItem = browser.storage.local.get([
"kitten",
"monster",
"grapefruit",
]);
gettingItem.then(onGot, onError);
// -> Object { kitten: Object, monster: Object }
Avec un objet avec des noms d'objets en tant que clefs et la valeur par défaut en tant que valeur :
let gettingItem = browser.storage.local.get({
kitten: "no kitten",
monster: "no monster",
grapefruit: {
name: "Grape Fruit",
eats: "Water",
},
});
// -> Object { kitten: Object, monster: Object, grapefruit: Object }
Chrome exemples
chrome.storage.local.get("kitten", function (items) {
console.log(items.kitten); // -> {name:"Mog", eats:"mice"}
});
Ou avec une fonction de flèche
chrome.storage.local.get("kitten", (items) => {
console.log(items.kitten); // -> {name:"Mog", eats:"mice"}
});
Note :
Cette API est basée sur l'API Chromium chrome.storage
. Cette documentation est dérivée de storage.json
dans le code de Chromium.
Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis.