在 Electron 全屏 Kiosk 应用中，当嵌入的 iframe 页面包含 mailto: 链接时，系统默认会启动外部邮件客户端，导致用户脱离应用。本文介绍如何通过 will-frame-navigate 事件精准拦截此类跨帧导航请求，无需修改 iframe 内容即可实现全局防护。
在 electron 全屏 kiosk 应用中，当嵌入的 iframe 页面包含 `mailto:` 链接时，系统默认会启动外部邮件客户端，导致用户脱离应用。本文介绍如何通过 `will-frame-navigate` 事件精准拦截此类跨帧导航请求，无需修改 iframe 内容即可实现全局防护。
Electron 的 webContents 提供了多个导航拦截事件，但需注意作用域差异：will-navigate 仅捕获主框架（top-level）的导航行为，对 iframe 内部触发的 mailto:、tel: 或普通 点击完全不生效——这正是许多开发者踩坑的关键点。
真正适用于嵌套 iframe 场景的是 will-frame-navigate 事件。该事件在任意子帧（包括跨源 iframe）发起导航前触发，且能获取完整 URL，是拦截第三方内容中不受控链接的理想选择。
以下为推荐的拦截方案（适用于主进程）：
// 假设 win 是你的 BrowserWindow 实例
win.webContents.on('will-frame-navigate', (event, url, frameName, frameProcessId, frameRoutingId) => {
// 拦截所有 mailto: 协议请求
if (url.startsWith('mailto:')) {
event.preventDefault();
console.log('[INFO] Blocked mailto link inside iframe:', url);
// 可选：向渲染进程发送通知，或触发自定义处理逻辑（如弹出内建联系表单）
// win.webContents.send('mailto-blocked', { url });
}
});
⚠️ 注意事项：
- 该事件必须在主进程注册，且需确保 win 已完成加载（例如在 'ready-to-show' 或 'did-finish-load' 后绑定）；
- will-frame-navigate 在 Electron 12+ 中稳定支持，旧版本请升级至 LTS 版本（如 v24+）以获得最佳兼容性与安全性；
- 若需同时拦截其他协议（如 tel:、sms:），可扩展判断条件：if (['mailto:', 'tel:', 'sms:'].some(proto => url.startsWith(proto)))；
- 该拦截不影响 iframe 自身的 JavaScript 导航行为（如 location.href = 'mailto:...'），因其属于脚本执行而非用户导航；若需彻底禁用，建议结合 contextIsolation: true + sandbox: true 的 iframe 属性，并在渲染进程中重写 window.location setter（高级场景，非必需）。
总结：面对不可控的第三方 iframe 内容，will-frame-navigate 是 Electron 提供的最直接、最可靠的跨帧导航拦截机制。相比 hack 式的 DOM 注入或网络层拦截，它轻量、可靠、符合平台设计规范，是构建高可靠性 Kiosk 应用的必备实践。
