见过一个挺典型的线上问题:订单提交接口返回 500,前端却弹出了「下单成功」。查代码发现用的是 fetch,然后直接 .then() 里写成功逻辑。很多人以为请求失败会走 catch,实际不是:fetch 只在网络层出问题时才 reject,服务器返回 500 也算「请求成功完成」,只是状态码不好看。

浏览器这几年把很多原本要靠第三方库做的事收回了自己身上:发请求、监听元素是否进入视口、读写剪贴板、读本地文件。用原生 API 能少一堆依赖,但它们的限制也比库更硬,尤其是权限和用户手势。这篇讲常用的几类,重点放在「什么地方会踩坑」和「什么场景不该用」。

fetch:先用 response.ok 判断成败

一个可靠的请求写法,至少要把这三件事分清楚:请求发出去了没有、服务器说成功还是失败、响应内容能不能解析。

async function loadOrders() {
  const res = await fetch('/api/orders', {
    headers: { 'Accept': 'application/json' },
  });

  // 404、500 都不会让 fetch reject,必须自己判断
  if (!res.ok) {
    throw new Error('接口返回 ' + res.status);
  }

  return res.json();
}

res.ok 在状态码 200 到 299 时为 true。真正会让 await fetch 抛错的情况,通常是断网、DNS 失败、请求被取消这类连响应都没拿到的问题。所以「网络错误」和「业务失败」要分开处理,前者适合提示「网络不稳定」,后者要看后端返回的具体错误码。

响应体还有个坑:只能读一次。res.json() 读完之后再调 res.text() 会报错,因为流已经被消费。确实要读两次,就在读之前 res.clone(),但别养成习惯,克隆大响应会多占内存。

取消请求和超时:fetch 本身不提供

fetch 没有超时参数,也没有取消方法,要靠 AbortController。真实场景里这很重要:用户在搜索框里连续输入,前一次请求还没回来就又发了新的,旧结果回来晚了会把新结果覆盖掉。

let controller = null;

async function search(keyword) {
  if (controller) controller.abort(); // 取消上一次
  controller = new AbortController();

  const timer = setTimeout(() => controller.abort(), 8000); // 自己实现超时

  try {
    const res = await fetch('/api/search?q=' + encodeURIComponent(keyword), {
      signal: controller.signal,
    });
    if (!res.ok) throw new Error('搜索失败:' + res.status);
    return await res.json();
  } catch (err) {
    if (err.name === 'AbortError') return null; // 主动取消,不算错误
    throw err;
  } finally {
    clearTimeout(timer);
  }
}

要注意 abort() 触发的是 AbortError,不是普通网络错误。如果不单独判断,用户每敲一个字就会看到一个「请求失败」的提示,体验很差。

IntersectionObserver:别再监听滚动算位置

「图片滚动到视口再加载」「列表项曝光统计」这类需求,老写法是监听 scroll 然后逐个算 getBoundingClientRect()。监听器每一帧都在跑,元素一多就是灾难。

IntersectionObserver(交叉观察者)是浏览器提供的替代方案:你告诉它「观察哪些元素、相对于哪个容器、进入多少算可见」,元素进出视口时它主动回调你,不用自己算。

const observer = new IntersectionObserver(
  (entries) => {
    for (const entry of entries) {
      if (!entry.isIntersecting) continue;

      const img = entry.target;
      img.src = img.dataset.src;       // 真正开始下载
      observer.unobserve(img);         // 加载过就不用再看了
    }
  },
  { rootMargin: '200px 0px' }         // 提前 200px 开始加载
);

document.querySelectorAll('img[data-src]').forEach((img) => {
  observer.observe(img);
});

它的回调不是精确到每一像素的,浏览器会合并计算,可能存在一点延迟。用来做懒加载、曝光统计没问题;用来做「元素位置每一帧都精确同步」的动画就不合适,那种还是得用 requestAnimationFrame。

同族的还有 ResizeObserver,用来观察元素尺寸变化,比自己监听 window.resize 再算元素大小可靠得多,因为元素尺寸变化不一定是窗口变化引起的。

MutationObserver:观察 DOM 变化

有些第三方脚本或老组件会在你不知情的时候改 DOM,你想知道「什么时候变了」。MutationObserver(变动观察者)就是干这个的:观察某个节点,子节点增删、属性变化、文本变化时回调。

const target = document.querySelector('#legacy-widget');

const mo = new MutationObserver((mutations) => {
  for (const m of mutations) {
    if (m.type === 'attributes' && m.attributeName === 'data-status') {
      syncStatus(m.target.dataset.status);
    }
  }
});

mo.observe(target, {
  attributes: true,
  attributeFilter: ['data-status'],
  subtree: true,
});
观察范围越大,回调越频繁,主线程越容易被拖慢。不要对 document.body 开 subtree: true 加 attributes: true 然后什么都不筛,那等于给自己装了一个全天候监听器。用完记得 disconnect()。

剪贴板:为什么按钮点了没反应

「复制链接」按钮写起来就一行,但线上经常失效,原因几乎都跟两个限制有关:必须在安全上下文里(HTTPS 或 localhost),必须在用户手势里调用。

copyButton.addEventListener('click', async () => {
  try {
    await navigator.clipboard.writeText(shareUrl);
    toast('已复制');
  } catch (err) {
    // 常见原因:不是 HTTPS、浏览器不支持、用户拒绝权限
    toast('复制失败,请手动选中复制');
  }
});

这两个限制不是故意为难人。剪贴板能读到用户从别处复制的内容,如果任何页面都能静默读写,等于把用户的剪贴板开放给所有网站。所以浏览器要求「用户明确点了某个东西」才允许写,读取则通常还要额外授权。

实际项目里的取舍:navigator.clipboard 在桌面端现代浏览器上基本可用,但在一些旧浏览器或非安全环境里会直接没有这个对象。如果复制是核心流程,准备一个降级方案:选中文本让用户自己按快捷键,或者提供一个只读输入框。别把「复制成功」当成必然结果。

读取剪贴板(readText)的权限提示和浏览器支持差异较大,具体行为在不同版本里可能变化,属于待确认部分。做「粘贴图片」「读取剪贴板内容」这类功能前,先在你的目标浏览器上实测。

文件读取:用户选的,你才能读

网页不能随便翻你电脑里的文件,必须由用户主动选择。标准做法是 <input type="file">,拿到 File 对象之后再读内容。

const input = document.querySelector('#import-file');

input.addEventListener('change', async () => {
  const file = input.files[0];
  if (!file) return;

  // 小文本文件直接读成字符串,简单够用
  const text = await file.text();

  // 大文件或需要进度时,用 FileReader
  if (file.size > 10 * 1024 * 1024) {
    const reader = new FileReader();
    reader.onprogress = (e) => {
      if (e.lengthComputable) {
        console.log('已读取 ' + Math.round(e.loaded / e.total * 100) + '%');
      }
    };
    reader.onload = () => parseCsv(reader.result);
    reader.readAsText(file);
  } else {
    parseCsv(text);
  }
});

几个经验点:file.text() 适合小文件,简单;大文件想要进度条就用 FileReader;图片预览用 URL.createObjectURL(file) 生成临时地址,用完记得 URL.revokeObjectURL,否则内存会被占着。还有,accept 属性只是给文件选择框一个过滤提示,用户仍然可以选别的类型,真正的校验要在代码里做。

拖拽上传同理,需要在 dragover 和 drop 里调用 preventDefault(),否则浏览器会直接用新文件替换当前页面,用户正在填的表单就没了。

权限与用户手势:绕不过去的两道门

浏览器把敏感能力都收在权限后面:定位、摄像头、麦克风、剪贴板读取、通知、持久存储。用这些 API 之前,先要处在安全上下文(HTTPS 或 localhost),再要拿到用户授权。有些权限还会弹系统级对话框,用户点「拒绝」之后,同一页面短期内可能不会再弹。

「用户手势」是另一道门:很多 API 只在用户刚刚点过、按过键的那一小段时间内可用。它的问题在于「激活状态」会在一些异步操作后失效,所以下面这种写法经常失败:

// 可能失败:await 之后手势激活状态已经丢了
button.addEventListener('click', async () => {
  await saveDraft();                 // 一段耗时请求
  await navigator.clipboard.writeText(text); // 此时可能被拒绝
});

稳妥的做法是把需要手势的操作尽量放在点击回调的最前面,先复制、再去做别的事;或者明确提示用户「再点一次」。这类问题在开发机上经常测不出来,因为某些浏览器对本地环境的限制更松,上线后才暴露。

不要用「一进页面就申请摄像头权限」这种写法。用户还没理解你要干什么,弹窗大概率被拒绝,而且拒绝一次之后很难再要回来。把申请放在用户主动点击「开始录像」之后,通过率会高很多。

走一遍真实排查:懒加载改了三版

一个商品列表页,一屏六张图,往下滚还有很多。为了省流量,产品要求图片滚到附近才加载。这个需求很小,但实现方式决定了页面是顺还是卡。

第一版,手写滚动监听。监听 scroll,在回调里遍历所有还没加载的图片,用 getBoundingClientRect() 判断有没有进入视口。功能是对的,问题是滚动明显掉帧,手机上滑到后半段像在拖一张湿纸。第一反应是「图片太大」,压了一轮图、换了更省流量的格式,图片请求确实变小了,滚动还是卡。这一步排除的是「下载慢」,不是「滚动卡」。

第二版,加节流。给 scroll 回调加了 100 毫秒节流,掉帧缓解了一些,但快速滚动时会出现一片空白,停手之后图片才陆续冒出来。而且 Performance 里仍然能看到每次回调都是一次强制布局,因为它读了 200 个元素的尺寸。节流减少的是次数,不是单次的成本。

第三版,换 IntersectionObserver。把「谁来观察可见性」交给浏览器:给每张图注册一个观察者,进入视口附近时再设置 src。滚动回调彻底没了,滚动期间的布局次数回到正常水平,空白的问题也用 rootMargin 提前预加载解决了。

const io = new IntersectionObserver((entries) => {
  for (const entry of entries) {
    if (!entry.isIntersecting) continue;
    const img = entry.target;
    img.src = img.dataset.src;   // 真正开始下载
    io.unobserve(img);           // 已经处理过,不再观察
  }
}, { rootMargin: '200px 0px' }); // 提前 200 像素开始加载

document.querySelectorAll('img[data-src]').forEach((img) => io.observe(img));

换完之后冒出的新问题。列表底部有「加载更多」,点一下追加二十张图,这些新图永远不加载。原因很直接:初始化时只对当时存在的图片调用了 observe,后来插入的没人管。改成「渲染新节点时就顺手 observe」,问题消失。这类 bug 不在 API 本身,而在「注册」这一步容易被忘掉。

还漏了一个。图片地址失效时,那一格是空白,用户以为没数据。补了 error 事件,加载失败换成占位图并显示「加载失败」,比空白强得多。这类兜底不属于「优化」,但属于可用性。

顺带发现的另一个问题。同一页面里用 fetch 上报曝光数据,用户在图片加载出来之前就点了跳转,那条上报请求被中断,后台统计少了约三成。这不是接口的错,是页面卸载时请求被取消。这类「页面离开也要发出去」的请求,可以用 fetch 的 keepalive: true 选项,让请求在页面卸载后继续完成;它有体积限制,只适合小数据量的埋点,不适合传大文件。

这个案例里,前两版都不是「写错了」,而是把浏览器的活揽到了自己身上:位置判断本来就是浏览器擅长的,你在 JS 里每帧算一遍,它还得停下来给你算。换成观察者,省掉的是这部分重复劳动。

现象对照:API 用错了长什么样

你看到的现象更可能的原因第一步查什么
接口返回 404 或 500,页面却把错误响应当成数据渲染fetch 只在网络层失败时 reject,HTTP 错误码仍然算「请求成功」看代码有没有判断 response.ok 或 status
控制台出现 AbortError,或者取消请求后页面报错abort() 会让请求以 reject 结束,没有单独处理在 catch 里判断 err.name === 'AbortError',这类错误可以直接忽略
本地开发正常,上线后图片和接口全被拦HTTPS 页面里请求了 HTTP 地址,属于混合内容,浏览器直接拦截搜 Console 的 Mixed Content 警告,检查请求地址协议
复制按钮在测试环境好用,部署到内网 IP 上就失效不是安全上下文,navigator.clipboard 可能整个不存在看 window.isSecureContext,并确认有没有降级方案
「加载更多」追加的图片一直不加载观察者只对初始化时存在的节点注册过,新节点没注册查渲染新节点的代码有没有调用 observe
摄像头、定位权限弹窗被用户秒拒,之后再也不弹页面一进来就申请,没有用户手势,用户也不理解用途把申请挪到用户点击「开始」之后,并先说明用途

这张表里有一半的问题不会在控制台里以「红色报错」的形式出现,只是功能静默失效。所以排查这类问题时,先确认「这个 API 在当前环境下到底存不存在、有没有被限制」,再去看业务逻辑。

这些能力的边界与代价

  • IntersectionObserver 是异步批量的,不是实时的。浏览器会把多次交叉变化合并成一批回调,所以它适合「进入视口就做某件事」,不适合「元素每移动一像素就跟着动」这种需要精确同步的场景。要跟随位置,还是得在帧里算。
  • 它也有作用域限制。被观察的元素必须在 root 的后代里,跨 iframe 或跨文档观察不可行。另外被大量元素注册时,回调里做重活一样会卡主线程。
  • fetch 不给上传进度。它能读响应流,但请求体上传过程中的进度没有标准接口。真要做上传进度条,常见做法是用 XMLHttpRequest 的 upload.onprogress,这是老 API 少数还不可替代的地方。
  • 观察者要手动收尾。页面切换、组件销毁时忘记 disconnect 或 unobserve,回调还会继续跑,引用的节点也释放不掉,长时间开着页面会越来越慢。
  • 临时地址要回收。URL.createObjectURL 创建的地址会一直占着那块数据,直到页面关闭或你调用 revokeObjectURL。预览大图时忘记回收,内存会明显上涨。
  • 权限不是一次拿到就永久有效。用户可以随时在浏览器设置里撤回,代码必须假设「下次调用可能被拒绝」,而不是只在首次申请时处理失败。

规模上也有个界限:几十张图用 scroll 监听其实感觉不出来,两百张以上、又叠加大图片时,重复计算才会变成肉眼可见的卡。判断要不要换方案,先数元素数量和看目标设备,不要一上来就上最复杂的写法。

当天就能做的四件事

  1. 用 fetch 请求一个肯定不存在的地址(比如站内一个乱写的路径),在 then 和 catch 里各打一条日志,看它走哪边、status 是多少。这个结果会纠正很多人的直觉。
  2. 发一个慢请求,用 AbortController 在一秒后取消,在 catch 里打印 err.name,确认取消长什么样。
  3. 写 200 个带 data-src 的图片占位,先用 scroll 监听实现懒加载,在 Performance 里录一段滚动;再换成 IntersectionObserver 录一段,对比脚本执行时间。
  4. 用 MutationObserver 观察一个容器,然后一次性 append 五个子节点,打印回调收到的记录条数,看看浏览器是怎么合并的。

小结与下一篇

这一篇的重点不是 API 清单,而是几个判断:fetch 要看 res.ok,取消和超时要自己用 AbortController 做;元素是否可见用 IntersectionObserver,比滚动监听便宜得多;剪贴板和文件这类能力都卡在安全上下文、用户手势和权限上,必须准备失败分支。

下一篇读浏览器存储。直接原因是这篇里的 fetch 一旦带上登录凭证,就绕不开「凭证存在哪、会不会被脚本读到、什么时候过期」,而存储那篇正好把 Cookie、localStorage、IndexedDB 的取舍讲清楚。你现在把 token 随手塞进 localStorage 的做法,读完可能会改。

如果请求被浏览器拦下、Console 里报跨域错误,别在这篇里继续找答案,直接读请求、缓存与跨域,那篇按报错文案给了排查顺序。想补事件绑定和节点查找,回看DOM 与 BOM。