https://github.com/martinkr/simulatetouch.js

*.simulateTouch: enhance your automated tests by simulate touches and gestures!
https://github.com/martinkr/simulatetouch.js

Last synced: 2 months ago
JSON representation

*.simulateTouch: enhance your automated tests by simulate touches and gestures!

• Host: GitHub
• URL: https://github.com/martinkr/simulatetouch.js
• Owner: martinkr
• License: other
• Created: 2013-10-08T16:28:25.000Z (about 11 years ago)
• Default Branch: master
• Last Pushed: 2018-10-31T13:49:30.000Z (about 6 years ago)
• Last Synced: 2024-10-12T22:25:21.195Z (2 months ago)
• Language: JavaScript
• Size: 57.6 KB
• Stars: 7
• Watchers: 3
• Forks: 0
• Open Issues: 3
• Metadata Files:
  • Readme: README.markdown
  • License: LICENSE.markdown

Awesome Lists containing this project

README

        
[*.simulateTouch.js](https://github.com/martinkr/simulateTouch.js)

=======

Enhance your automated tests by simulate touches and gestures!

Works like a charm with Jasmine (https://jasmine.github.io/) the a behavior-driven development framework for testing JavaScript code.

## Example


	simulateTouch.swipeUp(element);

	simulateTouch.swipeRight(element);

	simulateTouch.swipeDown(element);

	simulateTouch.swipeLeft(element);

	simulateTouch.touch(element,aStart,aEnd,oEvent);

	simulateTouch.rotateLeft(element_)

	simulateTouch.rotateRight(element_)

	simulateTouch.pinchOpen(element_)

	simulateTouch.pinchClose(element_)

	simulateTouch.gesture(element_, aStart_, aEnd_, oEvent_ )



## Prefedined Swipes

### simulateTouch.swipeUp

 - Direction: up

 - Distance: 300px

 - @param  {HTML-Element} element_ Element to trigger events on

 - @return {Void}

### simulateTouch.swipeRight

- Direction: right

- Distance: 300px

- @param  {HTML-Element} element_ Element to trigger events on

- @return {Void}

### simulateTouch.swipeDown

- Direction: down

- Distance: 300px

- @param  {HTML-Element} element_ Element to trigger events on

- @return {Void}

### simulateTouch.swipeLeft

- Direction: left

- Distance: 300px

- @param  {HTML-Element} element_ Element to trigger events on

- @return {Void}

## Generic Swipe

### simulateTouch.touch

- @param  {HTML-Element} element_ Element to trigger events on

- @param  {Array} _aStart Array of Objects. Each object contains the details for a single touchpoint's start position.

- @param  {Array} _aEnd Array of Objects. Each object contains the details for a single touchpoint's end position.

- @param  {Object} _oEvent Contains the details for the event itself.

#### properties for a single touchpoint

 - target: The target of this gesture.

 - identifier: The unique identifier for this touch object.

 - pageX: The x-coordinate of the touch’s location, in page coordinates.

 - pageY: The y-coordinate of the touch’s location, in page coordinates.

 - screenX: The x-coordinate of the event’s location, in screen coordinates.

 - screenY: The y-coordinate of the event’s location, in screen coordinates.

 -  Note: on iOS clientX/Y equals pageX/Y so you can not set them

#### properties for the event

 - bubbles

 - detail

 - ctrlKey

 - altKey

 - shiftKey

 - metaKey

 - scale

 - rotation

 - pageX

 - pageY

### simulateTouch.rotateLeft

 - Direction: left

 - Distance: 90deg

 - @param  {HTML-Element} element_ Element to trigger events on

### simulateTouch.rotateRight

 - Direction: right

 - Distance: 90deg

 - @param  {HTML-Element} element_ Element to trigger events on

### simulateTouch.pinchOpen

 - Direction: move touchpoints away

 - Distance: 0.5

 - @param  {HTML-Element} element_ Element to trigger events on

### simulateTouch.pinchOpen

 - Direction: move touchpoints together

 - Distance: 0.5

 - @param  {HTML-Element} element_ Element to trigger events on

### simulateTouch.gesture

 - @param  {HTML-Element}	element_ Element to trigger events on

 - @param  {Array} _aStart	Array with one Object which contains the gestures start position.

 - @param  {Array} _aEnd	Array one Objects which contains the gestures end position.

 - @param  {Object} _oEvent	Contains the details for the event itself.

#### properties for the  start / end Object

 - rotation

 - scale

#### properties for the event

 - bubbles

 - detail

 - ctrlKey

 - altKey

 - shiftKey

 - metaKey

 - pageX

 - pageY

## Requires

- Safari and iOS

## License

Dual licensed under the MIT and GPL licenses.

* MIT - http://www.opensource.org/licenses/mit-license.php

* GNU - http://www.gnu.org/licenses/gpl-3.0.html

Copyright (c) 2010 - 2013 Martin Krause (martinkr.github.com)