必须显式返回 Promise 才能阻塞关闭：beforeEnd() { return fetch('/api/cleanup').then(r => r.json()); }✅；箭头函数隐式返回 undefined 会导致立即关闭❌；Layui 2.9.11+ 支持，需 try/catch 跨域 iframe 通信并禁用按钮防重复点击。
必须用 beforeEnd 回调，且显式返回 Promise —— 否则异步逻辑会被忽略，弹窗直接关闭。
beforeEnd 必须 return Promise 才生效
这个回调不是“写了 await 就自动等”的魔法。Layui 2.9.11+ 才支持 Promise 阻塞，且只认函数的 返回值：
-
beforeEnd: async () => { await cleanup(); }❌ —— 箭头函数隐式返回undefined，layer 当同步执行，立刻关 -
beforeEnd() { return fetch('/api/cleanup').then(r => r.json()); }✅ —— 显式返回 Promise，成功则继续关闭 -
beforeEnd() { return Promise.reject(new Error('保存失败')); }✅ —— reject 会取消关闭，但需手动提示用户
清理失败时怎么拦住关闭并提示用户
单纯 return false 只能阻断，拿不到错误细节；Promise.reject() 能保留上下文，但 UI 需你兜底：
- 在
beforeEnd开头就禁用关闭按钮（比如加disabled或加 loading class），防重复点击 - 用
try/catch包裹请求，失败时调layer.msg('请先保存', {icon: 2}) -
不要 在
catch里调layer.close(index)—— 此时 layer 已进入关闭流程，二次 close 会冲突 - reject 后弹窗仍开着，用户可重试或改操作
iframe 弹层的 beforeEnd 实际上在父页执行
type: 2 的弹层，beforeEnd 是在父页面上下文运行的，但你要清理的逻辑（如表单提交、校验）往往在 iframe 子页里：
- 子页不能自己定义
beforeEnd，得靠通信：子页暴露window.onDestroy = () => { return fetch(...); } - 父页
beforeEnd中调用：const iframe = layero.find('iframe')[0]; return iframe.contentWindow.onDestroy?.() || Promise.resolve(); - 务必
try/catch—— 跨域 iframe 会抛SecurityError，未定义onDestroy会报undefined is not a function - 别依赖
window.name传索引，打包工具可能篡改它；open 时显式设name: 'edit-form-' + Date.now()
为什么不用 cancel 或 end 来做销毁前清理
这两个钩子定位完全不同，错用会导致逻辑漏执行或重复执行：
-
cancel只响应右上角 × 和 Esc，不覆盖layer.close()、遮罩点击、iframe 内调用等其他关闭路径 -
end是 DOM 彻底移除后触发的，此时元素已从 document detach，无法再发请求或操作 DOM -
beforeClose虽然也拦截所有关闭，但它发生在 DOM 销毁前、子页仍活跃时 —— 若这时清 sessionStorage，子页可能立刻重写，造成状态不一致
真正要“销毁前执行”，只有 beforeEnd 这一个位置，且它的行为完全取决于你是否 return 一个 Promise。漏掉 return，等于没写。
