dialog.close() 不接受参数，关闭原因需通过 dialog.returnValue 属性传递：必须在调用 close() 前赋值，如 dialog.returnValue = 'confirm'；若 dialog 内含 method="dialog" 的表单，则按钮 value 会自动赋给 returnValue，但仅限 type="submit" 按钮。
dialog.close() 方法根本不接受参数
直接传参如 dialog.close('confirm') 是无效的，浏览器会忽略这个字符串。原生 close() 是一个无参函数，它只负责关闭 dialog 并触发 close 事件 —— 至于“为什么关”，得靠 returnValue 属性来承载语义。
真正传“关闭原因”的方式是提前赋值 returnValue
必须在调用 close() 之前，手动给 dialog 实例设置 returnValue 字符串属性：
-
dialog.returnValue = 'confirm'→ 然后dialog.close() -
dialog.returnValue = 'cancel'→ 然后dialog.close() -
dialog.returnValue = 'overlay'→ 然后dialog.close()（用于遮罩点击场景）
这个值会在 close 事件处理函数中通过 dialog.returnValue 读取，且不会因 Esc 或 backdrop 关闭而丢失（除非你没提前设）。
常见错误：混淆 close() 和表单 method="dialog"
如果 dialog 内部是 <form method="dialog">，那么按钮的 value 会自动写入 returnValue，此时不用手动赋值：
立即学习“前端免费学习笔记（深入）”；
<dialog id="myDialog">
<form method="dialog">
<button value="confirm">确定</button>
<button value="cancel">取消</button>
</form>
</dialog>
但注意：method="dialog" 只对 <button type="submit"> 生效；type="button" 仍需手动 dialog.returnValue = ...; dialog.close()。
监听 close 事件时读不到 returnValue？检查这三点
close 事件中读不到预期值，大概率是以下任一情况：
- 监听器绑定太晚 —— 在
dialog.close()之后才addEventListener('close', ...)，事件已丢失 -
returnValue赋值发生在close()之后，或压根没赋值（此时值为""，不是undefined） - dialog 没被
showModal()或show()激活过，close()静默失败，也不抛错
最稳妥的做法：打开前重置 dialog.returnValue = ''，所有关闭路径都显式赋值再 close()，并在 close 事件里统一处理逻辑 —— 别依赖“默认行为”。
