playwright/docs/src/api/class-touchscreen.md

29 lines
1,010 B
Markdown
Raw Normal View History

# class: Touchscreen
2022-07-06 02:24:50 +02:00
* since: v1.8
The Touchscreen class operates in main-frame CSS pixels relative to the top-left corner of the viewport. Methods on the
2021-03-26 18:47:16 +01:00
touchscreen can only be used in browser contexts that have been initialized with `hasTouch` set to true.
This class is limited to emulating tap gestures. For examples of other gestures simulated by manually dispatching touch events, see the [emulating legacy touch events](../touch-events.md) page.
## async method: Touchscreen.tap
2022-07-06 02:24:50 +02:00
* since: v1.8
Dispatches a `touchstart` and `touchend` event with a single touch at the position ([`param: x`],[`param: y`]).
:::note
[`method: Page.tap`] the method will throw if [`option: Browser.newContext.hasTouch`] option of the browser context is false.
:::
### param: Touchscreen.tap.x
2022-07-06 02:24:50 +02:00
* since: v1.8
- `x` <[float]>
X coordinate relative to the main frame's viewport in CSS pixels.
### param: Touchscreen.tap.y
2022-07-06 02:24:50 +02:00
* since: v1.8
- `y` <[float]>
Y coordinate relative to the main frame's viewport in CSS pixels.