Storage.setItem()

פונקציית ()setItem מאפשרת להוסיף נתונים אל האחסון המקומי באמצעות שני פרמטרים: שם מפתח וערך שאותם תיצור או תעדכן במידה וקיימים.

תחביר

storage.setItem(keyName, keyValue);

פרמטרים

keyName: מכיל את שמו של המפתח אותו יש ליצור או לעדכן.
keyValue: מכיל את שם הערך שיתווסף למפתח אותו אנו יוצרים או מעדכנים.

במידה והאחסון מלא המערכות עשויה לנקות נתונים מהאחסון המקומי.
בגרסה הניידת של דפדפן Safari, במידה והמשתמש נכנס אל מצב פרטי המערכת אינה שומרת נתונים באחסון המקומי ומסירה אותם באופן אוטומטי בשל מגבלת גודל של 0 בתים.

דוגמאות

הפונקציה הבאה יוצרת שלושה פריטי נתונים בתוך האחסון המקומי.

function populateStorage() {
  localStorage.setItem('bgcolor', 'red');
  localStorage.setItem('font', 'Helvetica');
  localStorage.setItem('image', 'myCat.png');
}

מפרט

Specification	Status	Comment
HTML Living Standard The definition of 'Storage.setItem' in that specification.	Living Standard

תאימות דפדפן

BCD tables only load in the browser

תחביר

פרמטרים

ערך חוזר

החרגות

דוגמאות

מפרט

תאימות דפדפן

ראו גם