关键在于理解新兴Web API的生命周期、权限模型和降级路径;需检查权限状态、确保安全上下文与用户手势触发、验证设备就绪,并查阅caniuse.com的注意事项。

JavaScript 与新兴 Web API 交互,关键不在于“会不会调用”,而在于“是否理解其生命周期、权限模型和降级路径”。多数失败不是因为语法写错,而是忽略了浏览器对新 API 的渐进式支持策略。
Web API 权限拒绝(如 navigator.permissions.query 返回 "denied")怎么办
很多新 API(如 Notifications、Clipboard、Wake Lock)在首次使用前需显式请求权限,且用户一旦点击“拒绝”,后续 request() 调用会直接 resolve 为 "denied",不再弹窗。
- 先用
navigator.permissions.query({ name: "clipboard-read" })检查当前状态,而非直接调用navigator.clipboard.readText() -
"prompt"状态才适合调用.request();"granted"可直用;"denied"需引导用户手动到设置页开启 - 注意:Chrome 对
clipboard-read要求上下文必须是用户手势触发(如click),否则抛"NotAllowedError"
调用 MediaDevices.getDisplayMedia() 时黑屏或报错
该 API 用于录屏/共享窗口,但行为高度依赖浏览器版本、安全上下文(必须 HTTPS 或 localhost)和用户选择粒度。
- 必须在用户手势(
click、keydown)中调用,否则 Chrome 直接拒绝并抛"NotAllowedError" - 传入的
video: true是必需的;若只设audio: true,Firefox 不支持,Safari 完全不支持 - 用户选择“整个屏幕”后,某些 Windows 系统可能因 GPU 驱动问题返回黑帧——此时应监听
track.onmute并提示重试 - 不要假设
getDisplayMedia()返回的流一定含视频轨道:stream.getVideoTracks()[0]可能为undefined
使用 WebUSB 连接设备时 navigator.usb.requestDevice() 不弹窗
WebUSB 是高权限 API,仅在安全上下文 + 用户手势 + 明确设备过滤器下才激活弹窗。
AJAX即“Asynchronous Javascript And XML”(异步JavaScript和XML),是指一种创建交互式网页应用的网页开发技术。它不是新的编程语言,而是一种使用现有标准的新方法,最大的优点是在不重新加载整个页面的情况下,可以与服务器交换数据并更新部分网页内容,不需要任何浏览器插件,但需要用户允许JavaScript在浏览器上执行。《php中级教程之ajax技术》带你快速
立即学习“Java免费学习笔记(深入)”;
- 必须通过 HTTPS(
localhost除外),HTTP 页面中navigator.usb为undefined -
requestDevice({ filters: [{ vendorId: 0x1234 }] })中的vendorId必须是十六进制整数,不能是字符串"0x1234",否则静默失败 - Chrome 119+ 要求页面至少被用户聚焦过一次(即非后台标签页),否则拒绝请求
- 设备需已接入且未被其他进程独占(如串口调试工具占着 COM3,
requestDevice就会卡住无响应)
真正棘手的不是调用语法,而是每个新兴 API 都自带一套隐式契约:安全上下文、用户意图、设备就绪、权限历史。漏掉其中任一环,控制台可能只报一个模糊的 "SecurityError" 或干脆静默失败。动手前,先查 caniuse.com 对应 API 的“Notes”栏——那里写的往往比 MDN 示例更贴近真实部署场景。










