CKTIS / JavaScript
ResizeObserver.unobserve() — deixar de observar um elemento
O método unobserve(target) remove um elemento das observações de um ResizeObserver, mantendo inalterados os restantes alvos.
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.unobserve(target)observer.unobserve(target) remove o Element indicado da lista de alvos deste observador. Devolve undefined. Passa o próprio elemento, não uma cadeia de seletor.
Voltar a chamar o método para um elemento que não está a ser observado não altera nada. Em contrapartida, disconnect() remove todos os alvos. A observação pode ser retomada com observe(target).
O método não remove o elemento do documento nem retira entradas já transmitidas ao callback. É útil para limpar um componente individual.
Esta é uma API do browser especificada em Resize Observer Module Level 1, não uma funcionalidade ECMAScript. A existência do Node 24 não comprova a disponibilidade no browser; verifica o ambiente de destino.
Exemplos
(() => {
const a = document.createElement('div');
const b = document.createElement('div');
for (const element of [a, b]) {
element.style.cssText = 'display:block;width:100px;height:20px';
document.body.append(element);
}
const observer = new ResizeObserver((entries) => {
console.log(entries.length === 1 && entries[0].target === b);
observer.disconnect();
a.remove();
b.remove();
});
observer.observe(a);
observer.observe(b);
observer.unobserve(a);
observer.unobserve(a);
})();Resultado
true
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.