属性

length

Storage.length只读
返回一个整数,表示存储在 Storage 对象中的数据项数量。

方法

存 setItem()

  1. localStorage.setItem('name', 'liming');

取 getItem()

删 removeItem()

清空 clear()

描述一下 cookies,sessionStorage 和 localStorage 的区别?

cookie是网站为了标示用户身份而储存在用户本地终端(Client Side)上的数据(通常经过加密)。
cookie数据始终在同源的http请求中携带(即使不需要),记会在浏览器和服务器间来回传递。

sessionStorage和localStorage不会自动把数据发给服务器,仅在本地保存。
存储大小:
cookie数据大小不能超过4k。
sessionStorage和localStorage 虽然也有存储大小的限制,但比cookie大得多,可以达到5M或更大。
有期时间:
localStorage 存储持久数据,浏览器关闭后数据不丢失除非主动删除数据;
sessionStorage 数据在当前浏览器窗口关闭后自动删除。
cookie 设置的cookie过期时间之前一直有效,即使窗口或浏览器关闭

常用操作

localStorage的已使用空间

在较新的chrome上测试,localStorage的存储是按照字符个数来算的。包含键和值的。
所以在测试代码中,你把a修改啊,不会影响存储的数量。但是键的长度,会影响存储的数量。

  1. function getLSUsedSpace() {
  2. return Object.keys(localStorage).reduce((total, curKey) => {
  3. if (!localStorage.hasOwnProperty(curKey)) {
  4. return total;
  5. }
  6. total += localStorage[curKey].length + curKey.length;
  7. return total;
  8. }, 0)
  9. }

示例:

  1. localStorage.clear();
  2. localStorage.a = "啊";
  3. console.log(getLSUsedSpace()); // 2

key的值为长度为10的 kkkkkkkkkk:
输出结果:Max: 5242880 value Length: 5242870
当你把key修改长度为1的k:
输出结果:Max: 5242880 value Length: 5242879

  1. localStorage.clear();
  2. let valLength = 0
  3. try {
  4. let str = Array.from({ length: 5242800 }, () => "啊").join("");
  5. valLength = str.length;
  6. for (let i = 0; i < 10000000000000; i++) {
  7. str += "a"
  8. valLength += 1;
  9. localStorage.setItem(`kkkkkkkkkk`, str);
  10. }
  11. } catch (err) {
  12. console.error("存储失败", err);
  13. console.log("Max:", getLSUsedSpace(), " value Length:", valLength)
  14. }

简单封装

https://mp.weixin.qq.com/s/e8MSFaDwqcCFoxFTMimwPw
https://juejin.cn/post/7104301566857445412

  1. /***
  2. * title: storage.js
  3. * Author: Gaby
  4. * Email: xxx@126.com
  5. * Time: 2022/6/1 17:30
  6. * last: 2022/6/2 17:30
  7. * Desc: 对存储的简单封装
  8. */
  9. import CryptoJS from 'crypto-js';
  10. // 十六位十六进制数作为密钥
  11. const SECRET_KEY = CryptoJS.enc.Utf8.parse("3333e6e143439161");
  12. // 十六位十六进制数作为密钥偏移量
  13. const SECRET_IV = CryptoJS.enc.Utf8.parse("e3bbe7e3ba84431a");
  14. // 类型 window.localStorage,window.sessionStorage,
  15. const config = {
  16. type: 'localStorage', // 本地存储类型 sessionStorage
  17. prefix: 'SDF_0.0.1', // 名称前缀 建议:项目名 + 项目版本
  18. expire: 1, //过期时间 单位:秒
  19. isEncrypt: true // 默认加密 为了调试方便, 开发过程中可以不加密
  20. }
  21. // 判断是否支持 Storage
  22. export const isSupportStorage = () => {
  23. return (typeof (Storage) !== "undefined") ? true : false
  24. }
  25. // 设置 setStorage
  26. export const setStorage = (key, value, expire = 0) => {
  27. if (value === '' || value === null || value === undefined) {
  28. value = null;
  29. }
  30. if (isNaN(expire) || expire < 0) throw new Error("Expire must be a number");
  31. expire = (expire ? expire : config.expire) * 1000;
  32. let data = {
  33. value: value, // 存储值
  34. time: Date.now(), //存值时间戳
  35. expire: expire // 过期时间
  36. }
  37. const encryptString = config.isEncrypt
  38. ? encrypt(JSON.stringify(data))
  39. : JSON.stringify(data);
  40. window[config.type].setItem(autoAddPrefix(key), encryptString);
  41. }
  42. // 获取 getStorage
  43. export const getStorage = (key) => {
  44. key = autoAddPrefix(key);
  45. // key 不存在判断
  46. if (!window[config.type].getItem(key) || JSON.stringify(window[config.type].getItem(key)) === 'null') {
  47. return null;
  48. }
  49. // 优化 持续使用中续期
  50. const storage = config.isEncrypt
  51. ? JSON.parse(decrypt(window[config.type].getItem(key)))
  52. : JSON.parse(window[config.type].getItem(key));
  53. let nowTime = Date.now();
  54. // 过期删除
  55. if (storage.expire && config.expire * 6000 < (nowTime - storage.time)) {
  56. removeStorage(key);
  57. return null;
  58. } else {
  59. // 未过期期间被调用 则自动续期 进行保活
  60. setStorage(autoRemovePrefix(key), storage.value);
  61. return storage.value;
  62. }
  63. }
  64. // 是否存在 hasStorage
  65. export const hasStorage = (key) => {
  66. key = autoAddPrefix(key);
  67. let arr = getStorageAll().filter((item)=>{
  68. return item.key === key;
  69. })
  70. return arr.length ? true : false;
  71. }
  72. // 获取所有key
  73. export const getStorageKeys = () => {
  74. let items = getStorageAll()
  75. let keys = []
  76. for (let index = 0; index < items.length; index++) {
  77. keys.push(items[index].key)
  78. }
  79. return keys
  80. }
  81. // 根据索引获取key
  82. export const getStorageForIndex = (index) => {
  83. return window[config.type].key(index)
  84. }
  85. // 获取localStorage长度
  86. export const getStorageLength = () => {
  87. return window[config.type].length
  88. }
  89. // 获取全部 getAllStorage
  90. export const getStorageAll = () => {
  91. let len = window[config.type].length // 获取长度
  92. let arr = new Array() // 定义数据集
  93. for (let i = 0; i < len; i++) {
  94. // 获取key 索引从0开始
  95. let getKey = window[config.type].key(i)
  96. // 获取key对应的值
  97. let getVal = window[config.type].getItem(getKey)
  98. // 放进数组
  99. arr[i] = {'key': getKey, 'val': getVal,}
  100. }
  101. return arr
  102. }
  103. // 删除 removeStorage
  104. export const removeStorage = (key) => {
  105. window[config.type].removeItem(autoAddPrefix(key));
  106. }
  107. // 清空 clearStorage
  108. export const clearStorage = () => {
  109. window[config.type].clear();
  110. }
  111. // 名称前自动添加前缀
  112. const autoAddPrefix = (key) => {
  113. const prefix = config.prefix ? config.prefix + '_' : '';
  114. return prefix + key;
  115. }
  116. // 移除已添加的前缀
  117. const autoRemovePrefix = (key) => {
  118. const len = config.prefix ? config.prefix.length+1 : '';
  119. return key.substr(len)
  120. // const prefix = config.prefix ? config.prefix + '_' : '';
  121. // return prefix + key;
  122. }
  123. /**
  124. * 加密方法
  125. * @param data
  126. * @returns {string}
  127. */
  128. const encrypt = (data) => {
  129. if (typeof data === "object") {
  130. try {
  131. data = JSON.stringify(data);
  132. } catch (error) {
  133. console.log("encrypt error:", error);
  134. }
  135. }
  136. const dataHex = CryptoJS.enc.Utf8.parse(data);
  137. const encrypted = CryptoJS.AES.encrypt(dataHex, SECRET_KEY, {
  138. iv: SECRET_IV,
  139. mode: CryptoJS.mode.CBC,
  140. padding: CryptoJS.pad.Pkcs7
  141. });
  142. return encrypted.ciphertext.toString();
  143. }
  144. /**
  145. * 解密方法
  146. * @param data
  147. * @returns {string}
  148. */
  149. const decrypt = (data) => {
  150. const encryptedHexStr = CryptoJS.enc.Hex.parse(data);
  151. const str = CryptoJS.enc.Base64.stringify(encryptedHexStr);
  152. const decrypt = CryptoJS.AES.decrypt(str, SECRET_KEY, {
  153. iv: SECRET_IV,
  154. mode: CryptoJS.mode.CBC,
  155. padding: CryptoJS.pad.Pkcs7
  156. });
  157. const decryptedStr = decrypt.toString(CryptoJS.enc.Utf8);
  158. return decryptedStr.toString();
  159. }