jquery判断class是否存在?三种写法与性能差别
- 2026年11月13日
- 46 次
手上这个后台系统从 2016 年跑到现在,前端一直用 jQuery 打底:1.12 的老页面和 3.6 的新模块放在同一个目录里,元素状态几乎都靠 class 表达。维护的人换过三拨,jquery判断class是否存在全靠各人习惯,没人定过规矩,于是 hasClass、is('.is-active')、classList.contains 三种写法在同一张页面上并存。改一个类名之前,得先把这三种写法各自的代价弄清楚。
先回答:三种写法里哪一种该做默认
在 jQuery 3.6 和 1.12 都要跑的页面里,jquery判断class是否存在最稳的写法是 hasClass。它不解析选择器,只拿 className 做一次字符串查找,两代版本的行为一致。

写法本身没什么可挑的,返回值是布尔值,可以直接进 if。
var $item = $('.list-item');
if ($item.hasClass('is-active')) {
$item.removeClass('is-active');
}
代码块里那个 if 之所以成立,是因为删之前 $item.hasClass('is-active') 打出来是 true,删完再打就是 false。它不用再套一层 !!,返回值本身就是布尔。只认类名:写成 $item.hasClass('.is-active') 永远返回 false,因为拼出来的待查串是 " .is-active ",className 里没有那个点。
hasClass('a b') 也不会拆成两个类分别判断。入参被整体拼成 " a b ",再去补过空格的 className 里找子串,只有两个类相邻且顺序一致时才为 true。这个行为在 3.x 源码里能直接读到,不当成 bug,但传多个类名前得清楚自己要的是哪个语义。
hasClass 不走选择器,前提和边界在哪
翻 3.x 的源码,hasClass 只做三件事:取 className、把连续空白压成一个、在两侧补空格后做 indexOf。1.12 是另一套写法,用正则 rclass 替换空白,思路一样。整条路径上没有选择器解析,也不碰 Sizzle。
代价因此可以估:一次字符串拼接加一次子串查找,跟 className 的长度成正比,跟页面上有多少元素无关。前提也明确,目标必须是元素节点,文本节点上没有 className 可取。
还有一个容易忽略的点:集合里有多个元素时,hasClass 碰到第一个命中的就返回 true,是「任意一个」的语义,不是「全部」。

空集合也一样返回 false。$('.nothing').hasClass('active') 不报错,选择器没选到东西,和选到了但没有这个类,结果完全相同,排查时先确认集合长度再判断。
is() 的代价:选择器串要过一遍解析
.is('.is-active') 的结果和 hasClass 一样是布尔值,路径不同。字符串入参先过 rneedsContext 那组正则粗判,区分简单类名选择器与需要完整解析的表达式;真正执行时用 winnow 把集合里的元素逐个交给 matchesSelector(底层是原生 matches),每个元素一次匹配调用。集合越大、选择器越长,多出来的那部分越明显。把一个布尔判断交给选择器引擎,本来不需要这一步。
具体快慢我给不出可信的百分比,浏览器和选择器复杂度的影响比写法本身大,能确定的只是它比 hasClass 多了解析这一步。is() 的价值在入参:选择器、DOM 元素、jQuery 对象、过滤函数都收,hasClass 只收类名字符串。
var $rows = $('.row');
var isActive = $rows.is('.row-active');
// 也可以直接传 DOM 节点或 jQuery 对象
var same = $rows.is($rows.eq(0));
选择器写错时它抛异常,不返回 false。$rows.is('.row..active') 在控制台报的是 Uncaught Error: Syntax error, unrecognized expression: .row..active,异常从 Sizzle 里抛出,同一段脚本后面的代码不会执行。这是选择器解析阶段的语法错误;hasClass 传错参数则安静返回 false,两者在排查时完全不是一回事。
classList 与 toggleClass 的返回值别混着用
不用 jQuery 的话,el.classList.contains('is-active') 是最短的一层。classList 是 DOMTokenList,contains 直接查 token,返回布尔值。IE10 起才有,还要兼容 IE9 的后台不能把它当默认。直接读 className 自己 split 也能判断,只是多一层手写解析,还容易在连续空白上出错,这里只比 classList.contains。
它比 hasClass 严格。el.classList.contains('a b') 直接抛 Uncaught DOMException: Failed to execute 'contains' on 'DOMTokenList': The token provided ('a b') contains HTML space characters, which are not valid in tokens.,不做子串匹配。
var el = document.querySelector('.list-item');
if (el && el.classList.contains('is-active')) {
el.classList.remove('is-active');
}
// toggleClass 返回 jQuery 对象,不是布尔值
var ret = $('.list-item').toggleClass('is-active');
console.log(ret.length, typeof ret);
// 1 "object"
toggleClass 是最容易用错的一个:返回的是 jQuery 对象本身,拿它进 if 永远为真,不管这个类是刚加上还是刚被删掉。要靠切换结果分支,先 contains 再 toggle,或者切换完重新查一次。
返回值上,hasClass、is()、classList.contains 都是布尔值,只有 toggleClass 不是。
同一组维度比一遍:前提、代价、适用场景
前提这一维,hasClass 要元素节点加类名字符串,1.12 和 3.6 都能用;is() 入参最宽,能收的东西多,出错的方式也多;classList 要求浏览器支持 DOMTokenList,一次只能查一个类名。

代价这一维,hasClass 是一次字符串 indexOf,is() 多一道选择器解析,classList 是一次 token 查找且不经过 jQuery 包装。三个在同一量级,差别在循环里成百上千次调用时才显出来——jquery判断class是否存在要压性能,先看调用次数,再挑写法。
场景分开看,三种写法都能给出答案,只是代价不同:模板里判断状态、加删类,用 hasClass;已经拿到原生节点、又不需要 jQuery 的地方,用 classList.contains;选择器本身带层级或伪类,比如 li:first-child,或者要把 DOM 节点当条件传进去,才轮到 is()。
按前提、代价、适用场景三个维度看,jquery判断class是否存在没有唯一答案,只有默认项:默认 hasClass,另外两种按上面的边界用。要加注释的话,把默认项写进团队约定比写进代码更管用,新来的人至少知道该抄哪一种。
回头看当时选错的那一步
开头那三种写法并存,根源不是谁写错了,是默认项没定。列表渲染那一段,这个判断我写成了 is('.is-active'),理由是以后要换选择器时不用改调用处。问题出在每一行都要走一次选择器匹配,滚动加载时这段代码被调用的次数远超预期。
如果重来,我会先把判断收成一个函数,内部用 hasClass,调用处只传类名;真要按复杂选择器筛,再单独开一个走 is() 的入口。代价是当时多写一层包装,后来花时间把散在页面里的 is 调用逐个换掉,换的时候还得逐处确认传进去的确实是类名,不是别的选择器。
三种写法都得到同一个布尔值,区别在谁把字符串交给选择器去解析。这一步交给谁,决定了出错时你看到的是 false,还是一行异常。
若非作者标注皆为李涛自留地原创文章,转载或复制请以超链接形式并注明出处。
- jquery向左滑出,animate改left更稳 2026-11-09
- sitemap提交步骤怎么走?从生成到收录的四步顺序 2026-11-22
- 私人网站有什么用?私人网站还在还能赚钱么? 2022-09-02
- emoji表情怎么输入手机?安卓与iPhone各三种方式 2026-11-14
- 搞不清php session默认过期时间,回收机制踩坑记 2026-11-09
- 网站打开慢是什么原因造成的?按耗时查5个环节 2026-11-12
