Web API

BAB 56: Web Storage API

Menyimpan data di browser menggunakan localStorage dan sessionStorage.

Di bab Drag and Drop, kita bisa mengurutkan daftar keahlian sesuka hati, tapi begitu halaman di-refresh, urutan kembali ke posisi semula. Semua perubahan yang dilakukan pengguna hilang karena JavaScript hanya menyimpan data di memori selama halaman aktif. Bagaimana kalau urutan itu, preferensi tema, atau isi form bisa bertahan meskipun browser ditutup?

Web Storage API menyediakan dua mekanisme penyimpanan data di browser: localStorage dan sessionStorage. Keduanya menyimpan data dalam format key-value (kunci-nilai) dan bisa diakses langsung lewat JavaScript tanpa perlu berkomunikasi dengan server.

localStorage vs sessionStorage

Perbedaan utama keduanya ada pada masa hidup data:

AspeklocalStoragesessionStorage
Masa hidupPermanen sampai dihapus secara eksplisitHilang saat tab/jendela ditutup
CakupanSemua tab dari origin yang samaHanya tab yang sama
Kapasitas~5-10 MB per origin~5-10 MB per origin
Kegunaan umumPreferensi pengguna, tema, data yang harus bertahanData sementara satu sesi browsing

Origin di sini berarti kombinasi protokol + domain + port. Data localStorage yang disimpan oleh https://abdasis.dev tidak bisa diakses oleh https://contoh.com: dan sebaliknya.

Menyimpan dan Membaca Data

Kedua storage menggunakan method yang identik. Kita mulai dengan localStorage:

HTMLHTML
<!-- storage-dasar.html -->
<!DOCTYPE html>
<html lang="id">
<head>
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <title>Web Storage Dasar</title>
  <style>
    body { font-family: sans-serif; max-width: 500px; margin: 20px auto; }
    input, button { padding: 8px 12px; font-size: 14px; }
    input { width: 250px; }
    #daftar { margin-top: 15px; }
    .item-data { padding: 6px 0; border-bottom: 1px solid #e2e8f0; }
  </style>
</head>
<body>
  <h1>Simpan Data di Browser</h1>
  <div>
    <input type="text" id="input-kunci" placeholder="Kunci">
    <input type="text" id="input-nilai" placeholder="Nilai">
    <button id="tombol-simpan">Simpan</button>
  </div>
  <div id="daftar"></div>

  <script>
    var inputKunci = document.getElementById("input-kunci");
    var inputNilai = document.getElementById("input-nilai");
    var daftar = document.getElementById("daftar");

    function tampilkanData() {
      daftar.innerHTML = "<h3>Data Tersimpan:</h3>";
      if (localStorage.length === 0) {
        daftar.innerHTML += "<p>Belum ada data.</p>";
        return;
      }
      for (var i = 0; i < localStorage.length; i++) {
        var kunci = localStorage.key(i);
        var nilai = localStorage.getItem(kunci);
        var div = document.createElement("div");
        div.className = "item-data";
        div.textContent = kunci + ": " + nilai;
        daftar.appendChild(div);
      }
    }

    document.getElementById("tombol-simpan").addEventListener("click", function() {
      var kunci = inputKunci.value.trim();
      var nilai = inputNilai.value.trim();
      if (kunci && nilai) {
        localStorage.setItem(kunci, nilai);
        inputKunci.value = "";
        inputNilai.value = "";
        tampilkanData();
      }
    });

    tampilkanData();
  </script>
</body>
</html>

Method-method yang tersedia:

  • setItem(kunci, nilai): Menyimpan data. Jika kunci sudah ada, nilainya ditimpa.
  • getItem(kunci): Mengambil nilai berdasarkan kunci. Mengembalikan null jika kunci tidak ada.
  • removeItem(kunci): Menghapus satu item berdasarkan kunci.
  • clear(): Menghapus semua data di storage.
  • key(indeks): Mengambil nama kunci berdasarkan indeks numerik.
  • length: Properti yang mengembalikan jumlah item tersimpan.

Coba simpan beberapa data, lalu tutup browser dan buka kembali file ini, data masih ada. Itulah sifat localStorage: persisten sampai dihapus secara eksplisit.

Menyimpan Objek dengan JSON

localStorage dan sessionStorage hanya bisa menyimpan string. Jika kamu menyimpan angka, boolean, atau objek, semuanya dikonversi ke string secara otomatis, dan hasilnya sering tidak sesuai harapan. Solusinya: gunakan JSON.stringify() saat menyimpan dan JSON.parse() saat membaca:

HTMLHTML
<!-- storage-objek.html -->
<!DOCTYPE html>
<html lang="id">
<head>
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <title>Simpan Objek</title>
  <style>
    body { font-family: sans-serif; max-width: 500px; margin: 20px auto; }
    button { padding: 8px 12px; margin: 4px; }
    pre { background: #f1f5f9; padding: 12px; border-radius: 8px; }
  </style>
</head>
<body>
  <h1>Profil Pengguna</h1>
  <button id="simpan">Simpan Profil</button>
  <button id="baca">Baca Profil</button>
  <button id="hapus">Hapus Profil</button>
  <pre id="output">Klik tombol untuk berinteraksi dengan storage.</pre>

  <script>
    var output = document.getElementById("output");

    var profil = {
      nama: "Budi Santoso",
      keahlian: ["HTML", "CSS", "JavaScript"],
      pengalaman: 3,
      tersedia: true
    };

    document.getElementById("simpan").addEventListener("click", function() {
      localStorage.setItem("profil", JSON.stringify(profil));
      output.textContent = "Profil disimpan:\n" + JSON.stringify(profil, null, 2);
    });

    document.getElementById("baca").addEventListener("click", function() {
      var data = localStorage.getItem("profil");
      if (data) {
        var obj = JSON.parse(data);
        output.textContent = "Profil dari storage:\n" + JSON.stringify(obj, null, 2);
        output.textContent += "\n\nTipe: " + typeof obj;
        output.textContent += "\nKeahlian pertama: " + obj.keahlian[0];
      } else {
        output.textContent = "Profil belum ada di storage.";
      }
    });

    document.getElementById("hapus").addEventListener("click", function() {
      localStorage.removeItem("profil");
      output.textContent = "Profil dihapus dari storage.";
    });
  </script>
</body>
</html>

Tanpa JSON.stringify(), menyimpan objek ke localStorage akan menghasilkan string "[object Object]", yang tidak bisa dikembalikan ke bentuk objek. Dengan JSON, array, objek bersarang, dan tipe data primitif bisa disimpan dan diambil kembali dengan utuh.

JSON.stringify() tidak bisa menyimpan fungsi, undefined, Date object, atau referensi siklikal. Untuk kasus sederhana seperti menyimpan profil atau preferensi, ini bukan masalah, tapi penting untuk diketahui.

Contoh Praktis: Pengaturan Tema

Penggunaan localStorage yang paling umum di dunia nyata adalah menyimpan preferensi tema (gelap/terang):

HTMLHTML
<!-- tema.html -->
<!DOCTYPE html>
<html lang="id">
<head>
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <title>Pengaturan Tema</title>
  <style>
    body {
      font-family: sans-serif;
      max-width: 500px;
      margin: 40px auto;
      padding: 20px;
      transition: background-color 0.3s, color 0.3s;
    }

    body.gelap {
      background-color: #1e293b;
      color: #e2e8f0;
    }

    body.terang {
      background-color: #ffffff;
      color: #1e293b;
    }

    .tombol-tema {
      padding: 10px 20px;
      border: 2px solid currentColor;
      background: transparent;
      color: inherit;
      border-radius: 8px;
      cursor: pointer;
      font-size: 16px;
    }
  </style>
</head>
<body>
  <h1>Pengaturan Tema</h1>
  <p>Pilih tema dan refresh halaman, pilihan kamu tetap tersimpan.</p>
  <button class="tombol-tema" id="tombol-ganti">Ganti Tema</button>
  <p id="info-tema"></p>

  <script>
    var body = document.body;
    var tombol = document.getElementById("tombol-ganti");
    var info = document.getElementById("info-tema");

    function terapkanTema(tema) {
      body.className = tema;
      info.textContent = "Tema aktif: " + tema;
      localStorage.setItem("tema", tema);
    }

    // Muat tema tersimpan saat halaman dibuka
    var temaTersimpan = localStorage.getItem("tema");
    if (temaTersimpan) {
      terapkanTema(temaTersimpan);
    } else {
      terapkanTema("terang");
    }

    tombol.addEventListener("click", function() {
      var temaBaru = body.className === "terang" ? "gelap" : "terang";
      terapkanTema(temaBaru);
    });
  </script>
</body>
</html>

Klik "Ganti Tema", tutup halaman, lalu buka kembali, tema yang terakhir dipilih masih aktif. Pola ini digunakan oleh hampir semua situs modern yang menawarkan dark mode.

sessionStorage

sessionStorage bekerja persis sama dengan localStorage dari segi API, method dan propertinya identik. Perbedaannya hanya satu: data sessionStorage hilang saat tab ditutup.

Ini berguna untuk data yang memang hanya relevan selama sesi browsing aktif, misalnya isi form yang belum dikirim:

HTMLHTML
<!-- session-form.html -->
<!DOCTYPE html>
<html lang="id">
<head>
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <title>Auto-Save Form</title>
  <style>
    body { font-family: sans-serif; max-width: 400px; margin: 20px auto; }
    label { display: block; margin-top: 10px; font-weight: bold; }
    input, textarea { width: 100%; padding: 8px; margin-top: 4px; box-sizing: border-box; }
    textarea { height: 100px; }
    button { margin-top: 12px; padding: 10px 20px; }
    .status { color: #16a34a; font-size: 12px; margin-top: 4px; }
  </style>
</head>
<body>
  <h1>Form Pesan</h1>
  <p>Isi form ini, lalu refresh halaman, isian tidak hilang selama tab masih terbuka.</p>
  <form id="form-pesan">
    <label>Nama</label>
    <input type="text" id="nama" placeholder="Nama lengkap">

    <label>Email</label>
    <input type="email" id="email" placeholder="[email protected]">

    <label>Pesan</label>
    <textarea id="pesan" placeholder="Tulis pesan..."></textarea>

    <p class="status" id="status-simpan"></p>
    <button type="button" id="tombol-kirim">Kirim</button>
  </form>

  <script>
    var fieldIds = ["nama", "email", "pesan"];
    var statusSimpan = document.getElementById("status-simpan");

    // Muat data tersimpan saat halaman dibuka
    for (var i = 0; i < fieldIds.length; i++) {
      var tersimpan = sessionStorage.getItem("form_" + fieldIds[i]);
      if (tersimpan) {
        document.getElementById(fieldIds[i]).value = tersimpan;
      }
    }

    // Simpan otomatis saat mengetik
    for (var j = 0; j < fieldIds.length; j++) {
      document.getElementById(fieldIds[j]).addEventListener("input", function() {
        sessionStorage.setItem("form_" + this.id, this.value);
        statusSimpan.textContent = "Tersimpan otomatis";
        var ref = statusSimpan;
        setTimeout(function() { ref.textContent = ""; }, 1500);
      });
    }

    // Hapus storage saat "kirim"
    document.getElementById("tombol-kirim").addEventListener("click", function() {
      for (var k = 0; k < fieldIds.length; k++) {
        sessionStorage.removeItem("form_" + fieldIds[k]);
        document.getElementById(fieldIds[k]).value = "";
      }
      statusSimpan.textContent = "Pesan terkirim! (form direset)";
    });
  </script>
</body>
</html>

Setiap ketikan otomatis disimpan ke sessionStorage. Jika pengguna tidak sengaja me-refresh halaman, isian form tetap ada. Tapi begitu tab ditutup, data hilang, sesuai dengan sifat sessionStorage yang hanya bertahan selama sesi tab.

Memeriksa Storage di Browser

Kamu bisa melihat isi localStorage dan sessionStorage melalui Developer Tools browser:

  1. Buka Developer Tools (F12 atau Ctrl+Shift+I)
  2. Pilih tab Application (di Chrome) atau Storage (di Firefox)
  3. Di panel kiri, klik Local Storage atau Session Storage
  4. Pilih origin halaman yang aktif

Di sana kamu bisa melihat semua key-value yang tersimpan, mengedit nilainya, atau menghapusnya secara manual. Ini sangat berguna saat debugging.

Batasan dan Pertimbangan

Web Storage bukan pengganti database. Ada beberapa batasan penting yang perlu dipahami:

  • Hanya string: Semua data disimpan sebagai string. Gunakan JSON.stringify() / JSON.parse() untuk tipe data lain.
  • Sinkron: Operasi baca/tulis storage bersifat sinkron dan bisa memblokir thread utama jika datanya besar. Untuk data yang sangat besar, pertimbangkan IndexedDB.
  • Kapasitas terbatas: Sekitar 5-10 MB per origin, tergantung browser.
  • Tidak aman untuk data sensitif: Data di Web Storage bisa diakses oleh JavaScript apapun yang berjalan di origin yang sama, termasuk script dari third-party. Jangan simpan password, token autentikasi, atau data pribadi sensitif.
  • Tidak dikirim ke server: Berbeda dengan cookie, data Web Storage tidak dikirim di setiap HTTP request.

Latihan

  1. Buat halaman "Catatan Cepat" yang memiliki <textarea> dan tombol "Simpan". Simpan catatan ke localStorage dan muat kembali saat halaman dibuka. Tambahkan tombol "Hapus Catatan" yang mengosongkan textarea dan storage sekaligus.

  2. Kembangkan contoh pengaturan tema dengan menambahkan pilihan ukuran font (kecil, sedang, besar). Simpan kedua preferensi (tema dan ukuran font) sebagai satu objek JSON di localStorage.

  3. Buat "Keranjang Belanja" sederhana: tiga produk dengan tombol "Tambah" masing-masing. Simpan isi keranjang sebagai array di localStorage. Tampilkan jumlah item di keranjang dan tombol "Kosongkan Keranjang". Data harus bertahan setelah refresh.

Web Storage memungkinkan halaman menyimpan data secara lokal di browser (tapi semua operasinya berjalan di thread utama yang sama dengan rendering halaman. Untuk tugas yang berat secara komputasi, ini bisa membuat halaman menjadi lambat atau bahkan tidak responsif. Di bab berikutnya, kita akan mempelajari Web Workers API yang memungkinkan JavaScript berjalan di thread terpisah) menjalankan tugas berat tanpa mengganggu antarmuka pengguna.

Referensi

  1. 1 MDN Web Docs: Web Storage API
  2. 2 MDN Web Docs: Window.localStorage
  3. 3 MDN Web Docs: Window.sessionStorage