Window localStorage

❮ Previous ❮ Window Object Reference Next ❯

Example

Set and retrieve localStorage name/value pair:

localStorage.setItem("lastname", "Smith");
localStorage.getItem("lastname");

Try it Yourself »

More examples below.

Description

The localStorage object allows you to save key/value pairs in the browser.

Note

The localStorage object stores data with no expiration date.

The data is not deleted when the browser is closed, and are available for future sessions.

Syntax

window.localStorage

or just:

localStorage

Save Data to Local Storage

localStorage.setItem(key, value);

Read Data from Local Storage

let lastname = localStorage.getItem(key);

Remove Data from Local Storage

localStorage.removeItem(key);

Remove All (Clear Local Storage)

localStorage.clear();

Parameters

Parameter	Description
key	Required. The name of a key.
value	Required. The value of the key.

Return Value

Type	Description
An object	A localStorage object.

More Examples

Count the number of times a user has clicked a button:

if (localStorage.clickcount) {
localStorage.clickcount = Number(localStorage.clickcount) + 1;
} else {
localStorage.clickcount = 1;
}