Window.localStorage

התכונה לקריאה בלבד  localStorage  מאפשרת לך לגשת לאובייקט מסוג Storage עבור המקור של   Document; הנתונים המאוחסניםנשמרים בכל מפגשי הדפדפן. localStorage   דומה ל-sessionStorage, פרט לכך שבעוד תוקפם של הנתונים הנשמרים ב- localStorage אינו פג, נתונים הנשמרים ב-,sessionStorage נמחקים עם תום המפגש של הדף  —  כלומר, כשהדף נסגר.

יש לציין כי נתונים הנשמרים  ב-localStorage או ב-sessionStorage  הם מפורטים בפרוטוקול הדף.

המפתחות והערכים יביו תמיד מחרוזות (לתשומת לבך, בדומה לאובייקטים, מפתחות מטיפוס מספר שלם יומרו אוטומטית למחרוזות).

תחביר

myStorage = window.localStorage;

ערך

אובייקט מסוג Storage שניתן להשתמש בו לגישה לשטח האיחסון המקומי של המקור הנוכחי.

חריגות

SecurityError
הבקשה מפרה החלטות מדיניות, או שהמקור אינו  a valid scheme/host/port tuple (זה יכול לקרות אם המקור משתמש בסכמת (t file: או data:, למשל). לדוגמא, ייתכן שלמשתמש דפדפן המוגדר כך שישלול הרשאה לשמור נתונים כבלתי משתנים עבור מקור מסויים.

דוגמא

קטע הקוד הבא ניגש לאובייקט ה-Storage המקומי של המתחם הנוכחי , ומוסיף לו נתון באמצעות Storage.setItem().

localStorage.setItem('myCat', 'Tom');

התחביר לקריאת נתון ה-localStorage הוא כדלקמן:

var cat = localStorage.getItem('myCat');

 התחביר למחיקת נתון ה-localStorage הוא כדלקמן:

localStorage.removeItem('myCat');

התחביר למחיקת כל הנתונים ב-localStorage  הוא כדלקמן:

// Clear all items
localStorage.clear();

לתשומת לבך: נא לעיין במאמר  Using the Web Storage API   כדי לצפות בדוגמא השלמה.

מפרטים

מפרט מצב הערה
HTML Living Standard
The definition of 'localStorage' in that specification.
Living Standard

תאימות דפדפנים

Update compatibility data on GitHub
DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidFirefox for AndroidOpera for AndroidSafari on iOSSamsung Internet
localStorageChrome Full support 4Edge Full support 12Firefox Full support 3.5IE Full support 8Opera Full support 10.5Safari Full support 4WebView Android Full support YesChrome Android Full support YesFirefox Android Full support YesOpera Android Full support 11Safari iOS Full support 3.2Samsung Internet Android Full support Yes

Legend

Full support  
Full support

לעיון נוסף