contains()是XPath中用于判断字符串是否包含指定子串的函数,返回布尔值,不区分大小写、不支持正则,常用于模糊定位元素,基本格式为contains(字符串,子串)。

contains() 是 XPath 中最常用的字符串匹配函数之一,用来判断某个字符串是否**包含**指定的子串,返回布尔值(true 或 false)。它不区分大小写,也不支持正则,但简单直接,特别适合模糊定位元素。
基本语法和用法
函数格式是:contains(字符串, 子串)。两个参数都必须是字符串类型,通常第一个参数用节点的文本内容(如 text())或属性值(如 @class),第二个参数是你要查找的关键词。
- ✅ 正确写法:
contains(text(), '提交')—— 匹配文本中含“提交”的元素 - ✅ 常见组合:
contains(@class, 'btn-primary')—— 匹配 class 属性包含 "btn-primary" 的元素 - ⚠️ 注意:如果 text() 返回多个文本节点,
contains(text(), ...)可能行为不稳定,建议用contains(string(.), ...)更稳妥
实际定位场景举例
假设网页中有这样一段 HTML:
- 找按钮:“提交”在文本里 →
//button[contains(text(), '提交')] - 找 div:“已成功提交”含“提交” →
//div[contains(text(), '提交')] - 按 class 模糊匹配 →
//*[@class and contains(@class, 'btn')](匹配所有 class 含 “btn” 的元素)
常见坑和注意事项
- ❌
contains()不支持通配符或正则,比如contains(text(), '提*交')会报错 - ❌ 参数不能为节点集(除非自动转为字符串),像
contains(div, 'abc')是错的;应写成contains(div/text(), 'abc')或contains(div, 'abc')(此时 div 被隐式转为字符串) - ✅ 多关键词组合?用
and连接://a[contains(@href, 'user') and contains(text(), '编辑')] - ✅ 忽略大小写?XPath 1.0 本身不支持,可配合 translate() 函数模拟,但更推荐在支持 XPath 2.0+ 的环境(如 Selenium 4+)中用
matches()
基本上就这些。掌握 contains() 就能解决 80% 的动态/不完整文本匹配需求,不复杂但容易忽略细节。










