Skip to main content

Type text via key events (key.send_text)

Declaration

key.send_text(text [, per_key_delay_ms, shift_delay_ms])

Parameters

  • text
    String. Text to type. Only English letters, digits, space, half-width symbols, and escape sequences "\b", "\r", "\t" are supported.
  • per_key_delay_ms
    Integer. Delay between key events in milliseconds. Default: no delay (types as fast as device allows).
  • shift_delay_ms
    Integer. In milliseconds. Some characters require holding Shift (e.g. @ is Shift + 2). This sets extra delay for Shift.

Notes

This function is useful when sys.input_text is ineffective; it forces text input by simulating key events.

Examples

key.send_text("AbC12#") -- type as fast as possible
--
key.send_text("AbC12#", 300) -- 300ms delay between each key