將 enterText 方法修改為將游標移至輸入文字結尾

WidgetTester.enterText 與 TestTextInput.enterText 方法 現在會將游標移至輸入文字的結尾。

游標（caret）用來指示目前在作用中輸入欄位（input field）中的插入點。一般來說，當輸入新字元時，游標會停留在新字元之後。在 Flutter 中，游標位置是以收合的選取範圍（collapsed selection）來表示。當選取範圍無效時，通常使用者將無法修改或新增文字，直到他們將選取範圍更改為有效值。

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 測試失敗：

  游標會出現在文字結尾，而不是變更前出現在文字前方。

• 呼叫 enterText 後的 TextEditingValue.selection 不同：

  文字欄位的 TextEditingValue 現在會有一個 非負偏移量（offset）的收合選取範圍，而不是 變更前的 TextSelection.collapsed(offset: -1)。 例如，您可能會看到 expect(controller.value.selection.baseOffset, -1); 在呼叫 enterText 後失敗。

如果您的測試確實需要將選取範圍設為無效， 可以使用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

相關議題：

• Issue 79494

相關 PR：

• enterText 將游標移至結尾