DEV Community

Cover image for A Step-by-Step Guide to LocalStorage and SessionStorage: Storing Data on the Client Side
Srijan Karki
Srijan Karki

Posted on

A Step-by-Step Guide to LocalStorage and SessionStorage: Storing Data on the Client Side

Introduction to Web Storage

Web storage is a powerful feature in modern browsers that allows you to store data directly on the client side. This data can be retained even after the browser is closed (using LocalStorage) or only during the session (using SessionStorage). These tools are invaluable for storing user preferences, shopping cart data, and other types of information that enhance user experience.

Differences Between LocalStorage and SessionStorage

Understanding the difference between LocalStorage and SessionStorage is key to using them effectively:

  • LocalStorage:

    • Data persists even after the browser is closed.
    • It can be used to store long-term data, such as user preferences or tokens.
    • The stored data has no expiration time and remains available until explicitly deleted.
  • SessionStorage:

    • Data is only available during the session (i.e., as long as the tab or browser window is open).
    • Once the session ends (the tab is closed), the data is automatically cleared.
    • It's useful for temporary data, like session-specific user interactions or selections.

Storing, Retrieving, and Removing Data

Using LocalStorage and SessionStorage is straightforward. Below are examples demonstrating how to store, retrieve, and remove data.

// Storing data
localStorage.setItem('username', 'john_doe');
sessionStorage.setItem('sessionID', '123456');

// Retrieving data
const username = localStorage.getItem('username');
const sessionID = sessionStorage.getItem('sessionID');

// Removing data
localStorage.removeItem('username');
sessionStorage.removeItem('sessionID');

// Clearing all data
localStorage.clear();
sessionStorage.clear();
Enter fullscreen mode Exit fullscreen mode

Real-World Example: Saving User Preferences

To put these concepts into practice, let's create a simple web application that allows users to select and save their preferred theme (light or dark). This preference will be stored using LocalStorage so that it persists even after the browser is closed.

HTML:

<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <title>Theme Selector</title>
  <style>
    body.light {
      background-color: white;
      color: black;
    }
    body.dark {
      background-color: black;
      color: white;
    }
  </style>
</head>
<body>
  <h1>Theme Selector</h1>
  <button id="light">Light Theme</button>
  <button id="dark">Dark Theme</button>

  <script>
    const lightButton = document.getElementById('light');
    const darkButton = document.getElementById('dark');

    // Event listeners for theme selection
    lightButton.addEventListener('click', () => {
      document.body.className = 'light';
      localStorage.setItem('theme', 'light');
    });

    darkButton.addEventListener('click', () => {
      document.body.className = 'dark';
      localStorage.setItem('theme', 'dark');
    });

    // Load saved theme on page load
    const savedTheme = localStorage.getItem('theme');
    if (savedTheme) {
      document.body.className = savedTheme;
    }
  </script>
</body>
</html>
Enter fullscreen mode Exit fullscreen mode

Explanation:

  • Theme Selection: The user can select between a light or dark theme by clicking the respective buttons.
  • Storing Preferences: When a theme is selected, it is stored in LocalStorage under the key 'theme'.
  • Loading Preferences: When the page loads, the script checks LocalStorage for any saved theme and applies it automatically.

Why Use Web Storage?

Web storage provides a simple and efficient way to enhance the user experience. By storing preferences, sessions, or other necessary data on the client side, you can create more personalized, responsive, and seamless web applications. Understanding and utilizing LocalStorage and SessionStorage will help you build smarter applications that cater to user needs without relying heavily on server-side storage.

Conclusion

LocalStorage and SessionStorage are essential tools for any web developer. They allow you to store data directly in the browser, offering flexibility in how and when that data is available. Whether you need to persist user preferences or maintain session-specific information, web storage gives you the power to do so with minimal effort. By mastering these tools, you can greatly enhance the functionality and user experience of your web applications.

Top comments (0)