跳到主要内容

认识

2025年01月19日
柏拉文
越努力,越幸运

一、认识


LocalStorage 是一种 Web 存储机制,允许将数据以键值对的形式存储在用户的浏览器中。与 SessionStorage 不同,LocalStorage 中的数据不会在浏览器会话结束后清除,而是持久化存储,直到被显式删除。

LocalStorage 持久化存储, 数据存储在浏览器中,即使页面刷新或浏览器关闭后仍然存在; 同源策略, 只能在同一协议、域名和端口下访问。存储容量限制: 每个域通常有 5MB 的存储限制(不同浏览器可能略有差异); 键值对存储: 以字符串的形式存储数据,键和值都必须是字符串; 同步 API: localStorage 的所有操作是同步的,可能会阻塞主线程。

二、API


2.1 key

根据索引返回存储的键。

const firstKey = localStorage.key(0);

2.2 clear

清空所有存储的数据。

localStorage.clear();

2.3 length

返回存储的键值对数量。

const count = localStorage.length;

2.4 setItem

将指定的键值对存储到 localStorage 中。

localStorage.setItem('username', 'Alice');

2.5 getItem

根据键获取存储的值,如果键不存在则返回 null

const username = localStorage.getItem('username'); // "Alice"

2.6 removeItem

删除指定键及其对应的值。

localStorage.removeItem('username');