localStorage w JavaScript (z działającymi przykładami)
localStorage w JavaScript
localStorage w JavaScript: przykłady, JSON, limity | We.Inc
Wypróbuj localStorage w interaktywnym środowisku, a potem skopiuj działające przykłady zapisanych ustawień, koszyka i motywu, plus obsługę JSON, limity rozmiaru, błędy i synchronizację między kartami.
localStorage to magazyn kluczy i wartości w przeglądarce, osobny dla każdego originu, który zachowuje dane po zamknięciu karty i przeglądarki. Wywołujesz setItem(key, value), aby zapisać, getItem(key), aby odczytać, removeItem(key), aby usunąć, i clear(), aby go wyczyścić. Wartości są zawsze stringami, więc obiekty opakuj w JSON.stringify i JSON.parse.
Całe Storage API na jednej karcie
- Element
- Co robi
- Zwraca
- setItem(key, value)
- Dodaje lub nadpisuje jeden wpis
- getItem(key)
- Odczytuje jeden wpis
- String lub null, jeśli brak
- removeItem(key)
- Usuwa jeden wpis
- clear()
- Usuwa wszystkie wpisy dla tego originu
- key(index)
- Nazwa wpisu na danej pozycji
- String lub null
- Ile wpisów jest zapisanych
- Liczba
Większość błędów z localStorage wynika z trzech niespodzianek: wszystko zamienia się w string, wywołanie może rzucić wyjątek, a dane są powiązane z jednym konkretnym originem. Poniższe środowisko zapisuje dane w Twojej przeglądarce, więc możesz obserwować te reguły w działaniu, a przykłady pokazują bezpieczne wzorce dla ustawień, koszyka i przełącznika motywu.
- Wpisz klucz i wartość w środowisku testowym i naciśnij Zapisz. Wpis trafia do storage tej strony w Twojej przeglądarce.
- Naciśnij Odczytaj, aby go pobrać, lub Usuń, aby go skasować. Tabela poniżej pokazuje każdy klucz, który ta strona dla Ciebie przechowuje.
- Przełącz typ wartości na Obiekt, aby zobaczyć, jak JSON.stringify zamienia go na tekst, a JSON.parse odtwarza.
- Skopiuj dowolny przykład poniżej do własnego projektu. Każdy opakowuje dostęp do storage w try i catch.
- Dodawaj prefiksy do kluczy, na przykład shop:cart, aby dwa skrypty na tym samym originie nie nadpisywały sobie danych.
- Przechowuj numer wersji obok danych strukturalnych, aby po przebudowie móc zmigrować stare formaty.
- Nigdy nie trzymaj tu haseł, tokenów ani danych osobowych. Każdy skrypt działający na stronie może odczytać każdy wpis.
- Odczytaj dane raz przy starcie i trzymaj wartość w pamięci. Każde wywołanie jest synchroniczne i blokuje główny wątek.
- Używaj sessionStorage, gdy dane mają zniknąć po zamknięciu karty przez odwiedzającego.
Najczęściej zadawane pytania
Ile danych może pomieścić localStorage?
MDN dokumentuje limit 5 MiB localStorage na origin w aktualnych przeglądarkach i osobne 5 MiB dla sessionStorage. Stringi są przechowywane w UTF-16, więc liczba znaków, które się zmieszczą, jest mniejsza, niż sugeruje liczba bajtów. Zapis ponad limit rzuca QuotaExceededError.
Czy localStorage wygasa?
Nie. Wpisy pozostają, dopóki Twój kod ich nie usunie lub odwiedzający nie wyczyści danych strony. W oknie prywatnym przeglądarka kasuje je po zamknięciu ostatniej prywatnej karty. Jeśli potrzebujesz wygasania, zapisz znacznik czasu razem z wartością i sprawdzaj go przy odczycie.
Dlaczego getItem zwraca "[object Object]"?
setItem zamienia wszystko, co przekażesz, na string. Zwykły obiekt staje się tekstem [object Object], a dane przepadają. Zapisuj JSON.stringify(obj) i odczytuj z powrotem przez JSON.parse.
Czy localStorage jest współdzielony między http i https?
Nie. Storage należy do originu, czyli schematu, hosta i portu razem. http://example.com i https://example.com mają osobne magazyny, podobnie jak subdomeny.
Jak synchronizować zmiany między kartami przeglądarki?
Nasłuchuj zdarzenia storage na window. Uruchamia się ono w innych otwartych dokumentach tego samego originu, gdy jeden z nich zmieni wartość, i zawiera key, oldValue oraz newValue. Karta, która dokonała zmiany, go nie otrzymuje.
localStorage czy cookies?
Cookies są wysyłane na serwer z każdym żądaniem i nadają się do sesji. localStorage nigdy nie opuszcza przeglądarki, mieści więcej i nadaje się do stanu interfejsu, takiego jak motyw, szkic czy zwinięty pasek boczny.
Kiedy localStorage to właściwe narzędzie
- Sprawdza się przy małych elementach pamięci interfejsu: ostatnio otwartej karcie, zamkniętym banerze, szkicu wiadomości, preferowanej jednostce. Utrata takich danych jest lekko irytująca, a nie szkodliwa, co pasuje do tego, jak łatwo ludzie je czyszczą.
- Słabo pasuje do wszystkiego, czego nie możesz stracić, co powinno być widoczne na innym urządzeniu, oraz do dużych kolekcji. Zamówienia należą na serwer, a duże dane strukturalne do IndexedDB, które działa asynchronicznie.
Dlaczego każde wywołanie potrzebuje try i catch
- Przeglądarki rzucają SecurityError, gdy storage jest zablokowany, na przykład gdy odwiedzający wyłączył dane stron, a strony otwierane z adresów file: zachowują się różnie w zależności od przeglądarki. Pełny magazyn rzuca QuotaExceededError przy zapisie.
- Mała funkcja opakowująca, która w razie błędu zwraca wartość zastępczą, utrzymuje resztę strony w działaniu. Wszystkie przykłady poniżej mają taki kształt.
Jak zachować bezpieczeństwo
- Wszystko w storage może odczytać dowolny skrypt na originie, w tym widżet zewnętrzny lub kod wstrzyknięty przez błąd cross-site scripting. Traktuj te dane jako publiczne dla strony.
- Odczytane dane to również niezaufane dane wejściowe. Waliduj je przed użyciem i renderuj jako tekst, nigdy jako HTML.
localStorage vs sessionStorage vs cookies
Wybierz magazyn według tego, jak długo dane mają żyć i kto ich potrzebuje
- localStorage
- sessionStorage
- Cookie
- Czas życia
- Do usunięcia
- Do zamknięcia karty
- Do daty wygaśnięcia
- Współdzielony między kartami
- Tak, ten sam origin
- Nie, tylko jedna karta
- Tak
- Wysyłany na serwer
- Nie
- Nie
- Tak, z każdym żądaniem
- Rozmiar (według MDN)
- 5 MiB na origin
- 5 MiB na origin
- Mały, limity zależą od przeglądarki
- Styl API
- Synchroniczny
- Synchroniczny
- String document.cookie
Przykłady do skopiowania
Bezpieczne funkcje odczytu i zapisu z JSON
Jedno miejsce obsługuje zablokowany storage, pełny limit i uszkodzony JSON, więc reszta Twojego kodu nie musi.
Zapamiętywanie ustawień odwiedzającego
Wartości domyślne są łączone z tym, co zostało zapisane, więc dodanie później nowego ustawienia nie psuje starszych zapisanych danych.
Mały koszyk, który przetrwa przeładowanie
Każda zmiana tworzy nową tablicę i zapisuje ją z powrotem. O cenach przy kasie nadal decyduje serwer.
Wybór motywu z ustawieniem systemowym jako zapasowym
Jeśli nic nie zapisano, wygrywa ustawienie systemu operacyjnego. Uruchom to wcześnie w head, aby uniknąć mignięcia złego motywu.
Wpisy, które wygasają
localStorage nie ma wbudowanego wygasania, więc zapisz termin razem z wartością i usuwaj nieaktualne wpisy przy odczycie.
Synchronizacja otwartych kart
Zdarzenie storage dociera do każdej innej karty na tym samym originie, więc licznik koszyka może się zaktualizować bez przeładowania.
Storage jest zablokowany w tej przeglądarce, więc każde wywołanie rzuciłoby wyjątek. Twój kod potrzebuje rozwiązania zapasowego.
Rzucono {name}: {message}
Najpierw wpisz klucz.
{call} zapisało znaki: {n}.
{call} zwróciło null: nie ma wpisu o tym kluczu.
JSON.parse zwrócił: {value}
Zapisany tekst nie jest JSON-em: {value}
{call} zwróciło string {value}
{call} wykonane.
Usunięto wpisy testowe: {n}. Pozostałe klucze tej strony nie zostały zmienione.
Środowisko testowe {name}
Zapisuj, odczytuj i usuwaj wpisy we własnej przeglądarce i zobacz każdy klucz, który przechowuje ta strona. Klucze testowe zaczynają się od demo:, więc nigdy nie kolidują ze stroną.
Klucz
Wartość
Typ wartości
Zwykły string
Obiekt (JSON)
Zapisz
Odczytaj
Usuń
Wyczyść klucze testowe
Wyniki pojawią się tutaj.
Wpisy testowe zapisane w Twojej przeglądarce ({n})
Zapisany string
Zbuduj stronę za darmo · Za darmo, bez karty
Powiązane: Poradniki
- Pętla for w JavaScript i jaką pętlę wybrać
- Obiekty w JavaScript i skąd się bierze [object Object]
- Odświeżanie strony w JavaScript
- Przewijanie do elementu w JavaScript
- Sortowanie tablicy obiektów w JavaScript
- Metody stringów w JavaScript
- Strony w JavaScripcie a roboty AI
- Strona jubilera
Produkt
Dla kogo
- Dla agencji
- Dla freelancerów
- Dla firm hostingowych
- Dla platform SaaS
- Dla startupów
- Usługi finansowe
- Rozwiązania dla ochrony zdrowia
Funkcje
Zasoby
- Blog
- Centrum pomocy
- Darmowe narzędzia dla firm
- Free UI Components
- Szablony
- Kolekcje szablonów
- Przykłady stron
- Poradniki
- Porównania
- Alternatywy
- Najlepsze
- Recenzje
- Przewodniki po cenach
- Zastosowania
- Słownik i poradniki
- Integracje
- Dla programistów
- Benchmark
- Windows App