You need to enable JavaScript to run this app. React实现JS媒体查询时报isMobile.addListener不存在错误
优惠活动
大模型
产品
解决方案
定价
更多

React实现JS媒体查询时报isMobile.addListener不存在错误

代码问题拆解
  • 直接触发报错的核心原因是变量取值错了
    你写的const isMobile = window.matchMedia("only screen and (max-width: 830px)").matches这行,直接把matchMedia返回对象上的.matches布尔值存到了isMobile里。布尔值本身根本没有addListener方法,后面调用的时候自然就抛出类型错误了。真正带事件监听方法的,是window.matchMedia返回的MediaQueryList对象本身,不是它的matches属性值。
  • 事件回调里的判断逻辑写错了
    你写的setOrientation里判断e.isMobile,但媒体查询事件触发时,回调拿到的事件对象只有matches字段,没有isMobile这个属性,就算前面把对象取对了,这里的判断永远不会成立。
  • 事件绑定和清理的API对不上
    你绑事件用的是老式的addListener,清理的时候却写了removeEventListener,两个属于不同版本的媒体查询接口,混着用要么清不掉事件,要么直接在不兼容的浏览器里报错。
  • 空依赖的effect存在闭包问题
    你把媒体查询实例、回调函数都写在组件普通作用域,每次组件渲染都会重新生成新的引用,但空依赖的useEffect只会拿第一次渲染时的旧引用,后续页面状态变了,effect里的逻辑根本拿不到最新的值。
修正方向
  • 单独把MediaQueryList实例存成变量,比如const mobileMediaQuery = window.matchMedia("only screen and (max-width: 830px)"),需要判断当前视口是否符合阈值的时候,再读mobileMediaQuery.matches就行,不要直接把matches值当事件源用。
  • 改事件回调里的判断逻辑,直接读入参的e.matches判断是不是命中了移动端宽度条件。
  • 绑事件和清事件的API保持一致,兼容老旧内核:优先用标准的addEventListener绑事件,不支持的环境就降级用addListener,清理的时候对应用同版本的移除方法。
  • 把媒体查询实例、事件回调用useMemo/useCallback固定引用,避免每次渲染生成新值导致effect逻辑失效。

内容的提问来源于stack exchange,提问作者whoMe

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.04 11:45:07