iframe 存储通信 — 对接文档 & Demo

🧪 在线测试

📥 存储数据

Key Value

📤 查询数据

Key

📋 通信日志

iframe 存储通信 — 对接文档 & Demo

📋 对接文档

通信方式

使用 window.parent.postMessage(data, '*') 向父页面发送消息，
通过 window.addEventListener('message', handler) 接收父页面回复。

1. 存储数据 Request

字段	类型	必填	说明
`type`	string	是	固定值 `"set-storage"`
`key`	string	是	存储键名，见下方校验规则
`value`	any	否	存储的值，支持 string / number / object / array 等

Response

字段	类型	说明
`type`	string	`"storage-set"`
`key`	string	请求的 key
`success`	boolean	是否存储成功
`message`	string	成功返回 `"xxx stored successfully"`，失败返回具体错误原因

2. 查询数据 Request

字段	类型	必填	说明
`type`	string	是	固定值 `"get-storage"`
`key`	string	是	查询的键名

Response

字段	类型	说明
`type`	string	`"storage-get"`
`key`	string	请求的 key
`exists`	boolean	是否存在该 key 的数据
`value`	any	存在时返回存储的值，不存在时为 `null`
`message`	string	不存在时返回 `"not found"`

3. 校验规则 Constraints

规则	限制	违规时返回的 message
Key 字符	仅允许 `A-Z a-z 0-9 _ . -`	`invalid key: only letters, numbers, underscore, dot, hyphen allowed`
Key 长度	最长 64 字符	`key too long, max 64 chars`
Key 必填	必须为 string 类型	`invalid key: key is required and must be a string`
单 Value 大小	最大 100KB	`value too large, max 100KB`
总存储容量	所有 iframe 数据合计上限 2MB	`storage quota exceeded, max 2MB total for iframe data`
Key 数量	最多 50 个 key	`too many keys, max 50 keys allowed`
localStorage 异常	浏览器存储满等极端情况	`storage failed, localStorage may be full`

⚠ 所有 iframe 存储数据均以 iframe_ 为前缀写入 localStorage，与宿主项目数据隔离，不会相互影响。