Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

MouseEvent.clientY — coordenada vertical de la ventana gráfica

MouseEvent.clientY es una propiedad de solo lectura que indica la coordenada vertical de un evento de ratón con respecto a la ventana gráfica. No describe una posición relativa al elemento de destino ni a la pantalla física.

Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxis

event.clientY

MouseEvent.clientY indica la coordenada vertical en la que se produjo un evento, con respecto a la ventana gráfica asociada a ese evento. Puedes leerla como event.clientY, por ejemplo, al gestionar mousemove o click. Es una propiedad de solo lectura.

El marco de referencia es la ventana gráfica, no el elemento al que se dirige el evento. No la confundas con clientX, que describe la posición horizontal, ni con screenY, cuyo marco de referencia es la pantalla. Comprueba siempre el marco de referencia al interpretar coordenadas.

El ejemplo crea un evento sintético con clientY: 120 y otro sin una coordenada explícita. El constructor inicializa la propiedad; no le asignas un valor después de crear el objeto. Si se omite clientY, su valor predeterminado es 0. Crear el evento no mueve el puntero real del ratón.

Ejecuta el ejemplo en la consola del navegador. Los resultados esperados son 120 y, a continuación, 0. Se trata de una API Web, no de una característica del propio ECMAScript; que Node 24 esté presente en un repositorio no demuestra que MouseEvent esté disponible en ese entorno.

Ejemplos

const event = new MouseEvent("mousemove", { clientY: 120 });
const defaultEvent = new MouseEvent("mousemove");

console.log(event.clientY);
console.log(defaultEvent.clientY);

Resultado

120
0

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes