Firmware Engineer, Minimalist, Improving Runner

Store your data with HTML5 local storage

Local storage is a pretty cool feature included in HTML5.

It allows data to be stored on the client-side via a simple key/value database. Data saved by a page, up to 5MB, resides in the user's browser and is accessible only by pages from the same domain. In other words, local storage data saved by cannot be accessed by

Keys can be initialized with the API, square bracket, or dot notation:

$ localStorage.setItem('name', 'Alex')

$ localStorage['name'] = 'Alex'

$ = 'Alex'

Keys can be read by the same methods. To retrieve the 'name' key's value:

$ localStorage.getItem('name')

$ localStorage['name']


.clear() removes all keys and values in the domain's local storage:

$ localStorage.clear()
$ localStorage.getItem('name'))

Other API functions include:

  • .removeItem(key)
  • .key(index)
  • .length

Here's a simple demo I threw together. The code is available at github. It's an editable list whose values can be saved to local storage. If applicable, the list is populated with these values every time the page is reloaded or re-opened!

There are plenty of reasons to use web storage. The state of an application can be saved, data can be cached to improve performance, user preferences can be stored, page counts can be tracked. The use-cases are endless.

What about cookies, don't they achieve the same result? Yes. But cookies have their limitations, such as being restricted to 4KB and having overhead from every server request.

Local storage is an up-and-coming technology that's powerful and easy to use. Play around with it, you might be surprised what you can do with it.