gitmyhub

Telekinesis

JavaScript ★ 10 updated 13y ago

User gesture input simulation.

Telekinesis simulates human touch gestures like taps, drags, and swipes in code, so you can automatically test touch-based apps without touching a device.

JavaScriptsetup: easycomplexity 2/5

Telekinesis is a tool that simulates human touch gestures on a screen — like taps, drags, and swipes — so you can test mobile apps and web apps automatically without actually touching a device.

Think of it like a robot hand that can touch your app the same way a real person would. When you're testing an app, instead of manually tapping and dragging on a phone over and over, you write code that tells Telekinesis where to tap and drag. It then performs those exact gestures so you can verify your app responds correctly. In the code example, a "finger" object is created, then told to drag from one spot on the screen to another, and run a callback when done.

This is useful for developers and QA teams who need to test touch-based features repeatedly. For example, if you're building a drawing app and want to make sure the brush works when users drag their finger across the canvas, you could write a test using Telekinesis that automatically performs that drag gesture hundreds of times, or with dozens of different paths, without anyone manually touching the device. It's part of the broader category of test automation — replacing manual, repetitive work with code that does it consistently and fast.

The project is fairly minimal based on the README provided — it doesn't explain all the gesture types it supports or how to integrate it into a testing framework. But the core idea is straightforward: it bridges the gap between automated testing and real user behavior by programmatically simulating the touches and gestures that actual users would do.

Where it fits