contains()是XPath中用于模糊匹配子串的函数,语法为contains(string,substring),常用于匹配包含指定文本或属性值的节点,支持结合标签名、层级等提升定位准确性。

contains() 是 XPath 中最常用的模糊匹配函数,用来判断某个字符串是否包含指定的子串,常用于定位文本内容不固定、但部分特征已知的节点。
contains() 基本语法和用法
函数签名:contains(string, substring),返回布尔值(true 或 false)。常用在 [@attribute] 或 [text()] 的谓词中。
- 第一个参数是待搜索的字符串,通常是属性值(如
@class)或文本内容(如text()) - 第二个参数是要查找的子串,必须是字符串字面量(加引号)或另一个返回字符串的表达式
- 大小写敏感 ——
contains(@id, 'btn')不会匹配id="BtnSubmit"
匹配包含特定文本的元素
比如找所有文字中含“登录”的按钮:
//button[contains(text(), '登录')]
注意:text() 只匹配直接子文本节点,如果按钮里有 或换行,可能匹配不到。更稳妥的方式是用 . 表示整个节点的合并文本:
//button[contains(., '登录')]
匹配包含特定属性值的元素
常见于 class 名动态、有多个类名的情况:
//div[contains(@class, 'header')]
这能匹配 class="top-header nav" 或 class="header-active" 等含 header 的情况。
- 避免写成
@class = 'header'(完全相等),那只能匹配单个且精确的 class - 多个条件可叠加:
//input[contains(@type,'text') and contains(@name,'user')]
组合使用提升准确性
单独用 contains() 容易误匹配,建议结合标签名、层级或其它属性缩小范围:
//ul[@id='nav']/li/a[contains(@href, '/product')]
上面例子先限定是 id 为 nav 的 ul 下的链接,再筛选 href 含 /product 的 a 标签,比单纯 //a[contains(@href,'product')] 更可靠。
也支持嵌套函数,比如忽略大小写(需 XPath 2.0+):contains(lower-case(@alt), 'logo');若用 Selenium(1.x)或老版本解析器,得靠程序层处理。
基本上就这些 —— 掌握 contains(., 'xxx') 和 contains(@attr, 'xxx') 这两种主干写法,再配合路径约束,就能覆盖绝大多数模糊定位场景。










