前端(JavaScript)函数_储存类

文档概述

轻语言网站开发中的储存类操作函数、基于浏览器 localStorage 封装用于本地数据存储，包含数据读写、数据删除、存储空间管理等功能，每个网站最大存储空间为5M，超过5M的数据将无法保存，常用于用户偏好设置、数据缓存、离线存储等场景。

持久化存储：保存配置 / 读取配置 基于 localStorage，关闭浏览器后数据仍然保留
会话存储：保存临时数据 / 取临时保存数据 基于 sessionStorage，关闭浏览器标签页后数据自动清除
存储容量：单个域名下最大 5MB，适合存储用户偏好、缓存数据、表单草稿等小体量数据

💡 存储复杂对象：localStorage 只能存储字符串，因此存储对象/数组时需先用 JSON编码 序列化为字符串，读取时再用 JSON解析 还原为对象。

函数：保存配置(键名,值)

存储指定键值对到本地存储中。代码示例：保存配置("用户名", "张三")

' 存储简单的字符串数据
保存配置("用户名", "张三")

' 存储复杂对象（需先用 JSON编码 序列化为 JSON 字符串）
变量 用户信息 = {
	"姓名": "李四",
	"年龄": 25,
	"邮箱": "lisi@example.com"
}
保存配置("用户信息", JSON编码(用户信息))

' 存储数字和布尔值
保存配置("访问次数", 10)
保存配置("是否登录", 真)

函数：读取配置(键名)

从本地存储中获取指定键对应的值。代码示例：变量用户名 = 读取配置("用户名")

' 获取简单数据
变量 用户名 = 读取配置("用户名")

' 获取并解析复杂对象
变量 用户信息JSON = 读取配置("用户信息")
如果(用户信息JSON != 空)
	变量 用户信息 = JSON解析(用户信息JSON)
	调试输出("用户姓名: " + 用户信息.姓名)
结束 如果

' 获取数字和布尔值（需要类型转换）
变量 访问次数 = 到整数(读取配置("访问次数"))
变量 是否登录 = (读取配置("是否登录") == "真")

函数：删除配置(键名)

从本地存储中移除指定键及其对应的值。代码示例：删除配置("用户名")

' 删除特定的缓存项
删除配置("用户名")

' 删除复杂对象缓存
删除配置("用户信息")

' 在用户退出时清理个人信息
按钮_退出登录.置被单击回调((源对象, 事件) => {
	删除配置("用户名")
	删除配置("用户信息")
	删除配置("访问次数")
	删除配置("是否登录")
	切换页面("登录页")
})

函数：清空配置()

清空所有存储在本地存储中的数据。代码示例：清空配置()

' 清空所有本地存储数据
清空配置()

' 在需要重置应用时使用
按钮_重置应用.置被单击回调((源对象, 事件) => {
	清空配置()
	弹出提示("应用已重置，请重新登录")
	切换页面("登录页")
})

函数：取配置记录数()

返回存储对象中包含多少条配置数据。代码示例：变量配置数 = 取配置记录数()

' 获取配置项的数量
变量 配置数 = 取配置记录数()
调试输出("当前共有 " + 配置数 + " 项配置")

' 根据缓存数量决定处理逻辑
如果(取配置记录数() > 0)
	调试输出("存在配置数据，可以进行恢复")
否则
	调试输出("无配置数据，需要初始化")
结束 如果

函数：保存临时数据(键名,值)

存储指定键值对到会话存储中。代码示例：保存临时数据("表单数据", 表单内容)

' 存储临时表单数据
变量 表单内容 = {
	"姓名": 姓名输入框.内容,
	"电话": 电话输入框.内容
}
保存临时数据("表单数据", JSON编码(表单内容))

' 存储页面间临时传递的数据
保存临时数据("来源页面", "用户列表页")

' 存储购物车临时信息
保存临时数据("购物车商品数", 购物车.取商品数())

函数：取临时保存数据(键名)

从会话存储中获取指定键对应的值。代码示例：变量表单数据 = 取临时保存数据("表单数据")

' 获取临时表单数据
变量 表单数据JSON = 取临时保存数据("表单数据")
如果(表单数据JSON != 空)
	变量 表单数据 = JSON解析(表单数据JSON)
	姓名输入框.内容 = 表单数据.姓名
	电话输入框.内容 = 表单数据.电话
结束 如果

' 获取页面间传递的临时数据
变量 来源页面 = 取临时保存数据("来源页面")
如果(来源页面 == "用户列表页")
	返回按钮.显示模式 = 显示_块
结束 如果

函数：删除临时数据(键名)

从会话存储中移除指定键及其对应的值。代码示例：删除临时数据("表单数据")

' 删除临时表单数据
删除临时数据("表单数据")

' 提交表单后清除临时数据
提交按钮.置被单击回调((源对象, 事件) => {
	' 执行提交操作
	提交表单()

	' 清除临时存储的表单数据
	删除临时数据("表单数据")
	弹出提示("提交成功")
})

函数：清空临时数据()

清空所有存储在会话存储中的数据。代码示例：清空临时数据()

' 清空所有会话存储数据
清空临时数据()

' 用户注销时清除会话数据
注销按钮.置被单击回调((源对象, 事件) => {
	清空临时数据()
	切换页面("登录页")
})

函数：取临时数据记录数()

返回临时存储对象中包含多少条数据。代码示例：变量临时数据数 = 取临时数据记录数()

' 获取临时数据项的数量
变量 临时数据数 = 取临时数据记录数()
调试输出("当前会话共有 " + 临时数据数 + " 项临时数据")

' 检查是否有临时数据
如果(临时数据数 > 0)
	调试输出("检测到临时数据，正在恢复...")
	恢复临时数据()
结束 如果

学习要点

知识点	代码示例	说明
持久化存储	`保存配置("用户名", "张三")`	基于 localStorage，浏览器关闭后数据仍保留，适合用户偏好、登录状态等
会话存储	`保存临时数据("表单数据", 内容)`	基于 sessionStorage，标签页关闭后自动清除，适合表单草稿、页面间传值
对象序列化	`保存配置("用户信息", JSON编码(用户信息))`	localStorage 只能存字符串，存储对象/数组必须先用 `JSON编码` 转换
对象反序列化	`变量用户 = JSON解析(读取配置("用户信息"))`	读取后用 `JSON解析` 还原为对象，再访问其属性
空值判断	`如果(读取配置("key") != 空)`	键不存在时返回 `空`，需先判空再使用，避免对空值调用方法报错
数值类型转换	`变量次数 = 到整数(读取配置("访问次数"))`	读取出来的数字是字符串型，需用 `到整数`/`到小数` 转换后参与数学运算
批量清理	`清空配置()` / `清空临时数据()`	退出登录时清空全部数据，避免隐私泄露
记录数查询	`取配置记录数()` / `取临时数据记录数()`	获取存储中的键值对总数，用于判断是否有数据可恢复

轻语言网站开发SDK文档