dialog.close()不接受参数，returnValue必须提前赋值为字符串；错误写法如dialog.close('confirm')无效，正确顺序是先dialog.returnValue='confirm'再dialog.close()。
dialog.close() 不接受参数，returnValue 必须提前赋值
很多人写 dialog.close('confirm') 以为能传值，结果 dialog.returnValue 始终为空字符串。这是根本性误解：close() 方法签名是 close(): void，所有参数都会被忽略。真正起作用的是 dialog.returnValue 这个属性——它必须在调用 close() 之前手动赋值，且只能是字符串。
常见错误现象：点击确认按钮后，close 事件里读到的 dialog.returnValue 是 ""（空字符串），不是预期的 "confirm"。
- 正确顺序：先
dialog.returnValue = 'confirm'，再dialog.close() - 错误写法：
dialog.close('confirm')（参数无效）或dialog.close(); dialog.returnValue = 'confirm'（赋值太晚，事件中读不到） - 值会被强制转为字符串：传
true得到"true"，传对象会变成"[object Object]"，不推荐
区分用户操作必须靠按钮点击时主动设置 returnValue
close 事件本身不带来源信息，Esc、backdrop 点击、按钮点击触发的事件完全一样。想区分“确定”“取消”“关闭”，唯一可靠方式是在对应按钮的点击处理中显式设置 returnValue 并调用 close()。
使用场景：弹窗含“保存”“放弃”“关闭”三个按钮，需分别响应不同逻辑。
立即学习“前端免费学习笔记（深入）”；
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面，使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力： - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面； - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”； - 提及位于 `apps/console/src/featur
- 给每个按钮加唯一
value或data-action，例如<button data-action="save">保存</button> - 统一绑定点击事件，读取
event.target.dataset.action，赋值并关闭：dialog.returnValue = action; dialog.close(); - 不要依赖
form method="dialog"的自动行为——它只对<button type="submit"></button>有效，且 Safari 对其value传递支持不稳定 - 用户按 Esc 关闭时，
returnValue保持你上次设的值（哪怕设的是"save"），所以建议在打开前重置：dialog.returnValue = ""
监听 close 事件必须在 close() 调用前完成绑定
close 是一次性事件，如果在 dialog.close() 执行之后才添加监听器，事件就丢失了，回调永远不会执行。
性能与兼容性影响：Chrome 110+、Firefox 111+ 支持良好；Safari 17.4+ 开始支持 returnValue，但更早版本（如 15.4–17.3）中 dialog.returnValue 始终为 ""，无法区分意图。
- 监听必须直接挂在
dialog元素上：dialog.addEventListener('close', handler)，不能用事件委托 - 推荐在获取到
dialog实例后立即绑定，比如const dialog = document.getElementById('myDialog'); dialog.addEventListener('close', ...) - 若需确保只响应一次，可加
{ once: true }选项，避免重复注册导致内存泄漏 - 别在
close事件回调里再次调用close()，会抛出"InvalidStateError: Dialog is not open"
要真正拿到用户输入数据，不能依赖 returnValue
dialog.returnValue 只适合传轻量状态标识（如 "submit"、"cancel"），不是数据容器。表单字段、勾选项、富文本内容等，必须在调用 close() 前主动读取并存入变量。
容易踩的坑：在 close 事件回调里再去查 dialog.querySelector('input').value，此时 DOM 可能已失去焦点、被隐藏，甚至被脚本移除（尤其用了 open=false 或 remove()）。
- 正确做法：在确认按钮点击时读取全部数据，例如
const data = Object.fromEntries(new FormData(form)) - 然后调用
dialog.close()，把业务逻辑和数据处理放在点击回调里，而不是close事件里 - 如果非要异步等待用户操作，用 Promise 封装：
async function showModalAsync() { ... return new Promise(r => dialog.addEventListener('close', () => r(dialog.returnValue), { once: true })) } - 注意：原生
showModal()不返回 Promise，await dialog.showModal()是语法错误
