WordPress站点中Safari 13.1版本下window.open下载文件后标签页无法自动关闭的解决方案咨询

这个问题我之前在适配Safari的时候也碰到过，确实是Safari 13.x版本里的一个头疼的限制——它对window.close()的触发时机和条件卡得特别严，而且下载流程的事件监听也不像Chrome/Firefox那么友好。给你两个实际可行的解决方案，你可以根据自己的场景选择：

方案一：改用隐藏iframe触发下载（推荐） #

最稳妥的办法是彻底避免打开新标签页，用一个隐藏的iframe来触发下载请求。这样既不会出现多余的标签页，也不需要处理关闭逻辑，完美适配Safari：

function startFileDownload() {
  // 创建隐藏的iframe
  const downloadIframe = document.createElement('iframe');
  downloadIframe.style.display = 'none';
  // 设置下载链接
  downloadIframe.src = 'admin.php?action=downloadfile&name=53t52jd6772';
  // 添加到页面
  document.body.appendChild(downloadIframe);

  // 一段时间后移除iframe（避免页面冗余元素）
  setTimeout(() => {
    if (downloadIframe.parentNode) {
      document.body.removeChild(downloadIframe);
    }
  }, 5000); // 可根据文件大小调整超时时间，大文件可以适当延长
}

这个方法的优势是：

• 完全不需要打开新标签页，从根源上解决关闭问题
• Safari会正常弹出下载确认提示框，用户操作不受影响
• 代码简单，兼容性好，所有主流浏览器都支持

方案二：通过Cookie轮询实现窗口自动关闭（针对必须用window.open的场景） #

如果业务场景必须用window.open打开新标签页，那可以通过PHP设置Cookie+前端轮询Cookie的方式，判断下载是否已经触发，再安全关闭窗口：

步骤1：在PHP的下载逻辑中添加Cookie #

在你输出下载文件的downloadfile动作里，发送文件头之前，先设置一个标记下载状态的Cookie：

// 假设文件名通过GET参数name传递
$fileName = $_GET['name'];
// 设置一个有效期30秒的Cookie，标记下载已触发
setcookie(
  'download_triggered_' . $fileName,
  '1',
  time() + 30,
  '/' // 确保Cookie在全站有效
);

// 接下来是你的文件下载header逻辑
header('Content-Type: application/octet-stream');
header('Content-Disposition: attachment; filename="your-file-name.ext"');
// ... 输出文件内容

步骤2：前端轮询Cookie并关闭窗口 #

打开新窗口后，定时检查Cookie是否存在，一旦检测到Cookie，就关闭窗口：

function openDownloadWindow() {
  const fileName = '53t52jd6772';
  const downloadWindow = window.open(
    `admin.php?action=downloadfile&name=${fileName}`,
    '_blank'
  );

  // 轮询Cookie的定时器
  const checkCookieTimer = setInterval(() => {
    // 查找目标Cookie
    const cookieEntry = document.cookie.split('; ').find(
      row => row.startsWith(`download_triggered_${fileName}=`)
    );

    if (cookieEntry) {
      // 关闭窗口（确保窗口未被手动关闭）
      if (downloadWindow && !downloadWindow.closed) {
        downloadWindow.close();
      }
      // 清除定时器
      clearInterval(checkCookieTimer);
      // 删除Cookie，避免干扰后续下载
      document.cookie = `download_triggered_${fileName}=; expires=Thu, 01 Jan 1970 00:00:00 UTC; path=/;`;
    }
  }, 500); // 每500毫秒检查一次
}

这个方案的原理是：PHP在发送下载文件时，给浏览器设置一个标记Cookie，前端通过轮询这个Cookie，确认下载请求已经被服务器处理，此时再关闭窗口就不会打断用户的下载确认操作了。

注意：Safari对window.close()有严格限制，只有由当前脚本打开的窗口才能被脚本关闭，所以这个方案里必须确保downloadWindow是当前页面脚本打开的，否则无法关闭。

内容的提问来源于stack exchange，提问作者DevD