在自动化测试中，验证页面是否显示特定文本时，应优先使用 `gettext()` 方法获取并比对实际文本内容，而非依赖 `isdisplayed()` 判断元素可见性——因为后者无法保证文本存在或匹配预期值。
在 Selenium 自动化测试实践中，文本验证（Text Verification）与可见性验证（Visibility Verification）是两个不同层级的断言目标，需选用对应的方法以确保测试的准确性和健壮性。
✅ 正确做法：用 getText() 进行文本断言
WebElement.getText() 会返回元素渲染后的可见文本内容（等效于浏览器的 innerText 或 textContent，取决于驱动实现），它自动忽略隐藏文本、CSS 隐藏元素、空白符折叠等干扰因素，是验证用户实际看到内容的黄金标准。
示例代码（推荐）：
public String getInfo() {
By infoCell = By.xpath("//h5[text()='The info is:']/following-sibling::td");
return findElementBy(infoCell).getText().trim();
}
// 测试用例中直接比对文本
Assert.assertEquals("hello", foo.getInfo());✅ 优势：
- 精确匹配用户可见文本；
- 自动处理换行、空格归一化（如 getText() 返回 "hello" 而非 " \nhello\n "）；
- 失败时提供清晰的差异信息（如 "expected: <hello> but was: <Hello>）；
- 符合“测试行为而非实现”的原则——关注“显示了什么”，而非“是否渲染了某个 DOM 节点”。
⚠️ isDisplayed() 的适用场景与局限
isDisplayed() 仅用于判断元素是否在视口内、未被 CSS 隐藏（display:none/visibility:hidden/opacity:0 等）且尺寸不为零。它不检查文本内容是否存在、是否为空、是否匹配预期。
详细的 Three.js 3D 图形参考，涵盖场景设置、相机、几何体、材质、光照、动画、控制器、加载器、数学工具和调试。
反例（不推荐用于文本验证）：
public boolean isInformationFound(String info) {
By locator = By.xpath("//h5[text()='The info is:']/following::td[text()[contains(.,'" + info + "')]]");
return findElementBy(locator).isDisplayed(); // ❌ 危险！XPath 已硬编码文本匹配，但 isDisplayed() 并不校验 info 是否真实出现在结果中
}⚠️ 风险点：
- XPath 中 text()[contains(.,'hello')] 属于 DOM 层级匹配，可能匹配到不可见文本（如被 aria-hidden="true" 包裹）、注释节点或动态加载前的占位符；
- 若页面结构变更导致该 <td> 元素仍存在但文本被 JS 清空，isDisplayed() 仍返回 true，造成假阳性；
- 无法区分 "hello"、"HELLO"、"hello world" 等语义差异。
? 补充建议：增强健壮性的最佳实践
分离定位与断言逻辑：
定位器应聚焦于稳定结构（如 id、data-testid、语义化标签），避免在 XPath 中嵌入待验证文本（易脆）。文本比对应在 getText() 后由断言层完成。-
处理异步加载：
使用显式等待确保元素可见且文本非空：WebDriverWait wait = new WebDriverWait(driver, Duration.ofSeconds(10)); WebElement cell = wait.until(ExpectedConditions.visibilityOfElementLocated( By.xpath("//h5[text()='The info is:']/following-sibling::td") )); Assert.assertTrue(cell.getText().trim().contains("hello")); 空值与异常防护：
getText() 在元素不存在时抛出 NoSuchElementException，建议配合 findElements() 或 try-catch 做兜底，避免测试意外中断。
总之，isDisplayed() 是 UI 可见性守门员，getText() 才是文本真实性裁判。根据测试意图选择方法：验证“能否看见”用前者，验证“看见了什么”必须用后者。
