Storage.removeItem()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

La méthode removeItem() de l'interface Storage , lorsque vous lui passez une clé en argument, va supprimer la ressource avec le nom de clé correspondant du storage. L'interface Storage de l'API Web Storage API fournit des accès particuliers dans les domaines des stockages locaux et de sessions.

Si aucun élement n'est donné en paramètre nomCle, cette méthode ne fait rien.

Syntaxe

js
storage.removeItem(nomCle);

Paramètres

nomCle

Un DOMString contenant le nom de la clé que vous voulez supprimer.

Valeur de retour

Exemple

La fonction suivante crée trois données dans le stockage local, puis va supprimer la donnée image.

js
function populateStorage() {
  localStorage.setItem("bgcolor", "red");
  localStorage.setItem("font", "Helvetica");
  localStorage.setItem("image", "myCat.png");

  localStorage.removeItem("image");
}

Nous pouvons également faire ceci avec le stockage de session.

js
function populateStorage() {
  sessionStorage.setItem("bgcolor", "red");
  sessionStorage.setItem("font", "Helvetica");
  sessionStorage.setItem("image", "myCat.png");

  sessionStorage.removeItem("image");
}

Note : Pour voir ce code en fonctionnement, voir Web Storage Demo.

Spécifications

Specification
HTML Standard
# dom-storage-removeitem-dev

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi