Storage.setItem()

Il metodo setItem(), che fa parte della funzionalità Storage , quando passa il nome di una chiave e un valore, aggiunge questa chiave allo storage, oppure se la chiave esiste già aggiorna il valore della chiave stessa.

Sintassi

storage.setItem(keyName, keyValue);

Parametri

keyName

Il DOMString contiene il nome della chiave che si vuole creare o aggiornare.

keyValue

Il DOMString contiene il valore che si vuole dare alla chiave che si sta creando o aggiornando.

Valore di ritorno

Void.

Eccezioni

setItem() potrebbe dar luogo a eccezioni se lo storage è pieno. Ad esempio, in Safari Mobile (da iOS 5) non è possibile salvare dati quando l'utente è in modalità in incognito (questo perché Safari non alloca spazio per l'utente nella modalità in incognito, al contrario degli altri browsers, i quali permettono di usare lo storage nella modalità in incognito, salvando i dati in uno spazio apposito e separato). Quindi è sempre meglio implementare delle funzioni che gestiscano le eccezzioni quando si usa setItem().

Esempi

Le seguenti funzioni creano tre oggetti all'interno del local storage:

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

Specifiche

Compatibilità dei browser

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!

Tutti i browser hanno diversi livelli di gestione sia del localStorage che del sessionStorage. Qui trovi ulteriori dettagli.

Altre informazioni

Come usare le Web Storage API