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
• Local storage with Window.localStorage
• Window.sessionStorage