CKTIS / JavaScript
ResizeObserver.observe — observar o tamanho de um elemento
ResizeObserver.observe regista um elemento para receber notificações assíncronas sobre o tamanho. A opção box seleciona a área observada.
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
observer.observe(target, { box: "content-box" });observer.observe(target, options) aceita um Element e devolve undefined. As notificações chegam ao callback do observador durante a renderização, não de forma síncrona.
box é, por predefinição, "content-box" (conteúdo); "border-box" também inclui o padding e as bordas, enquanto "device-pixel-content-box" mede o conteúdo em píxeis inteiros do dispositivo. Esta seleção controla quando as notificações são acionadas, não os campos disponíveis na entrada. As transformações CSS não acionam observações.
Voltar a chamar observe para o mesmo elemento com o mesmo valor de box não tem efeito no Chromium. Não conte com essa chamada para substituir o registo ou repor o respetivo estado de notificação em todos os navegadores. unobserve(target) remove um registo; disconnect() remove todos. Evite alterações cíclicas ao tamanho no callback. Trata-se de uma Web API, não de uma funcionalidade ECMAScript; o Node 24 não comprova o suporte nos navegadores.
Exemplos
const target = document.createElement("div");
target.style.cssText = "all: initial; display: block; width: 120px; height: 40px;";
document.body.append(target);
const observer = new ResizeObserver(([entry]) => {
console.log(`${entry.contentRect.width} x ${entry.contentRect.height}`);
observer.disconnect();
target.remove();
});
observer.observe(target, { box: "content-box" });Resultado
120 x 40
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.