Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Storage.setItem — memorizzare e sostituire un valore

Storage.setItem memorizza testo associandolo a una chiave in localStorage o sessionStorage e sostituisce il valore precedente. La scrittura può non riuscire: occorre quindi considerare le eccezioni e le restrizioni di accesso allo spazio di archiviazione.

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

Sintassi

storage.setItem(key, value)

Chiama Storage.setItem su un oggetto localStorage o sessionStorage: storage.setItem(key, value). Il metodo crea una voce o sostituisce il valore di una chiave esistente e restituisce undefined. Questa API fa parte dello standard HTML, non di una specifica edizione di ECMAScript. I motori dei browser moderni la supportano; la presenza di Node 24 in un repository non dimostra la disponibilità di un’API del browser.

Le chiavi e i valori vengono convertiti in stringhe. Per memorizzare un oggetto, serializzalo esplicitamente in una stringa. Quando leggi il valore memorizzato, lo spazio di archiviazione restituisce una stringa che l’applicazione deve decodificare secondo il formato usato in scrittura. Se scrivi dati in formato JSON con JSON.stringify, usa JSON.parse per decodificare quella stringa. localStorage conserva i dati di un’origine tra le sessioni, mentre sessionStorage è anche separato in base al contesto di navigazione di primo livello, solitamente una scheda. I dati possono essere eliminati.

Una scrittura non riuscita può generare QuotaExceededError; anche il solo accesso allo spazio di archiviazione può generare SecurityError. Racchiudi accesso e scrittura in try/catch se l’applicazione deve funzionare senza spazio di archiviazione. Scrivere una stringa identica non cambia nulla. La notifica storage riguarda altri documenti idonei, non la finestra che esegue la scrittura.

Esempi

<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Storage.setItem: writing and replacing text</title>
</head>
<body>
<h1>Replacing a storage value</h1>
<p id="source"></p>
<script>
  function writeValues(storage) {
    let key = 'cktis:setItem';
    while (storage.getItem(key) !== null) key += ':';

    try {
      storage.setItem(key, 'first');
      const before = storage.getItem(key);
      storage.setItem(key, 'second');
      return [before, storage.getItem(key)];
    } finally {
      storage.removeItem(key);
    }
  }

  let lines;
  let source = 'Using browser sessionStorage.';
  try {
    lines = writeValues(window.sessionStorage);
  } catch (error) {
    if (error.name !== 'SecurityError' && error.name !== 'QuotaExceededError') throw error;
    source = 'Browser storage is unavailable. Using an in-memory fixture, not Web Storage.';
    const entries = new Map();
    lines = writeValues({
      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>

Risultato

first
second

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti