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

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.

Fontes