XCTest写入多行TextField报错：元素无键盘焦点，如何解决？

我的代码中，TextField被XCTest框架识别为.textView元素类型，执行写入操作时出现以下错误：

Failed to synthesize event: Neither element nor any descendant has keyboard focus. Event dispatch snapshot: TextView, {{0.0, 430.0}, {414.0, 46.0}}, identifier: 'MyTextView', placeholderValue: 'stackOverflow', value: stackOverflow

想请教两个问题：

1. 能否实现点击并写入多行TextField？
2. 是否必须将其替换为TextEditor？

补充说明：当把TextField配置为单行（移除axis和lineLimit参数）时，框架会将其识别为.textField，此时写入操作可正常执行。

iOS应用代码 #

struct TestTextView: View {
        @State private var text = ""
        
        var body: some View {
            VStack {
                TextField("<input>", text: $text, axis: .vertical)
                    .lineLimit(2, reservesSpace: true)
                    .border(Color.black)
                    .accessibilityIdentifier("MyTextView")
            }
        }
} // TestTextView()

XCTest代码 #

func testTextView() throws {
        let app = XCUIApplication()
        app.launch()
        
        let accessId = "MyTextView"
        let field = app.textViews[accessId]
        XCTAssertTrue(field.exists, "TextField '\(accessId)' does not exist|debug = \(app.debugDescription)")

        field.tap()
        field.typeText("Hello")
}

修复方案 #

方案1：优化XCTest交互逻辑适配多行TextField #

当TextField开启垂直轴（axis: .vertical）后，底层复用UITextView实现，XCTest识别为textViews是正确的，但直接tap()可能无法稳定获取焦点，可尝试以下调整：

• 在tap()后添加键盘等待逻辑，确保焦点就绪：

  field.tap()
  // 等待键盘加载完成，超时时间可按需调整
  let keyboard = XCUIApplication().keyboards.element
  XCTAssertTrue(keyboard.waitForExistence(timeout: 2))
  field.typeText("Hello")
  

• 若单次点击无效，改用doubleTap()强制触发焦点：

  field.doubleTap()
  field.typeText("Hello")
  

方案2：替换为TextEditor（更稳定的多行文本测试方案） #

如果上述方法仍无法解决问题，建议直接使用TextEditor替代多行TextField——TextEditor本身为多行文本设计，XCTest对其支持更成熟：
修改iOS应用代码：

struct TestTextView: View {
        @State private var text = ""
        
        var body: some View {
            VStack {
                TextEditor(text: $text)
                    .frame(height: 46) // 匹配原TextField高度
                    .border(Color.black)
                    .accessibilityIdentifier("MyTextView")
                    // 如需占位符可自定义实现，比如叠加半透明文本
                    .overlay(
                        text.isEmpty ? Text("<input>").opacity(0.5) : nil,
                        alignment: .topLeading
                    )
            }
        }
}

XCTest代码无需修改，依然可以通过app.textViews[accessId]定位并操作。

问题根源说明 #

SwiftUI的TextField(axis: .vertical)是iOS 16+推出的功能，底层是UITextField与UITextView的混合封装，XCTest的事件合成逻辑对这类混合元素的焦点识别存在延迟，导致typeText执行时焦点未就绪。

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