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.