Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes