CKTIS / JavaScript
MouseEvent.clientY — coordenada vertical da área de visualização
MouseEvent.clientY é uma propriedade só de leitura que indica a coordenada vertical de um evento do rato em relação à área de visualização. Não descreve uma posição em relação ao elemento de destino nem ao ecrã físico.
Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxe
event.clientYMouseEvent.clientY indica a coordenada vertical do local onde ocorreu um evento, em relação à área de visualização associada a esse evento. Pode lê-la como event.clientY, por exemplo, ao tratar mousemove ou click. É uma propriedade só de leitura.
O referencial é a área de visualização, não o elemento de destino do evento. Não a confunda com clientX, que descreve a posição horizontal, nem com screenY, cujo referencial é o ecrã. Verifique sempre o referencial ao interpretar coordenadas.
O exemplo cria um evento sintético com clientY: 120 e outro sem uma coordenada explícita. O construtor inicializa a propriedade; não lhe atribui um valor depois de criar o objeto. Se clientY for omitida, o valor predefinido é 0. A criação do evento não move o ponteiro real do rato.
Execute o exemplo na consola do navegador. Os resultados esperados são 120 e, em seguida, 0. Trata-se de uma API Web, não de uma funcionalidade do próprio ECMAScript; a presença do Node 24 num repositório não comprova que MouseEvent esteja disponível nesse ambiente.
Exemplos
const event = new MouseEvent("mousemove", { clientY: 120 });
const defaultEvent = new MouseEvent("mousemove");
console.log(event.clientY);
console.log(defaultEvent.clientY);Resultado
120 0
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.