Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

ResizeObserver.unobserve() — arrêter d’observer un élément

La méthode unobserve(target) retire un élément des observations d’un ResizeObserver, sans modifier ses autres cibles.

Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

observer.unobserve(target)

observer.unobserve(target) retire l’Element indiqué de la liste des cibles de cet observateur. La méthode renvoie undefined. Passez l’élément lui-même, et non une chaîne de sélecteur.

Un nouvel appel pour un élément qui n’est pas observé ne change rien. En revanche, disconnect() retire toutes les cibles. L’observation peut reprendre avec observe(target).

La méthode ne retire pas l’élément du document et n’annule pas les entrées déjà transmises au callback. Elle est utile pour nettoyer un composant individuel.

Il s’agit d’une API de navigateur spécifiée dans Resize Observer Module Level 1, et non d’une fonctionnalité ECMAScript. La présence de Node 24 ne garantit pas sa disponibilité dans le navigateur ; vérifiez l’environnement cible.

Exemples

(() => {
  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);
})();

Résultat

true

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources