dialog.returnValue 是只读属性，只能通过 close("value") 设置；监听 close 事件后读取才有效，仅 showModal() 模式下支持，Chrome 97+、Edge 97+、Firefox 116+ 支持，Safari 不支持。
dialog.returnValue 是只读属性，不能直接赋值
很多开发者看到 returnValue 就以为能像表单控件一样设置它，结果发现赋值无效：myDialog.returnValue = "confirm" 不会改变任何行为。这是因为规范明确将 returnValue 定义为只读属性（readonly），它的值只能由 close() 方法的参数决定。
常见错误现象：dialog.returnValue 始终为空字符串，即使你手动写了 dialog.returnValue = "ok"，读出来还是空。
- 正确做法：调用
dialog.close("ok")后，dialog.returnValue才会变成"ok" - 不调用
close()或只调用close()（无参），returnValue保持空字符串 - 浏览器兼容性：Chrome 97+、Edge 97+、Firefox 116+ 支持；Safari 目前仍不支持
returnValue（截至 Safari 17.5）
用 close() 参数设置 returnValue 的典型场景
实际开发中，returnValue 主要用于模态确认框的分支逻辑判断，比如“确定/取消”之后执行不同操作。它替代了过去靠自定义事件或 data 属性传递意图的做法。
示例：一个删除确认对话框
立即学习“前端免费学习笔记（深入）”；
<dialog id="confirmDelete">
<span>确定要删除这条记录吗？</span>
<button onclick="this.closest('dialog').close('yes')">确定</button>
<button onclick="this.closest('dialog').close('no')">取消</button>
</dialog>
<script>
const dialog = document.getElementById('confirmDelete');
dialog.addEventListener('close', () => {
if (dialog.returnValue === 'yes') {
performDelete();
}
});
</script>
-
close("yes")和close("no")是唯一可靠设置returnValue的方式 - 注意：必须监听
close事件后再读取returnValue，在open或点击按钮瞬间读是旧值 - 不要混用
showModal()和show()：只有showModal()激活的 dialog 才支持returnValue（show()不触发close事件，也不更新returnValue）
returnValue 与 showModal() 的配合要点
dialog.returnValue 只在 showModal() 模式下有意义。这是它和普通元素最根本的区别——它不是状态容器，而是模态交互的结果出口。
- 调用
dialog.showModal()后，页面焦点被锁定，用户必须关闭 dialog 才能继续操作 - 此时
close("submit")会结束模态流，并把"submit"写入returnValue - 如果用户按 Esc 关闭，
returnValue为空字符串（等价于close()） - 性能影响极小，但要注意：反复调用
showModal()而不清理事件监听器，可能造成内存泄漏
Firefox 和 Safari 的兼容性现实
别在生产环境依赖 returnValue 做核心逻辑分支，尤其面向公众用户的项目。
- Firefox 116+ 才开始支持
returnValue，旧版本返回undefined（不是空字符串） - Safari 完全未实现该属性，
dialog.returnValue访问会报undefined，且close("x")的参数被忽略 - 稳妥方案：降级使用自定义事件 + dataset，例如
dialog.dispatchEvent(new CustomEvent('dialog-close', { detail: { action: 'confirm' } })) - 检测方式：
typeof dialog.returnValue !== 'undefined'可初步判断支持度，但不能替代功能测试
真正容易被忽略的是：即便 Chrome 中一切正常，只要用户开着 Safari 或旧版 Firefox，returnValue 就不可靠。上线前务必在目标浏览器里点开 dialog 并检查 close() 后的值。
