将 enterText 方法更改为将光标移动到输入文本的末尾

WidgetTester.enterText 和 TestTextInput.enterText 方法现在将光标移动到输入文本的末尾。

光标表示活动输入字段中当前文本的插入点。通常，当输入新字符时，光标会紧随其后。在 Flutter 中，光标位置由折叠的选区表示。当选区无效时，用户通常无法修改或添加文本，直到他们将选区更改为有效值。

WidgetTester.enterText 和 TestTextInput.enterText 是测试中用于替换目标文本字段内容的两个方法。在此更改之前，WidgetTester.enterText 和 TestTextInput.enterText 将选区设置为无效范围 (-1, -1)，表示没有选区或光标。这与输入字段的典型行为相矛盾。

除了用提供的文本替换文本之外，WidgetTester.enterText 和 TestTextInput.enterText 现在将选区设置为 TextSelection.collapsed(offset: text.length)，而不是 TextSelection.collapsed(offset: -1)。

测试应该很少需要依赖 enterText 之前的行为，因为通常选区不应该无效。考虑更改测试的预期值以适应 enterText 的更改。

此更改可能导致的常见测试失败包括：

• 黄金测试（Golden test）失败

  光标出现在文本末尾，而不是更改之前的文本前面。

• 调用 enterText 后 TextEditingValue.selection 不同

  文本字段的 TextEditingValue 现在具有一个非负偏移量的折叠选区，而不是更改之前的 TextSelection.collapsed(offset: -1)。例如，您可能会看到在调用 enterText 后 expect(controller.value.selection.baseOffset, -1); 失败。

如果您的测试必须依赖将选区设置为无效，则可以使用 updateEditingValue 实现之前的行为。

迁移前的代码

await testTextInput.enterText(text);

迁移后的代码

await testTextInput.updateEditingValue(TextEditingValue(
  text: text,
));

迁移前的代码

await tester.enterText(finder, text);

迁移后的代码

await tester.showKeyboard(finder);
await tester.updateEditingValue(TextEditingValue(
  text: text,
));
await tester.idle();

发布版本：2.1.0-13.0.pre
稳定版本：2.5

API 文档

• WidgetTester.enterText
• TestTextInput.enterText

相关问题

• 问题 79494

相关 PR

• enterText 将光标移动到末尾