Web前端入门第 84 问：JavaScript sessionStorage 那些容易踩坑的地方

sessionStorage 与 localStorage 差不多可以算作一对兄弟，它俩的暴露的 API 方法一模一样。

但两者也有不同点：

1、sessionStorage 存入的数据在页面关闭后，会自动清除。
2、相同 URL 的每个 tab 页签的 sessionStorage 会被隔离，互不影响。也就是说相同的链接，在 A 标签页打开和在 B 标签打开，A 写入的 sessionStorage 数据，B 是无法读取的！！这里与 会话 Cookie 完全不一样。
3、在页面中使用 <a target="_blank" rel="opener"> 和 window.open 打开新的标签页，sessionStorage 数据会复制，但之后的修改相互隔离。
4、sessionStorage 存入的数据会在浏览器打开期间一直保留，刷新页面或使用 ctrl + shift + t 恢复页面时，数据不会丢失。

API

sessionStorage 暴露的接口与 localStorage 一致：

// 只读属性，返回会话存储项的数目sessionStorage.length// 获取会话存储的第 n 个键名sessionStorage.key(n)// 获取会话存储的值sessionStorage.getItem(key)// 写入会话存储sessionStorage.setItem(key, value)// 删除会话存储sessionStorage.removeItem(key)// 清空所有会话存储sessionStorage.clear()

API 使用示例：

(() => {  // 写入数据  sessionStorage.setItem('type', '公众号');  sessionStorage.setItem('name', '前端路引');  // 获取会话存储长度  console.log(sessionStorage.length);  // 循环打印会话存储  for (let i = 0; i < sessionStorage.length; i++) {    const key = sessionStorage.key(i);    const value = sessionStorage.getItem(key);    console.log(`${key}: ${value}`);  }  // 移除单个会话存储  sessionStorage.removeItem('name');  // 移除所有会话存储  sessionStorage.clear();})()

无法存储数据变化

不像 localStorage，sessionStorage 没有暴露 onchange 事件，所以无法到数据变化，就算模拟自定义事件，也只能在当前页面中获得事件，无法跨页面通信。以下代码只能在本页面中 sessionStorage 数据改变：

(() => {  // 移除所有会话存储  sessionStorage.clear();    //  storage 事件  window.addEventListener('storage', e => {    console.log(e);  })  // 自定义写入函数，封装事件派发  function setItem (key, value) {    // 模拟 storage 事件    const ev = new StorageEvent('storage', {      key,      newValue: value,      oldValue: sessionStorage.getItem(key),      url: location.href,    });    window.dispatchEvent(ev);    sessionStorage.setItem(key, value);  }  setItem('type', '公众号');  setItem('name', '前端路引');})()

测试结果：

新开页面复制 sessionStorage

在 a 标签中添加 rel="opener" 可令新开的页面获得父页面中的 sessionStorage 数据（复制方式）。

window.open 方法打开的页面也是一样的道理。

注意：此时获得数据仅仅是副本，不共享，所以在新页面或旧页面中修改数据时，两者互不影响。

a 标签默认是 noopener，如果不显示设置 rel="opener"，无法获得数据副本！！

测试代码：

<a  href="./example-84-3.html"  target="_blank">a 标签打开本页面</a><br><br><a  href="./example-84-3.html"  target="_blank"  rel="opener">a 标签 opener 打开本页面</a><br><br><a  href="./example-84-3.html"  target="_blank"  rel="noopener">a 标签 noopener 打开本页面</a><br><br><button  onclick="window.open('./example-84-3.html')">window.open 打开本页面</button><br><br><button  onclick="window.open('./example-84-3.html', '_blank', 'noopener')">window.open noopener 打开本页面</button><br><br><button id="set">写入新的 sessionStorage</button><br><br><button id="get">获取 sessionStorage</button><br><br><div id="output"></div><script>  (() => {    const output = document.querySelector('#output');    document.querySelector('#set').addEventListener('click', e => {      sessionStorage.setItem('now', Date.now());    })    document.querySelector('#get').addEventListener('click', e => {      const now = sessionStorage.getItem('now');      output.innerText = now ?? '无';    })  })()</script>

测试结果：

大小限制

与 localStorage 一样限制 5MB 大小（所有键值加在一起的长度），溢出后写入报错，此处推荐阅读前一篇文章：{%post_link 'wechat-web-front-end-83'%}

测试代码：

(() => {  // 移除所有会话存储  sessionStorage.clear();  const key = 'name';  const max = 5 * 1024 * 1024;  // 测试极限值  // const value = 'a'.repeat(max - key.length);  // 测试中文  // const value = '中'.repeat(max - key.length);  // 测试溢出  const value = 'a'.repeat(max - key.length + 1);  sessionStorage.setItem(key, value);  // 测试多个项溢出情况  // sessionStorage.setItem('key', '1');  // 测试与 localStorage 是否共用存储空间  // localStorage.setItem('key', '1');})()

溢出结果：

结论：setItem 多个子项时，公用 5MB 存储空间（中英文计算方式一致），溢出时写入报错，并且与 localStorage 不共用存储空间！使用 rel="opener" 打开链接时，会获得父页面的副本数据，所以新开的页面仅能写入 5MB - 副本数据 等到的剩下空间。

可使用以下代码判断是否拥有副本数据：

if (window.opener) {  // opener 存在表示拥有副本  // 极限情况再写入新的数据报错  sessionStorage.setItem('now', Date.now());}

刷新与恢复页面

页面刷新时和关闭页面后再使用 ctrl+shift+t 恢复页面，sessionStorage 数据不会丢失。

测试代码：

<button id="set">写入新的 sessionStorage</button><br><br><button id="get">获取 sessionStorage</button><br><br><div id="output"></div><script>  (() => {    const output = document.querySelector('#output');    document.querySelector('#set').addEventListener('click', e => {      sessionStorage.setItem('now', Date.now());    })    document.querySelector('#get').addEventListener('click', e => {      const now = sessionStorage.getItem('now');      output.innerText = now ?? '无';    })  })()</script>

效果：

写在最后

sessionStorage 仅支持字符串存储，所以 JS 中用的 JSON 数据需要格式化为字符串存储~~

sessionStorage 一般多用于临时数据存储，比如一些表单填写的临时数据，单页应用页面间的数据传递等。

其生命周期有点短暂，浏览器或标签页关闭就会消失，就像浮游一样，朝生暮死...