JS метод Storage.setItem()
Загальний опис
setItem
— це метод об'єкта Storage
, який дозволяє зберігати дані в браузерному сховищі за допомогою пари ключ-значення. Це один з основних методів для роботи з localStorage
та sessionStorage
в JavaScript. Він дозволяє зберігати рядкові значення (як текст або числа), які зберігаються в браузері між сесіями (для localStorage
) або до закриття вкладки (для sessionStorage
).
Метод приймає два параметри:
- key — це рядок, який вказує на унікальний ідентифікатор для збереженого елемента.
- value — це значення, яке буде збережено. Воно повинно бути рядком, тому будь-який інший тип даних (масиви, об'єкти тощо) потрібно конвертувати в рядок перед збереженням за допомогою
JSON.stringify()
.
Простий приклад:
localStorage.setItem("username", "Іван");
У цьому прикладі ми зберігаємо ім'я користувача "Іван" за ключем "username"
в localStorage
. Після виконання цієї операції, значення "Іван"
буде збережено, і воно залишатиметься в сховищі, поки користувач не очистить його або не видалить вручну.
Порада: | При використанні
|
Порада: | Пам'ятайте, що |
Порада: | Не забувайте, що значення, яке ви зберігаєте в |
Синтаксис
storage.setItem(key, value);
Параметри
Return
undefined
Метод
setItem
з об'єктаStorage
не повертає жодного значення. Він виконує дію збереження даних у локальному сховищі або сесії, але не надає ніякої відповіді. Це метод, який працює збереженням пари "ключ-значення", але після його виклику не відбувається повернення значення (не маєreturn
значення). Тобто він повертаєundefined
.
Переглядачі
Переглядач | |||||
---|---|---|---|---|---|
4 |
3.5 |
4 |
10.5 |
12 |
Переглядач | ||||
---|---|---|---|---|
37 |
18 |
6 |
3.2 |
Переглядач | ||
---|---|---|
- |
1.10 |
Приклади
Цей приклад дозволяє користувачеві вибирати між світлою та темною темами для веб-сторінки. Налаштування зберігаються за допомогою методу localStorage.setItem
, що дозволяє зберігати вибір користувача в локальному сховищі браузера. Коли сторінка перезавантажується або відкрита знову, тема зберігається і застосовується автоматично.
У цьому прикладі, користувач може перемикати чекбокс для вибору теми, після чого натискання кнопки "Застосувати налаштування" зберігає цей вибір у локальному сховищі. Сторінка автоматично оновлюється відповідно до вибору користувача і показує повідомлення про успішне застосування налаштувань.
Цей приклад показує, як зберігати налаштування користувача, наприклад, вибір теми і розміру шрифту. Це корисно для відновлення налаштувань користувача після того, як він знову зайде на сайт, без необхідності змінювати ці налаштування вручну.
// Зберігання налаштувань користувача для теми
function saveUserSettings(theme, fontSize) {
const settings = { theme, fontSize };
localStorage.setItem("userSettings", JSON.stringify(settings));
}
saveUserSettings("dark", "16px");
Цей приклад використовує sessionStorage
для тимчасового зберігання даних форми під час заповнення. Це особливо корисно для запобігання втраті введених даних, якщо користувач випадково оновить сторінку або закриє вкладку.
// Зберігання даних форми на час сесії
function saveFormData() {
const formData = {
name: document.getElementById("name").value,
email: document.getElementById("email").value,
};
sessionStorage.setItem("formData", JSON.stringify(formData));
}
document.getElementById("saveBtn").addEventListener("click", saveFormData);