התכונה לקריאה בלבד 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 |
תאימות דפדפנים
BCD tables only load in the browser