Récupère un ou plusieurs éléments de la zone de stockage.

C'est une fonction asynchrone qui renvoie une Promise.

Syntaxe

let gettingItem = browser.storage.<storageType>.get(
  keys    // null, string, object or array of strings
)

<storageType> sera l'un des types de stockage accessibles en écriture — sync, local, ou managed.

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 une chaîne vide, un objet ou un tableau ici, un objet vide sera récupéré. un objet vide sera récupéré 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.

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é du navigateur

Update compatibility data on GitHub
OrdinateurMobile
ChromeEdgeFirefoxOperaFirefox pour Android
Support simpleChrome Support complet OuiEdge Support complet 14Firefox Support complet 45Opera Support complet 33Firefox Android Support complet 48

Légende

Support complet  
Support complet

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"}
});
Remerciements :

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.

Étiquettes et contributeurs liés au document

Contributeurs à cette page : hellosct1
Dernière mise à jour par : hellosct1,