Of the 6 Pointer methods, browser sessions serve 6, phone sessions 0 and computer sessions 6. A method marked not served answers StrategyUnavailable on that kind of session; check the handshake’s capabilities before relying on one.

Pointer.click

Browser: served Phone: not served Computer: served Takes targetId Move the pointer to the point and click there.
{"id": 1, "method": "Pointer.click", "params": {"x": 640, "y": 360}}
ParamTypeRequiredDescription
spacestringNoThe space a call’s coordinates and returned bounds are in. screen is the desktop’s pixels from its top-left: the only space in a computer session, and its default there. In a browser session window (the default) is window pixels. viewport is the page’s CSS pixels from the main frame viewport’s top-left, as Playwright’s page.mouse and boundingBox use; under it a point outside the viewport fails with InvalidArgs. One of window, viewport, screen. Default "window".
xintegerYes
yintegerYes
buttonstringNoThe mouse button to use. One of left, right, middle. Default "left".
clickCountintegerNoClicks in quick succession; 2 is a double click. Omitted means 1. Default 1.
modifiersstring[]NoModifier keys to hold. A session that cannot hold modifiers answers StrategyUnavailable. One of ctrl, shift, alt, meta.
inputstringNoHow the input reaches the page. Browsers serve os (the default), real operating system input; simulated answers StrategyUnavailable.
idempotencyKeystringNoMakes a re-send after a reconnect safe: a repeated key returns the recorded response without acting again. See Idempotency keys.
Result
FieldTypeDescription
tookMsintegerEnd-to-end time on the session.
inputstringHow the input reaches the page. Browsers serve os (the default), real operating system input; simulated answers StrategyUnavailable.

Pointer.move

Browser: served Phone: not served Computer: served Takes targetId Move the pointer to the point without pressing a button.
{"id": 1, "method": "Pointer.move", "params": {"x": 640, "y": 360}}
ParamTypeRequiredDescription
spacestringNoThe space a call’s coordinates and returned bounds are in. screen is the desktop’s pixels from its top-left: the only space in a computer session, and its default there. In a browser session window (the default) is window pixels. viewport is the page’s CSS pixels from the main frame viewport’s top-left, as Playwright’s page.mouse and boundingBox use; under it a point outside the viewport fails with InvalidArgs. One of window, viewport, screen. Default "window".
xintegerYes
yintegerYes
inputstringNoHow the input reaches the page. Browsers serve os (the default), real operating system input; simulated answers StrategyUnavailable.
Result
FieldTypeDescription
tookMsintegerEnd-to-end time on the session.
inputstringHow the input reaches the page. Browsers serve os (the default), real operating system input; simulated answers StrategyUnavailable.

Pointer.down

Browser: served Phone: not served Computer: served Takes targetId Move the pointer to the point and press a button, holding it until Pointer.up.
{"id": 1, "method": "Pointer.down", "params": {"x": 640, "y": 360}}
ParamTypeRequiredDescription
spacestringNoThe space a call’s coordinates and returned bounds are in. screen is the desktop’s pixels from its top-left: the only space in a computer session, and its default there. In a browser session window (the default) is window pixels. viewport is the page’s CSS pixels from the main frame viewport’s top-left, as Playwright’s page.mouse and boundingBox use; under it a point outside the viewport fails with InvalidArgs. One of window, viewport, screen. Default "window".
xintegerYes
yintegerYes
buttonstringNoThe mouse button to use. One of left, right, middle. Default "left".
modifiersstring[]NoModifier keys to hold. A session that cannot hold modifiers answers StrategyUnavailable. One of ctrl, shift, alt, meta.
inputstringNoHow the input reaches the page. Browsers serve os (the default), real operating system input; simulated answers StrategyUnavailable.
idempotencyKeystringNoMakes a re-send after a reconnect safe: a repeated key returns the recorded response without acting again. See Idempotency keys.
Result
FieldTypeDescription
tookMsintegerEnd-to-end time on the session.
inputstringHow the input reaches the page. Browsers serve os (the default), real operating system input; simulated answers StrategyUnavailable.

Pointer.up

Browser: served Phone: not served Computer: served Takes targetId Move the pointer to the point and release a button held by Pointer.down.
{"id": 1, "method": "Pointer.up", "params": {"x": 640, "y": 360}}
ParamTypeRequiredDescription
spacestringNoThe space a call’s coordinates and returned bounds are in. screen is the desktop’s pixels from its top-left: the only space in a computer session, and its default there. In a browser session window (the default) is window pixels. viewport is the page’s CSS pixels from the main frame viewport’s top-left, as Playwright’s page.mouse and boundingBox use; under it a point outside the viewport fails with InvalidArgs. One of window, viewport, screen. Default "window".
xintegerYes
yintegerYes
buttonstringNoThe mouse button to use. One of left, right, middle. Default "left".
modifiersstring[]NoModifier keys to hold. A session that cannot hold modifiers answers StrategyUnavailable. One of ctrl, shift, alt, meta.
inputstringNoHow the input reaches the page. Browsers serve os (the default), real operating system input; simulated answers StrategyUnavailable.
idempotencyKeystringNoMakes a re-send after a reconnect safe: a repeated key returns the recorded response without acting again. See Idempotency keys.
Result
FieldTypeDescription
tookMsintegerEnd-to-end time on the session.
inputstringHow the input reaches the page. Browsers serve os (the default), real operating system input; simulated answers StrategyUnavailable.

Pointer.drag

Browser: served Phone: not served Computer: served Takes targetId Press a button at from, move to to, and release it there, in one call.
{"id": 1, "method": "Pointer.drag", "params": {"from": {}, "to": {}}}
ParamTypeRequiredDescription
spacestringNoThe space a call’s coordinates and returned bounds are in. screen is the desktop’s pixels from its top-left: the only space in a computer session, and its default there. In a browser session window (the default) is window pixels. viewport is the page’s CSS pixels from the main frame viewport’s top-left, as Playwright’s page.mouse and boundingBox use; under it a point outside the viewport fails with InvalidArgs. One of window, viewport, screen. Default "window".
fromPointYesA position in window pixels (the space screenshots use), (0, 0) at the top-left of the browser window. A point outside the window (negative, x at or past screenWidth, or y at or past screenHeight, from Device.info) fails with InvalidArgs.
toPointYesA position in window pixels (the space screenshots use), (0, 0) at the top-left of the browser window. A point outside the window (negative, x at or past screenWidth, or y at or past screenHeight, from Device.info) fails with InvalidArgs.
buttonstringNoThe mouse button to use. One of left, right, middle. Default "left".
modifiersstring[]NoModifier keys to hold. A session that cannot hold modifiers answers StrategyUnavailable. One of ctrl, shift, alt, meta.
inputstringNoHow the input reaches the page. Browsers serve os (the default), real operating system input; simulated answers StrategyUnavailable.
idempotencyKeystringNoMakes a re-send after a reconnect safe: a repeated key returns the recorded response without acting again. See Idempotency keys.
Result
FieldTypeDescription
tookMsintegerEnd-to-end time on the session.
inputstringHow the input reaches the page. Browsers serve os (the default), real operating system input; simulated answers StrategyUnavailable.

Pointer.wheel

Browser: served Phone: not served Computer: served Takes targetId Scroll at the point by deltaX and deltaY CSS pixels.
{"id": 1, "method": "Pointer.wheel", "params": {"x": 640, "y": 360}}
ParamTypeRequiredDescription
spacestringNoThe space a call’s coordinates and returned bounds are in. screen is the desktop’s pixels from its top-left: the only space in a computer session, and its default there. In a browser session window (the default) is window pixels. viewport is the page’s CSS pixels from the main frame viewport’s top-left, as Playwright’s page.mouse and boundingBox use; under it a point outside the viewport fails with InvalidArgs. One of window, viewport, screen. Default "window".
xintegerYes
yintegerYes
deltaXintegerNoHorizontal scroll in CSS pixels.
deltaYintegerNoVertical scroll in CSS pixels.
modifiersstring[]NoModifier keys to hold. A session that cannot hold modifiers answers StrategyUnavailable. One of ctrl, shift, alt, meta.
inputstringNoHow the input reaches the page. Browsers serve os (the default), real operating system input; simulated answers StrategyUnavailable.
idempotencyKeystringNoMakes a re-send after a reconnect safe: a repeated key returns the recorded response without acting again. See Idempotency keys.
Result
FieldTypeDescription
tookMsintegerEnd-to-end time on the session.
inputstringHow the input reaches the page. Browsers serve os (the default), real operating system input; simulated answers StrategyUnavailable.