iOS UI测试：无法访问文本框内的显示/隐藏切换按钮问题

我来帮你搞定这个痛点！当显示/隐藏按钮嵌在文本框内部时，XCTest的录制功能确实会把点击按钮识别成点击文本框本身，但咱们有几个靠谱的办法来解决这个问题，确保测试能准确验证文本可见性的切换。

方法1：通过相对坐标精准点击按钮 #

如果暂时没法修改App代码，我们可以利用文本框的位置计算按钮的相对坐标来点击。比如这类切换按钮通常在文本框的右侧居中位置，代码可以这么写：

let app = XCUIApplication()
let passwordTextField = app.textFields["yourTextFieldIdentifier"]

// 计算按钮的相对坐标：dx=0.9代表从文本框左侧90%的位置，dy=0.5是垂直居中
let toggleButtonCoordinate = passwordTextField.coordinate(withNormalizedOffset: CGVector(dx: 0.9, dy: 0.5))
toggleButtonCoordinate.tap()

// 验证文本可见性状态变化
XCTAssertEqual(passwordTextField.isSecureTextEntry, false, "点击切换按钮后文本应该变为可见")

这种方式的好处是不用修改App代码，但要注意：如果按钮的位置在不同设备或布局下有变化，可能需要调整偏移量，稳定性不如下面的方法。

方法2：给按钮添加辅助功能标识（最推荐） #

这是最可靠的解决方案，还能顺便提升App的无障碍体验。你需要在App的业务代码里给内嵌的切换按钮设置唯一的辅助功能标识：

在UIKit中设置： #

// 假设这是你的切换按钮
let visibilityToggleButton = UIButton(type: .custom)
visibilityToggleButton.accessibilityIdentifier = "textVisibilityToggle"
visibilityToggleButton.accessibilityLabel = "显示/隐藏文本内容"
// 将按钮添加到文本框的子视图中...

在SwiftUI中设置： #

Button(action: { /* 切换逻辑 */ }) {
    Image(systemName: "eye")
}
.accessibilityIdentifier("textVisibilityToggle")
.accessibilityLabel("显示/隐藏文本内容")

之后在测试代码里就能直接定位到这个按钮，不用依赖坐标：

let app = XCUIApplication()
let toggleButton = app.buttons["textVisibilityToggle"]
toggleButton.tap()

// 验证文本框的安全输入状态（以密码框为例）
let targetTextField = app.textFields["yourTextFieldIdentifier"]
XCTAssertFalse(targetTextField.isSecureTextEntry, "文本框应处于非安全输入状态，文本可见")

这个方法的优势在于稳定性极高，不管布局怎么调整，只要辅助标识不变，测试就能正常运行，同时也符合Apple的无障碍设计规范。

方法3：间接验证状态变化（应急方案） #

如果以上两种方法都暂时没法实施，你还可以通过两次点击文本框（假设点击文本框的右侧区域会触发按钮），然后对比文本框的isSecureTextEntry状态变化来验证：

let app = XCUIApplication()
let textField = app.textFields["yourTextFieldIdentifier"]
let initialSecureState = textField.isSecureTextEntry

// 点击文本框的右侧区域
textField.tap(at: CGVector(dx: 0.9, dy: 0.5))

// 验证状态发生了变化
XCTAssertNotEqual(textField.isSecureTextEntry, initialSecureState, "文本可见性状态应已切换")

不过这种方式的稳定性最差，只适合临时应急使用。

内容的提问来源于stack exchange，提问作者Deepak Terse