Creating a new test case

Besides providing you with several recommended test cases after crawling your app, Mesmer also lets you create custom test cases to manually operate and test your app for correctness.

To create a new test, click the Test Cases menu and then click Create a New Test.

Next, the New Test Case screen appears. This is where most of the work is done in building and completing your test case. Here, you'll simulate the flow and gestures needed to complete your test case as if you were doing it with a real mobile device.

Let's now get started setting up.

β€‹πŸ›  Basic setup

Before you start working on your new test case, you'll need to set it up first. Setup is so simple it involves doing these things:

  1. β€‹πŸ“± Choosing what type of device you'll be simulating for.

  2. β€‹βš™ Configuring optional device settings.

  3. β€‹βœ¨ Adding bells and whistles like tagging to help you better recall and organize your test case later on.

β€‹πŸ“± Selecting a test device

The first step is to choose the device where your app will simulate. Click or select one from the list and then click Next.

β€‹πŸ‘©πŸ«Note: The devices listed are those that support the type of application you've uploaded when you first created the project. For iOS apps, only Apple devices are listed, while Android-supported devices appear for Android apps.

β€‹βš™ Optional device configuration

β€‹πŸ‘©πŸ«Note: The Language and GPS Location configuration are optional. It's completely okπŸ‘Œ to skip this step and use the default settings of the device you've selected. Just click Next to accept the defaults and to go straight to tagging your test case.

To change the language for the device, click Language and select one from the list. Then, click Apply to save your selection.

Selecting a language from the Language list

β€‹πŸ’‘Tip: Only one language is to be selected. Later on, if you decide not to choose a language, you can remove it by clicking on it again. Clicking back and forth on the language you've selected toggles between selecting and deselecting it.

To set the device's GPS location, click GPS Location and specify your desired coordinates in the provided field. The suggested format is to enter the latitude first and then longitude second, separated by a comma. For example, to set the location to Sapporo, Hokkaido, Japan, you enter this: 43.066666, 141.350006.

Click Apply to save your setting. Then, on the Configure Device screen, click Next to start tagging your test case.

Saving your settings in the Configure Device form

β€‹πŸ”– Tagging

You can optionally tag your new test case before Mesmer prepares the device for testing. Enter the tag or tags for your test case in the provided field and press the Enter/Return key or the , (comma) key to save them. Autocomplete also appears if you have already had tags saved from previously created test cases. To remove a saved tag, you can hover over it and click itsβœ–icon.

Adding tags in the Tags form

β€‹πŸ‘©πŸ«Note: Duplicate tags are not allowed, and Mesmer notifies you if you enter the same tag you already provided.

β€‹πŸ’‘Tip: The Tagging article of our documentation shows you the various ways on how you can add or remove tags from a new or existing test case.

Finally, click Start to prepare and turn on the test device.

β€‹πŸ‘¨πŸ’» Operating the device

Once Mesmer finishes preparing the device, it will automatically run your app. To begin building your test case, all you have to do is execute the sequence of actions needed to complete it. Mesmer records the type of gesture you made to an object within your app as a single step. The more gestures you make to complete your test case, the more steps it will have.

Speaking of gestures☝, it's time we talked about them. πŸ—£

β€‹πŸ‘‡ Working with gestures

You have three types of gestures to choose from when operating the device. They simulate exactly the same gestures as you would do on a real device. But in Mesmer, you'll have to do that with a mouse.

The gestures are available in the Device Gestures and Controls toolbar, located on the left-most side of the New Test Case screen. Click the Gestures button to select one.

The three gestures are:

  1. Tap: This is the default gesture selected. To mimic the tap as you would do on a real device, hover the mouse cursor to any location in device's screen and left-click.

  2. Long Press: Similar to how you perform the tap gesture, but holding left-click for a few seconds more before releasing. You usually use this gesture when selecting, copying, or pasting text.

  3. Swipe: A "fling" to one of the four cardinal directions (top, bottom, left, right). Performing this gesture with the mouse involves using only two left-clicks. Here's how you do it:

    1. First, left-click on the area of the screen where the swipe must start. This is your starting point.

    2. Next, move your mouse cursor to your desired fling direction, limited only by the four cardinal directions. As your mouse cursor moves, the starting point will follow and point to the direction where it's currently at.

    3. Finally, left-click again to commit to the direction where the mouse cursor is. This becomes the finishing point, and the swipe gesture is performed.

The Tap gesture
The Long Press gesture
The Swipe gesture

Keyboard shortcuts

You can easily switch among the different types of gestures using these keyboard shortcuts:

macOS
Windows
macOS

Gesture

Shortcut

Tap

Option + T

Long Press

Option + C

Swipe

Option + W

Windows

Gesture

Shortcut

Tap

Alt + T

Long Press

Alt + C

Swipe

Alt + W

β€‹πŸ’‘Tip: For efficiency, we recommend using the keyboard shortcuts when switching among different gestures. There's noticeably an ample amount of distance between the test device and the Device Gestures and Controls toolbar. You wouldn't want to keep moving your mouse back and forth within that distance just to switch gestures, right?

Knowing the shortcuts helps you switch instantly from one gesture to another as your mouse stays within the mobile device's screen, staying ready to execute the gesture.πŸ‘Š

β€‹βŒ¨ Using the keyboard

The only keyboard you'll use to input data when doing your test case is your computer's keyboard. Mesmer does not simulate the on-screen keyboard you would normally expect from a mobile device.

When you tap on a text field or any UI object that expects user input, just begin typing, and Mesmer will save your input to a variable. This way, you can reuse the value multiple times over the course of your test case or make it globally available to your current project.

Using the keyboard to enter input data

β€‹πŸ” Locking or unlocking the device

Click either the Lock Device or Unlock Device button to toggle between locking or unlocking the device, respectively.

Toggling between device locking and unlocking

β€‹πŸ“² Rebooting the device

Rebooting a device is useful when it enters into a bad state or if you just need to clean up or correct your recorded steps.

To reboot the device, click the Reboot button on the toolbar. Not only will this reboot the device, but it will also erase all your previously recorded steps. For example, if your test case has already recorded eight steps, then rebooting the device brings you to a fresh start again.

Clicking the Reboot button to reboot the device

β€‹πŸ‘©πŸ«Note: Device rebooting is the only action not recorded by Mesmer. Just think about it, why record this action as a step when its function is to simply clear all recorded data and start anew? πŸ€”

β€‹πŸ’‘Tip: If you have problems with a device that can't be resolved by a reboot, please contact Mesmer for support.

β€‹βŒ Closing an application

Lastly, you can close an open application on the device. Click the Close Application button to do this.

Clicking the Close Application button to close the application

This action applies to any application, whether it be yours or anything installed on the device. This is useful if you need to test your app for some background-related functionality that requires you to get outside it.

β€‹πŸ‘©πŸ«Note: Closing an application in Mesmer does not terminate it. It just exits the app and puts it in the background so that the Home screen of the device's operating system appears. Switching back to the closed application is still possible.

​πŸ–₯ The New Test Case screen

Before you start performing more gestures on the device and adding assertions to your test case, it’s best that we now discuss with you the workspace or screen you’ll be spending most of the time with.

Aside from having the Device Gestures and Controls toolbar to work with, the New Test Case screen allows you to enter into full-screen mode and the function to pause Mesmer’s recording. Going full-screen mode, obviously, gives you more screen estateπŸ–Όwhen working. Pausing gives you the chance to take a break🍡or figure out your next steps or assertions while ensuring no accidental gestures are recorded.

Working with functions available in the New Test Case screen

But waitβœ‹, there’s moreπŸ˜…. The following page will also discuss other standard screen elements present among other Mesmer screens and not just on the New Test Case screen. Your familiarization with them is vital to your productivity in the Mesmer platform.