dialog.close() 不支持传参赋值 returnValue，必须先手动设置 dialog.returnValue 再调用 close()；showModal() 需 await 等待 Promise resolve 才能读取 returnValue；cancel 事件可拦截非按钮关闭并设值；Safari 不支持 returnValue，需降级处理。
dialog.close() 本身不支持传参，returnValue 必须手动设置
直接调用 dialog.close("success") 不会把字符串写入 returnValue —— 这是常见误解。HTML <dialog></dialog> 的 close() 方法只接受零个或一个参数（该参数会被忽略），returnValue **不会自动赋值**。必须在调用 close() 前，显式给 dialog.returnValue 赋值。
典型错误现象：dialog.close("ok"); console.log(dialog.returnValue) 输出空字符串，不是 "ok"。
- 正确做法：先设
dialog.returnValue = "confirmed"，再调dialog.close() - 仅当
dialog处于打开状态（open属性为true）时设置returnValue才有效 -
returnValue类型不限，可以是字符串、数字、对象，但注意 JSON 序列化/反序列化需自行处理
showModal() 后必须用 await dialog.showModal() 才能读取 returnValue
很多人用 dialog.showModal() 但没加 await，导致后续立即读 returnValue 得到空值。因为 showModal() 是异步方法，返回一个 Promise，只有 Promise resolve 后，才表示对话框已关闭且 returnValue 已就绪。
- ✅ 正确：
const result = await dialog.showModal(); console.log(dialog.returnValue); - ❌ 错误：
dialog.showModal(); console.log(dialog.returnValue);（此时 dialog 还没关，returnValue 仍是初始空字符串） - 如果用户点击 backdrop 或按 Esc 关闭，
returnValue保持为空字符串，除非你主动拦截cancel事件并设值
拦截 cancel 事件来统一处理“非按钮关闭”场景
用户点遮罩层、按 Esc 或调用 dialog.close() 无前置赋值时，returnValue 都是空字符串。若需区分“取消”和“未操作”，得监听 cancel 事件并手动设值。
立即学习“前端免费学习笔记（深入）”；
dialog.addEventListener('cancel', (e) => {
e.preventDefault(); // 阻止默认关闭行为（可选）
dialog.returnValue = 'canceled';
dialog.close();
});
-
e.preventDefault()不是必须的，但加上后可确保你完全控制关闭逻辑 - 不加
preventDefault()时，事件仍会触发，但 dialog 也会照常关闭；此时你设的returnValue依然有效 - 注意：
cancel事件只在用户触发取消行为时发生，程序调用close()不会触发它
returnValue 在 Safari 中存在兼容性问题
Safari（截至 v17.5）不支持 dialog.returnValue，调用 showModal() 返回的 Promise 永远 resolve 为 undefined，且 returnValue 属性始终为 ""（即使你手动赋值）。
- 检测方式：
if ('returnValue' in HTMLDialogElement.prototype)—— Safari 返回false - 临时方案：改用自定义事件或全局变量暂存结果（如
window.dialogResult = "ok"），并在close事件里读取 - 更稳妥做法：对 Safari 使用 polyfill（如
dialog-polyfill），但它也不支持returnValue，需配合回调函数模拟
别指望 returnValue 在所有浏览器里表现一致——它目前仍是较新的特性，Safari 的缺失意味着生产环境必须做降级处理。
