CKTIS / JavaScript
DOMRect.top — coordenada do limite superior
`DOMRect.top` é uma propriedade só de leitura que devolve a coordenada do limite superior de um rectângulo. Mesmo com uma altura negativa, o arredondamento em vírgula flutuante pode fazer com que o resultado seja igual a `y`.
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
rect.topDOMRect.top é uma propriedade de instância herdada de DOMRectReadOnly. Devolve um número que descreve a coordenada do limite superior, não a altura do rectângulo.
Para valores finitos de y e height, corresponde a Math.min(rect.y, rect.y + rect.height). Com uma altura não negativa, é igual a y; com uma altura negativa, é y + height.
top continua a ser só de leitura mesmo num DOMRect modificável: altera y ou height, não top. O exemplo mostra o resultado a mudar de 30 para 50. Esta é uma API Web, não uma funcionalidade da linguagem ECMAScript; a presença do Node 24 não comprova a sua disponibilidade.
Exemplos
const rect = new DOMRect(10, 50, 80, -20);
console.log(rect.top);
rect.height = 20;
console.log(rect.top);Resultado
30 50
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.