投屏键无法用JS拦截,因其属浏览器原生UI,不触发任何DOM事件;controlslist不支持nocast属性;唯一可控点是禁用页面主动集成的Cast SDK;系统级投屏(如AirPlay、Miracast)前端完全不可控。

投屏键根本没法用 JS 拦截
HTML 页面里没有任何 API 能监听或阻止“投屏”这个动作。Chrome/Firefox/Edge 的投屏按钮(Cast)是浏览器原生 UI 的一部分,不触发任何 DOM 事件,contextmenu、keydown、beforeunload 全都收不到信号。你写的 document.addEventListener('keydown', e => { if (e.code === 'MediaPlayPause') ... }) 对它完全无效——那只是媒体键,不是投屏键。
controlslist="noplaybackrate nofullscreen nodownload" 不含投屏控制
这个属性只影响视频控件栏的按钮显示,controlslist 标准里压根没有 nocast 或类似字段。即使你写成 controlslist="noplaybackrate nofullscreen nodownload nocast",浏览器会直接忽略 nocast,投屏按钮照常出现。实测 Chrome 129+、Edge 130+ 均不识别该值。
唯一可干预的点:禁掉 chrome.cast 初始化
如果页面自己集成了 Google Cast SDK(比如调用了 chrome.cast.initialize()),你可以选择不调用它,或在初始化前加条件判断:
- 不引入
https://www.gstatic.com/cv/js/sender/v1/cast_sender.js - 若已加载,检查
window.chrome?.cast是否存在,存在也不调initialize - 避免在页面中硬编码
data-cast-api-enabled="true"或cast-button自定义元素
注意:这仅防止页面主动发起投屏,不影响用户手动点击浏览器右上角的 Cast 图标——那个永远绕不过去。
立即学习“前端免费学习笔记(深入)”;
移动端和系统级投屏完全不可控
iOS 屏幕镜像(AirPlay)、Android 无线显示(Wireless Display)、Windows 10/11 的“连接到无线显示器”,全由操作系统接管,网页 JS 零权限感知或干预。你在 video 标签上加 oncanplaythrough 或监听 webkitpresentationmodechanged 也拿不到任何投屏状态变更通知。所谓“检测投屏中并暂停播放”,目前无可靠实现路径。
真正能起作用的只有服务端策略:对投屏场景做 UA + IP + 设备指纹组合识别,返回低码率流或带水印帧;前端所有操作,只是给普通用户增加一点操作成本而已。



















