17370845950

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% 的动态/不完整文本匹配需求，不复杂但容易忽略细节。