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.clientYMouseEvent.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.