Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

Storage.getItem — lire une valeur de Web Storage

Storage.getItem(key) lit de façon synchrone du texte depuis localStorage ou sessionStorage. La méthode renvoie null si la clé n’existe pas ; une chaîne vide est une valeur présente, et non une entrée manquante.

Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

storage.getItem(key)

Storage.getItem est une méthode d’instance de Storage, utilisée par localStorage et sessionStorage. Elle accepte une clé sous forme de chaîne et renvoie le texte stocké, ou null si l’entrée n’existe pas. La lecture est synchrone et ne supprime pas l’entrée.

Distinguez null, "" et "null". Vérifiez l’absence avec value === null, et non avec !value, qui correspond aussi à une chaîne vide. Les nombres et objets stockés ne retrouvent pas automatiquement leurs types d’origine.

Il s’agit d’une API Web définie par le HTML Living Standard, et non d’une fonctionnalité d’une édition particulière d’ECMAScript. Elle est largement prise en charge par les navigateurs modernes ; la version de Node du dépôt ne permet pas d’établir la prise en charge par les navigateurs. L’accès à window.localStorage ou window.sessionStorage lui-même peut déclencher une SecurityError en raison d’une origine opaque ou d’une politique du navigateur.

L’exemple distingue une chaîne vide, la chaîne "42" et une entrée manquante. Il choisit une clé inutilisée et supprime l’entrée temporaire pour vérifier que la lecture renvoie null. Le bloc finally répète la suppression pour assurer le nettoyage même en cas d’erreur, sans effacer toute la zone de stockage.

Exemples

<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Storage.getItem: empty and missing values</title>
</head>
<body>
<h1>Reading a storage value</h1>
<p id="source"></p>
<script>
  function readValues(storage) {
    let key = 'cktis:getItem';
    while (storage.getItem(key) !== null) key += ':';

    try {
      storage.setItem(key, '');
      const empty = storage.getItem(key);
      storage.setItem(key, '42');
      const text = storage.getItem(key);
      storage.removeItem(key);
      return [JSON.stringify(empty), JSON.stringify(text), storage.getItem(key) === null];
    } finally {
      storage.removeItem(key);
    }
  }

  let lines;
  let source = 'Using browser sessionStorage.';
  try {
    lines = readValues(window.sessionStorage);
  } catch (error) {
    if (error.name !== 'SecurityError' && error.name !== 'QuotaExceededError') throw error;
    source = error.name === 'QuotaExceededError'
      ? 'Could not write the demo value to sessionStorage. Existing entries may still be readable. Using an in-memory fixture, not Web Storage.'
      : 'Browser storage is unavailable. Using an in-memory fixture, not Web Storage.';
    const entries = new Map();
    lines = readValues({
      getItem(key) { return entries.has(key) ? entries.get(key) : null; },
      setItem(key, value) { entries.set(key, String(value)); },
      removeItem(key) { entries.delete(key); }
    });
  }
  document.getElementById('source').textContent = source;
  for (const line of lines) console.log(line);
</script>
</body>
</html>

Résultat

""
"42"
true

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources