Instead of having to manually send text editing events yourself, you can now simply enter text into a text view using enter(text:) on any UITextView.
For example, given you have some UIViewController that looks like this:
class ControllerUnderTest: UIViewController {
@IBOutlet weak var textView: UITextView?
// rest of code here
// ...
}When you want to enter some text into the controller's textView, simply do the following:
let controller = getControllerUnderTest() as? ControllerUnderTest
try! controller.textView?.enter(text: "text")
// Any delegate attached to the text view will automatically receive all
// events that you would expect to receive had a real user interacted
// with the text view. This includes:
//
// - the call to make the text view a first responder
// - should begin/did begin editing events
// - all the text change callbacks exactly as they would be received were a user to actually
// input the text themselves
// - appropriate focus handoff callbacks in the case that another element had focus
// - should end/did end editing events
// - and of course, the text in the text view will update appropriately
//You can also get more granular control with the startEditing(), endEditing(), type(text:), paste(text:), and backspace() methods.
try! textView.startEditing()
// Sends should begin and did begin events to the delegate.try! textView.endEditing()
// Sends should end and did end events to the delegate if textView previously
// had startEditing() called on it.try! textView.type(text: "text")
try! textView.paste(text: "text")
// Sends the appropriate editing changed methods to the delegate. The
// difference between the two is that type(text:) triggers the
// textView:shouldChangeTextInRange:replacementText: method for
// each character in the given string, while paste(text:) triggers it for the
// entire given string.try! textView.backspace()
// Sends the appropriate methods to the delegate while removing the last character of content
// from the text view.All the methods throw Fleet.TextViewError errors that communicate errors that occur when attempting to perform
the various operations. For example, the UITextView.type(text:) method will throw an error when it is called
on a text view that does not have first responder focus.