2021-01-07 20:46:05 +01:00
# class: Touchscreen
2022-07-06 02:24:50 +02:00
* since: v1.8
2021-01-07 20:46:05 +01:00
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.
2021-01-07 20:46:05 +01:00
2025-02-24 23:13:27 +01:00
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.
2021-01-07 20:46:05 +01:00
## async method: Touchscreen.tap
2022-07-06 02:24:50 +02:00
* since: v1.8
2021-01-07 20:46:05 +01:00
Dispatches a `touchstart` and `touchend` event with a single touch at the position ([`param: x`],[`param: y`]).
2023-01-28 00:51:57 +01:00
:::note
2024-09-26 10:08:16 +02:00
[`method: Page.tap`] the method will throw if [`option: Browser.newContext.hasTouch`] option of the browser context is false.
2023-01-28 00:51:57 +01:00
:::
2021-01-07 20:46:05 +01:00
### param: Touchscreen.tap.x
2022-07-06 02:24:50 +02:00
* since: v1.8
2021-01-07 20:46:05 +01:00
- `x` < [float]>
2024-07-09 12:52:51 +02:00
X coordinate relative to the main frame's viewport in CSS pixels.
2021-01-07 20:46:05 +01:00
### param: Touchscreen.tap.y
2022-07-06 02:24:50 +02:00
* since: v1.8
2021-01-07 20:46:05 +01:00
- `y` < [float]>
2024-06-27 23:37:36 +02:00
2024-07-09 12:52:51 +02:00
Y coordinate relative to the main frame's viewport in CSS pixels.