CKTIS / JavaScript
DOMRect.top — coordenada del borde superior
`DOMRect.top` es una propiedad de solo lectura que devuelve la coordenada del borde superior de un rectángulo. Incluso si la altura es negativa, el redondeo en coma flotante puede hacer que el resultado sea igual a `y`.
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
rect.topDOMRect.top es una propiedad de instancia heredada de DOMRectReadOnly. Devuelve un número que describe la coordenada del borde superior, no la altura del rectángulo.
Para valores finitos de y y height, equivale a Math.min(rect.y, rect.y + rect.height). Si la altura es no negativa, es igual a y; si es negativa, es y + height.
top sigue siendo de solo lectura incluso en un DOMRect modificable: cambia y o height, no top. El ejemplo muestra cómo el resultado cambia de 30 a 50. Esto es una API web, no una característica del lenguaje ECMAScript; la presencia de Node 24 no demuestra que esté disponible.
Ejemplos
const rect = new DOMRect(10, 50, 80, -20);
console.log(rect.top);
rect.height = 20;
console.log(rect.top);Resultado
30 50
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.