HTMLDialogElement 实例不提供 returnValue 属性，也不支持通过该属性读取关闭时的返回值；其返回值仅通过 close 事件对象的 returnValue 属性获取，且必须由显式调用 dialog.close(value) 触发。
dialog 元素根本没有 returnValue 属性
直接说结论：HTMLDialogElement 实例（即 <dialog> 元素）**不提供 returnValue 属性**，也**不支持通过该属性读取关闭时的返回值**。这是常见误解，源于混淆了 <dialog> 与旧式 window.showModalDialog()（已废弃）或某些 UI 库（如 Bootstrap Modal）的 API 设计。
关闭 dialog 后如何获取“返回值”？用 close() 的参数 + event.returnValue
标准 <dialog> 的交互逻辑是：调用 dialog.close(<var>returnValue</var>) 时传入的字符串，会作为 close 事件对象的 returnValue 属性值（注意：这是事件对象上的属性，不是 dialog 元素自身的属性）。
实操要点：
- 必须显式调用
dialog.close("confirmed")，不能只靠点击 backdrop 或按 Esc —— 那些情况触发的close事件中，event.returnValue是空字符串"" - 监听的是
dialog元素上的close事件，不是click或keydown -
event.returnValue类型固定为DOMString，传数字或对象会被自动转成字符串
const modal = document.querySelector('dialog');
modal.addEventListener('close', (e) => {
console.log(e.returnValue); // "yes", "no", 或 ""
});
// ✅ 正确触发带值的关闭
buttonYes.addEventListener('click', () => modal.close('yes'));
buttonNo.addEventListener('click', () => modal.close('no'));
// ❌ 点击遮罩或 Esc：e.returnValue === ""
为什么不能直接读 dialog.returnValue？兼容性与规范现状
当前所有主流浏览器（Chrome 97+、Firefox 99+、Safari 15.4+）均未实现 dialog.returnValue 这一属性。MDN 和 WHATWG HTML 标准中从未定义该属性 —— 它只存在于部分过时文档或开发者臆测中。
立即学习“前端免费学习笔记（深入）”；
将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML，替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度，HTML 能同时承载排版、表格、SVG 等。
影响与替代方案：
- 无法像
prompt()那样同步获取返回值；必须依赖异步的close事件 - 若需模拟“同步返回”，得自行封装 Promise（例如
showModalAsync()工具函数），但底层仍靠事件驱动 - 注意 Safari 对
<dialog>的showModal()支持较晚（15.4+），且不支持close()参数在早期版本中被忽略
容易踩的坑：event.returnValue 被覆盖或读不到
常见错误现象：监听了 close 事件，但 e.returnValue 总是空字符串。
原因和对策：
- 忘记调用
close("value")，而是用modal.open = false或modal.removeAttribute("open")—— 这不会触发close事件，更无returnValue - 在
close事件监听器里又调用了dialog.close()，导致事件重入，e.returnValue可能被覆盖为默认空值 - 使用了
preventDefault()在close事件中 —— 不合法，该事件不可取消，调用无效且可能干扰调试 - 监听了错误的目标：比如监听
document或按钮，而不是<dialog>元素本身
真正可控的返回值，只来自你主动调用的那一次 dialog.close(<var>string</var>)，其他关闭方式没有“返回值”概念 —— 这不是缺陷，而是设计使然。
