dialog.close()不接受参数，必须先设置dialog.returnValue为字符串再调用close()；close事件中须从dialog实例读取returnValue，不可从event读取，传对象需JSON序列化。
dialog.close() 不接受任何参数，传值必须靠 returnValue
直接写 dialog.close('confirm') 是无效的——浏览器会忽略字符串参数，close() 方法签名就是无参的。真正能带语义地关闭 dialog 的方式只有一种：先给 dialog.returnValue 赋一个字符串值，再调用 dialog.close()。
常见错误包括：
- 误以为参数会被接收，结果
event.target.returnValue读出来是空字符串"" - 在
close()之后才赋值returnValue，此时事件中已无法捕获新值 - 用
dialog.open = false或hidden = true关闭，根本不会触发close事件，也不会设置returnValue
如何在 close 事件里可靠读取 returnValue
close 事件对象本身不携带 returnValue，它只负责通知“关了”，具体值必须从 dialog 实例上手动读取。监听器必须绑定在 dialog 元素本身，不能委托，也不能晚于 close() 调用。
正确写法示例：
立即学习“前端免费学习笔记（深入）”；
const dialog = document.getElementById('myDialog');
dialog.addEventListener('close', () => {
const result = dialog.returnValue; // ✅ 正确：从实例读
console.log(result); // 'confirm' / 'cancel' / 'dismiss'
});
容易踩的坑：
- 写成
event.returnValue→ 报错或undefined，因为事件对象没有这个属性 - 监听器绑在父容器上想靠冒泡捕获 →
close虽然可冒泡，但实际结构中几乎不用，且易混淆目标 dialog - 没重置
returnValue就重复打开 → 上次的值还在，导致逻辑错乱
form[method="dialog"] 的 value 不会自动进 returnValue？得手动拦截
很多人以为只要写 <form method="dialog"><button value="confirm">确定</button></form>，点击就会让 dialog.returnValue 变成 "confirm"。其实只对 type="submit" 按钮生效，而且前提是表单提交未被阻止。
但问题在于：method="dialog" 只做一件事：自动调用 dialog.close()，它**不设 returnValue，也不序列化字段，更不阻止默认行为以外的逻辑**。所以如果你加了 event.preventDefault() 或用了 type="button"，value 就完全失效。
稳妥做法是统一拦截 submit：
dialog.querySelector('form').addEventListener('submit', (e) => {
e.preventDefault();
const btn = e.submitter;
if (btn && btn.value) {
dialog.returnValue = btn.value;
}
dialog.close();
});
传对象怎么办？JSON 序列化是唯一可行路径
dialog.returnValue 类型强制为字符串，传数字、布尔、对象都会被转成字符串（true → "true"，{id: 1} → "[object Object]"）。真要传结构化数据，只能自己序列化。
例如：
// 关闭前
dialog.returnValue = JSON.stringify({ id: 123, action: 'edit', timestamp: Date.now() });
dialog.close();
// close 事件中
dialog.addEventListener('close', () => {
try {
const data = JSON.parse(dialog.returnValue);
console.log(data.id); // 123
} catch (e) {
console.warn('returnValue 解析失败，可能是空值或非法 JSON');
}
});
注意点：
- 别忘了
try/catch，因为用户按 Esc 或 backdrop 关闭时，returnValue可能还是空字符串 - 不要依赖
returnValue === undefined判断是否取消——它的初始值就是""，不是undefined - 如果 dialog 会被多次复用，每次打开前最好重置
dialog.returnValue = ''，避免残留旧值
returnValue 的生命周期、赋值时机、事件读取位置这三点一旦错位，就很难 debug。最稳的模式是：打开前清空、所有关闭路径都显式赋值、close 事件里只读不猜。 
