Local Storage to mechanizm przeglądarki internetowej, który pozwala stronom zapisywać dane bezpośrednio na urządzeniu użytkownika i przechowywać je bez limitu czasowego. Jest częścią Web Storage API i przechowuje informacje w formie par klucz-wartość, dostępnych po ponownym otwarciu witryny czy zamknięciu przeglądarki. Dane pozostają zapisane, dopóki nie usunie ich skrypt, użytkownik lub czyszczenie danych przeglądarki.
- Pojemność: zwykle około 5–10 MB na domenę, znacznie więcej niż w przypadku ciasteczek (ok. 4 KB).
- Trwałość: dane nie mają daty wygaśnięcia i przetrwają zamknięcie karty czy przeglądarki.
- Zasada same-origin: dostęp do danych ma wyłącznie ta sama domena, która je zapisała.
- Brak wysyłki na serwer: w przeciwieństwie do cookies, dane z Local Storage nie są dołączane do każdego żądania HTTP.
Jak Local Storage działa w praktyce
Local Storage działa jako prosta baza danych po stronie klienta, obsługiwana przez JavaScript za pomocą obiektu window.localStorage. Programista zapisuje wartość poleceniem localStorage.setItem('klucz', 'wartość'), odczytuje ją przez localStorage.getItem('klucz'), a usuwa metodą removeItem() lub czyści całość przez clear(). Wszystkie dane przechowywane są jako łańcuchy tekstowe (string), więc obiekty trzeba serializować, najczęściej przez JSON.stringify().
Do czego wykorzystuje się Local Storage?
Local Storage stosuje się do zapamiętywania preferencji i danych, które nie wymagają obsługi po stronie serwera. Sprawdza się przy zapisie ustawień interfejsu (tryb ciemny/jasny), zawartości koszyka w sklepie, języka witryny czy zamykanych bannerów zgody na cookies. W aplikacjach typu SPA (Single Page Application) często przechowuje się w nim tokeny sesji lub cache danych, choć akurat do wrażliwych tokenów bezpieczniejsze bywają inne rozwiązania.
Czym różni się Local Storage od Session Storage i cookies?
Różnica sprowadza się do trwałości danych i sposobu ich przesyłania. Local Storage przechowuje dane bezterminowo, Session Storage kasuje je po zamknięciu karty, a cookies mają własną datę wygaśnięcia i są automatycznie wysyłane do serwera przy każdym żądaniu.
| Cecha | Local Storage | Session Storage | Cookies |
|---|---|---|---|
| Pojemność | ~5–10 MB | ~5 MB | ~4 KB |
| Czas życia | Do usunięcia | Do zamknięcia karty | Zdefiniowany (expires) |
| Wysyłka na serwer | Nie | Nie | Tak, przy każdym żądaniu |
| Dostęp | Ta sama domena | Ta sama karta i domena | Serwer i przeglądarka |
Jakie są ograniczenia Local Storage?
Local Storage ma istotne ograniczenia bezpieczeństwa i wydajności, o których łatwo zapomnieć. Dane są przechowywane w postaci jawnego tekstu, więc nie należy trzymać w nim haseł czy danych osobowych. Mechanizm jest też podatny na ataki typu XSS, ponieważ dowolny skrypt uruchomiony na stronie ma pełny dostęp do zawartości. Operacje odczytu i zapisu są synchroniczne, co przy dużych ilościach danych może blokować główny wątek i spowalniać interfejs.
Znaczenie dla SEO i widoczności
Local Storage nie wpływa bezpośrednio na pozycjonowanie, ale mądre jego użycie poprawia doświadczenie użytkownika i pośrednio wspiera SEO. Zapisując lokalnie dane, takie jak zawartość koszyka czy ustawienia strony, ograniczasz liczbę żądań do serwera i przyspieszasz ponowne ładowanie widoków, co przekłada się na lepsze wyniki Core Web Vitals.
Trzeba jednak uważać na renderowanie treści. Jeśli istotne dla SEO fragmenty strony ładują się dopiero z Local Storage po stronie klienta, robot Google może ich nie zobaczyć, bo Googlebot nie zawsze wykonuje pełny JavaScript przy pierwszym crawlowaniu. Treść ważna dla widoczności powinna być dostępna w kodzie HTML lub renderowana po stronie serwera. Takie zależności regularnie wychwytujemy podczas audytu SEO, szczególnie w sklepach opartych na aplikacjach JavaScript, gdzie pozycjonowanie sklepów internetowych wymaga poprawnego indeksowania kart produktów.
FAQ
Czy Local Storage jest bezpieczne?
Local Storage jest bezpieczne dla danych technicznych i preferencji, ale nie dla informacji wrażliwych. Dane są zapisywane jawnym tekstem i dostępne dla każdego skryptu na stronie, więc w razie ataku XSS mogą zostać przechwycone. Haseł, numerów kart czy tokenów o wysokim ryzyku nie powinno się tam przechowywać.
Jak długo przechowywane są dane w Local Storage?
Dane w Local Storage są przechowywane bezterminowo, aż do momentu ich ręcznego usunięcia. Znikają tylko wtedy, gdy skasuje je skrypt strony, użytkownik wyczyści dane przeglądarki lub odinstaluje przeglądarkę. Zamknięcie karty ani całej przeglądarki nie kasuje tych informacji.
Czy Local Storage wymaga zgody na cookies?
Local Storage może wymagać zgody podobnej do tej dla cookies, jeśli przechowujesz w nim dane śledzące lub identyfikujące użytkownika. Przepisy RODO i dyrektywa ePrivacy odnoszą się do przechowywania danych na urządzeniu, a nie wyłącznie do plików cookie. Dane czysto funkcjonalne, jak ustawienia motywu, zwykle nie wymagają zgody.
Co się stanie, gdy przekroczę limit Local Storage?
Po przekroczeniu limitu pojemności (zwykle 5–10 MB na domenę) przeglądarka zgłasza wyjątek QuotaExceededError i odmawia zapisu kolejnych danych. Aplikacja powinna obsługiwać taki błąd, na przykład czyszcząc starsze wpisy. Warto testować to zawczasu, bo nieobsłużony wyjątek potrafi zablokować część funkcji strony.
Local Storage jako element dobrze zaprojektowanej strony
Local Storage to praktyczne narzędzie do poprawy szybkości i wygody korzystania z witryny, ale jego użycie wymaga rozwagi w kwestii bezpieczeństwa, zgód i indeksowania. Dobrze wdrożony wspiera UX i pośrednio pomaga w widoczności, źle użyty potrafi utrudnić pozycjonowanie stron. Jeśli chcesz sprawdzić, czy Twoja witryna poprawnie łączy techniczne rozwiązania z SEO, zajrzyj do naszej oferty audytu SEO.











