New Actions: tapBackspaceKey and tapReturnKey

[michaelgmcd]

• This change has been discussed in issue Support for pressing Delete key on Android #1039 and the solution has been agreed upon with maintainers.

---

This PR adds support for pressing the backspace and return keys on both iOS and Android. Although iOS support exists by using typeText and the \b and \n keys, this was unclear and not cross-platform. The pressBackspaceKey and pressReturnKey methods abstract these features for both platforms.

Note: I did try adding a numberOfTimes parameter as a shortcut for pressing the backspace or return key multiple times, however I wasn't able to figure out the simplest way for executing multiple actions:

For both Android and iOS, the addition numberOfTimes for pressReturnKey is pretty straightforward:

async pressReturnKey(numberOfTimes = 1) {
  if (numberOfTimes && typeof numberOfTimes !== 'number') { throw new Error('...') }
  return await new ActionInteraction(this, new TypeTextAction('\n'.repeat(numberOfTimes))).execute();
}

For pressBackspaceKey on iOS, it can be implemented the same way as return, replacing \n with \b. For Android, however, I'm not sure how to invoke multiple PressKeyActions. Either way, I think this can be added in a follow up PR if it's determined to be useful.

cc @LeoNatan

[LeoNatan]

Fantastic, thank you!
Would I trouble you much if I ask to name them tap...? It was my fault with the press in the issue, but on iOS that has different meanings. Tapping is the agreed upon terminology for iOS and Android.

[michaelgmcd]

Done @LeoNatan.

[LeoNatan]

Looks good to me. Let's wait for @rotemmiz review as well.

[michaelgmcd]

@rotemmiz Any idea when you'll be able to get to this? It's a blocker for my team moving to Detox (which we'd love to do asap)

[rotemmiz]

Looks great! Let's just add a few lines of documentation in https://github.com/wix/Detox/blob/master/docs/APIRef.ActionsOnElement.md

[rotemmiz]

Amaze!

[LeoNatan]

👍

[michaelgmcd]

@rotemmiz @LeoNatan Are we good to go?

[rotemmiz]

Thank you!

[michaelgmcd]

Any timeframe on when this will be released?

[rotemmiz]

After a few inconsistencies with lerna 3, and some faulty release, you can now find your changes in
detox@9.1.2