Awesome
<p align="center"> <br> <img width="200" height="200" src="./awesome-storage-logo.png" alt="logo of awesome-web-storage repository"> <br> <br> </p>awesome-web-storage ![Awesome](https://cdn.rawgit.com/sindresorhus/awesome/d7305f38d29fed78fa85652e3a63e154dd8e8829/media/badge.svg)
Everything you need to know about Client-side Storage.
Table of Contents
- Introduction
- Browser Support
- Cookies
- LocalStorage
- SessionStorage
- Comparison Table
- PostMessage
- FAQs
- Contributing
- License
Introduction
What is Web Storage
Web storage, sometimes known as DOM storage (Document Object Model storage), provides web application software methods and protocols used for storing data in a web browser.
Web storage is being standardized by the World Wide Web Consortium (W3C). It was originally part of the HTML5 specification, but is now in a separate specification.
Modern websites and web applications these days are becoming smarter than before and to achieve such smartness, the data storage system plays a very crucial role. Be it storing visitors' data & settings or any kind of information, web-storage is a breakthrough in the history of web applications. It offers a very basic need of storing persistent data in the browser itself which has literally spurred up its application from game-changing novelty to must-have features.
Usually, this kind of data doesn't need a well-organized backend database. The purpose of the data varies as per the website/webapp requirements. Different pages of the same website need to share data among themselves to behave alike and perfectly. This sharing of data among windows/tabs is very common these days and most of the sites or web apps use it for various jobs like User Authentication, Personalization (showing different views to a new visitor and on subsequent visits), Tracking user behavior, etc.
Before HTML5, storing application level data was possible only using cookies. Cookies can store up to 4KB of data, including the bytes consumed by the cookie name. This domain-specific data is sent along with every browser request. With the advent of HTML5, it's much easier now to store structured data on the client-side securely and faster than ever. HTML5 introduced the concept of Web Storage. Web storage can be viewed simplistically as an improvement on cookies, providing much greater storage capacity. HTML5 introduces two such web storage mechanisms: LocalStorage and SessionStorage. There are so many limitations in using cookies which can now be overcome using web storage.
There's no term as "Perfectly Secured Persistent Storage" available in the browsers as any type of storage system( persistent or non-persistent) can be manually tweaked by the end-user(assuming she knows a bit of geeky stuff :P).
Web Storage concepts and usage
The two mechanisms within Web Storage are as follows:
sessionStorage
maintains a separate storage area for each given origin that's available for the duration of the page session (as long as the browser is open, including page reloads and restores).localStorage
does the same thing, but persists even when the browser is closed and reopened.
Web Storage interfaces
Allows you to set, retrieve and remove data for a specific domain and storage type (session or local.)
The Web Storage API extends the
Window
object with two new properties —Window.sessionStorage
andWindow.localStorage
— which provide access to the current domain's session and local Storage objects respectively, and aWindow.onstorage
event handler that fires when a storage area changes (e.g. a new item is stored.)
The storage event is fired on a document's Window object when a storage area changes.
Browser Support
Different Storage APIs
Following are various storage techniques which HTML5 storage provides. Each technique has its own pros and cons.
Cookies
An
HTTP cookie
(web cookie, browser cookie) is a small piece of data that a server sends to the user's web browser. The browser may store it and send it back with the next request to the same server. Typically, it's used to tell if two requests came from the same browser — keeping a user logged-in, for example. It remembers stateful information for the stateless HTTP protocol.
Pros:
- Session Management - Easy to use with logins, shopping carts, game scores, or anything else the server should remember
Cons:
-
The 4K limit is for the entire cookie, including name, value, expiry date etc. To support most browsers, keep the name under 4000 bytes, and the overall cookie size under 4093 bytes.
-
The data is sent back to the server for every HTTP request (HTML, images, JavaScript, CSS, etc) - increasing the amount of traffic between client and server.
-
Typically, the following are allowed:
- 300 cookies in total
- 4096 bytes per cookie
- 20 cookies per domain
- 81920 bytes per domain(Given 20 cookies of max size 4096 = 81920 bytes.)
API
-
Read
Reading all cookies accessible from the domain
var allCookies = document.cookie;
-
Write
Writing a new cookie on a domain
document.cookie = newCookie;
As mentioned in the mdn docs, any of the following cookie attribute values can optionally follow the key-value pair, specifying the cookie to set/update, and preceded by a semi-colon separator:
-
;path=path
- (e.g., '/', '/mydir') If not specified, defaults to the current path of the current document location. -
;domain=domain
- (e.g., 'example.com' or 'subdomain.example.com'). -
;max-age=max-age-in-seconds
- (e.g., 60*60*24*365 or 31536000 for a year) -
;expires=date-in-GMTString-format
- If not specified it will expire at the end of a session. -
;secure
- Cookie to only be transmitted over secure protocol ashttps
. BeforeChrome 52
, this flag could appear with cookies fromhttp
domains.
-
Resources - more on cookies
- Blogs
- Libraries
- Browser Extensions
- EditThisCookie(For Chrome) - Open source Chrome extension which does it all!
- Cookies(For Chrome) - A powerful and easy-to-use Cookie Editor.
- Cookie Inspector(For Chrome) - Edit and create cookies right in the Developer Tools.
- EditThisCookie(For Firefox)
- Cookies Manager+ - To view, edit and create new cookies.
- Vanilla Cookie Manager(For Chrome) - A Cookie Whitelist Manager that helps protect your privacy. Automatically removes unwanted cookies.
localStorage
The read-only
localStorage
property allows you to access aStorage
object for theDocument
's origin; the stored data is saved across browser sessions.localStorage
is similar tosessionStorage
, except that while data stored inlocalStorage
has no expiration time, data stored insessionStorage
gets cleared when the page session ends — that is, when the page is closed.
Pros:
-
If you look at the Mozilla source code it can be seen that 5120KB (5MB which equals 2.5 Million characters on Chrome) is the default storage size for an entire domain. This gives you considerably more space to work with than a typical 4KB cookie.
-
The data is not sent back to the server for every HTTP request (HTML, images, JavaScript, CSS, etc) - reducing the amount of traffic between client and server.
-
The data stored in localStorage persists until explicitly deleted. Changes made are saved and available for all current and future visits to the site.
-
Structured data can be stored but it has to be stringified before storing.
-
Simple API to save, update, and delete data.
Cons:
-
It works on same-origin policy. So, data stored will only be available on the same origin.
-
It stores everything as a string.
API
-
setItem
setItem Description method localStorage.setItem(key, value) params key(String/Number),<br>value(Number/String),<br>though it accepts other types, the value is always stored as a string, so, stringifying data before storing is preferred and the best way to avoid errors while reading description adds the key to the storage with the value, or update the key's value if it already exists. example localStorage.setItem('test', document.getElementById('js-btn').value); -
getItem
getItem Description method localStorage.getItem(key) params key(String/Number) description returns the value of the key passed. example localStorage.getItem('test') -
removeItem
removeItem Description method localStorage.removeItem(key) params key(String/Number) description removes the key from the storage. example localStorage.removeItem('test') -
clear
clear Description method localStorage.clear() params None description empties all the keys out of the storage. example localStorage.clear() -
key
key Description method localStorage.key(n) params n(a Number) description returns the name of the nth key in the storage. example localStorage.key(0) -
length
length Description property localStorage.length description returns the length of all the keys example localStorage.length
Resources - more on localStorage
- Blogs
- Libraries
- angular-local-storage - An AngularJS module that gives access to the browsers local storage with cookie fallback.
- react-native-localstorage - Local storage wrapper for both react-native and browser.
- vue-local-storage - Vue.js localStorage plugin with types support.
- localForage - Offline storage, improved. Wraps IndexedDB, WebSQL, or localStorage using a simple but powerful API.
- basket.js - A script and resource loader for caching & loading files with localStorage.
- secure-ls - Secure localStorage data with high level of encryption and data compression.
- Browser Extensions
- HTML5 Storage Manager All in One - Complete Storage Manager Extension Ever!
sessionStorage
The
sessionStorage
property allows you to access a sessionStorage
object for the current origin. sessionStorage is similar toWindow.localStorage
, the only difference is while data stored in localStorage has no expiration set, data stored in sessionStorage gets cleared when the page session ends. A page session lasts for as long as the browser is open and survives over page reloads and restores. Opening a page in a new tab or window will cause a new session to be initiated, which differs from how session cookies work.
Pros:
-
Data can only be saved per window (or tab in browsers like Chrome and Firefox). Data saved is available for the current page, as well as for the future visits to the site on the same window. Once the window is closed, the storage is deleted.
Cons:
-
The data is available only inside the window/tab in which it was set.
-
The data is non-persistent i.e. it will be lost once the window/tab is closed.
-
Like
localStorage
, it also works on same-origin policy. So, data stored on one protocol/domain/port will not be available for different protocol/domain/port.
API
-
setItem
setItem Description method sessionStorage.setItem(key, value) params key(String/Number),<br>value(Number/String),<br>though it accepts other types, the value is always stored as a string, so, stringifying data before storing is preferred and the best way to avoid errors while reading description adds the key to the storage with the value, or update the key's value if it already exists. example sessionStorage.setItem('test', document.getElementById('js-btn').value); -
getItem
getItem Description method sessionStorage.getItem(key) params key(String/Number) description returns the value of the key passed. example sessionStorage.getItem('test') -
removeItem
removeItem Description method sessionStorage.removeItem(key) params key(String/Number) description removes the key from the storage. example sessionStorage.removeItem('test') -
clear
clear Description method sessionStorage.clear() params None description empties all the keys out of the storage. example sessionStorage.clear() -
key
key Description method sessionStorage.key(n) params n(a Number) description returns the name of the nth key in the storage. example sessionStorage.key(0) -
length
length Description property sessionStorage.length description returns the length of all the keys example sessionStorage.length
Resources - more on sessionStorage
- Blogs
- Libraries
- sessionstorage - sessionStorage API which gracefully degrades to window.name & cookies when not available.
- ngStorage - localStorage and sessionStorage done right for AngularJS.
- react-webstorage - Use webStorage or a webStorage polyfill as a React store
- Browser Extensions
- HTML5 Storage Manager All in One - Complete Storage Manager Extension Ever!
Comparison Table
Web Storage | cookies | localStorage | sessionStorage |
---|---|---|---|
Size limit | Max 4kb (~2K chars) | Max 5mb (~2M chars) | Max 5mb (~2M chars) |
Data Storage | FileSytem | FileSytem | FileSytem |
Payload | In every HTTP req | Nothing | Nothing |
API | Fair | Simple | Simple |
Persistent | Yes | Yes | No |
Data Format | String | String | String |
Same-origin | Yes | Yes | Yes |
Cross-origin | No | No | No |
Browser Sipport | All | IE8+, Edge12+, Firefox3.5+, Safari4+, Opera11.5+ | IE8+, Edge12+, Firefox3.5+, Safari4+, Opera11.5+ |
Size limits info | limit | limit | limit |
Worth mentioning API for tackling cross-origin restriction
One very interesting API, PostMessage is not a web-storage technique but it's the most efficient and reliable way of communicating between
cross-origin
browser windows/tabs. Along with web-storage APIs, it overcomes the web-storage restrictions of cross-origin.
Pros:
-
Safely enables cross-origin policy communication.
-
As a data point, the WebKit implementation (used by Safari and Chrome) doesn't currently enforce any limits (other than those imposed by running out of memory).
Cons:
-
Need to open a window from the current window and only then can communicate as long as you keep the windows open.
-
Security concerns - Sending strings via postMessage is that you will pick up other postMessage events published by other JavaScript plugins, so be sure to implement a targetOrigin and a sanity check for the data being passed on to the messages listener.
API:
otherWindow.postMessage(message, targetOrigin, [transfer]);
otherWindow - A reference to another window; such a reference may be obtained, for example, using the contentWindow
property of an iframe
element, the object returned by window.open, or by named or numeric index on Window.frames, if you're trying to start the communication from iframe to parent window then parent is also a valid reference
message - Data to be sent to the other window. The data is serialized using the structured clone algorithm. This means you can pass a broad variety of data objects safely to the destination window without having to serialize them yourself. [1]
targetOrigin - Specifies what the origin of otherWindow
must be for the event to be dispatched, either as the literal string "*"
(indicating no preference) or as a URI. If at the time the event is scheduled to be dispatched the scheme, hostname, or port of otherWindow's document does not match that provided in targetOrigin
, the event will not be dispatched; only if all three match will the event be dispatched. This mechanism provides control over where messages are sent; for example, if postMessage()
was used to transmit a password, it would be absolutely critical that this argument be a URI whose origin is the same as the intended receiver of the message containing the password, to prevent interception of the password by a malicious third party. Always provide a specific targetOrigin, not *
, if you know where the other window's document should be located. Failing to provide a specific target discloses the data you send to any interested malicious site.
transfer(Optional) - Is a sequence of Transferable objects that are transferred with the message. The ownership of these objects is given to the destination side and they are no longer usable on the sending side.
Security concerns
If you do not expect to receive messages from other sites, do not add any event listeners for message
events. This is a completely foolproof way to avoid security problems.
If you do expect to receive messages from other sites, always verify the sender's identity using the origin
and possibly source
properties. Any window (including, for example, http://evil.example.com)
can send a message to any other window, and you have no guarantees that an unknown sender will not send malicious messages. Having verified identity, however, you still should always verify the syntax of the received message. Otherwise, a security hole in the site you trusted to send only trusted messages could then open a cross-site scripting hole in your site.
Always specify an exact target origin, not *
, when you use postMessage to send data to other windows. A malicious site can change the location of the window without your knowledge, and therefore it can intercept the data sent using postMessage
.
Resources - more on postMessage:
- Blogs
- Libraries
- postmate - A powerful, simple, promise-based postMessage library.
- across-tabs - Easy communication between cross-origin browser tabs.
- Browser Extensions
- postMessage debugger - This extension prints messages sent with postMessage to the console.
FAQs
-
How to store data that works Cross-Origin too?
A combination of
postMessage and localStorage / sessionStorage
Using postMessage to communicate between multiple tabs and at the same time using localStorage/sessionStorage in all the newly opened tabs/windows to persist data being passed. Data will be persisted as long as the tabs/windows remain open in case of sessionStorage and in the case of localStorage unless the data is deleted by the system or manually flushing it using dev tools. So, even if the opener tab/window gets closed, the opened tabs/windows will have the entire data even after getting refreshed.
- across-tabs - Easy communication between cross-origin browser tabs
Contributing Guidelines
Please ensure your pull request adheres to the following guidelines:
- Search previous suggestions before making a new one, as yours may be a duplicate.
- Make sure the list is useful before submitting. That implies it has enough content and every item has a good succinct description.
- Make an individual pull request for each suggestion.
- Use title-casing (AP style).
- Use the following format:
[List Name](link)
- Link additions should be added to the bottom of the relevant category.
- New categories or improvements to the existing categorization are welcome.
- Check your spelling and grammar.
- Make sure your text editor is set to remove trailing whitespace.
- The pull request and commit should have a useful title.
- The body of your commit message should contain a link to the repository.
LICENSE
To the extent possible under law, Varun Malhotra has waived all copyright and related or neighboring rights to this work.