Storage: setItem() method

keyName

A string containing the name of the key you want to create/update.

keyValue

A string containing the value you want to give the key you are creating/updating.

None (undefined).

setItem() may throw an exception if the storage is full. Developers should make sure to always catch possible exceptions from setItem().

The following function creates three data items inside local storage.

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

Storage only supports storing and retrieving strings. If you want to save other data types, you have to convert them to strings. For plain objects and arrays, you can use JSON.stringify().

const person = { name: "Alex" };
localStorage.setItem("user", person);
console.log(localStorage.getItem("user")); // "[object Object]"; not useful!
localStorage.setItem("user", JSON.stringify(person));
console.log(JSON.parse(localStorage.getItem("user"))); // { name: "Alex" }

However, there's no generic way to store arbitrary data types. Furthermore, the retrieved object is a deep copy of the original object and mutations to it do not affect the original object.

• Storage.getItem()
• Storage.removeItem()
• Using the Web Storage API