见过一个挺典型的线上问题:订单提交接口返回 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 选项,让请求在页面卸载后继续完成;它有体积限制,只适合小数据量的埋点,不适合传大文件。
现象对照: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 监听其实感觉不出来,两百张以上、又叠加大图片时,重复计算才会变成肉眼可见的卡。判断要不要换方案,先数元素数量和看目标设备,不要一上来就上最复杂的写法。
当天就能做的四件事
- 用
fetch请求一个肯定不存在的地址(比如站内一个乱写的路径),在then和catch里各打一条日志,看它走哪边、status是多少。这个结果会纠正很多人的直觉。 - 发一个慢请求,用
AbortController在一秒后取消,在catch里打印err.name,确认取消长什么样。 - 写 200 个带
data-src的图片占位,先用 scroll 监听实现懒加载,在 Performance 里录一段滚动;再换成 IntersectionObserver 录一段,对比脚本执行时间。 - 用
MutationObserver观察一个容器,然后一次性append五个子节点,打印回调收到的记录条数,看看浏览器是怎么合并的。
小结与下一篇
这一篇的重点不是 API 清单,而是几个判断:fetch 要看 res.ok,取消和超时要自己用 AbortController 做;元素是否可见用 IntersectionObserver,比滚动监听便宜得多;剪贴板和文件这类能力都卡在安全上下文、用户手势和权限上,必须准备失败分支。
下一篇读浏览器存储。直接原因是这篇里的 fetch 一旦带上登录凭证,就绕不开「凭证存在哪、会不会被脚本读到、什么时候过期」,而存储那篇正好把 Cookie、localStorage、IndexedDB 的取舍讲清楚。你现在把 token 随手塞进 localStorage 的做法,读完可能会改。
如果请求被浏览器拦下、Console 里报跨域错误,别在这篇里继续找答案,直接读请求、缓存与跨域,那篇按报错文案给了排查顺序。想补事件绑定和节点查找,回看DOM 与 BOM。