Non standard
Cette fonctionnalité n'est ni standard, ni en voie de standardisation. Ne l'utilisez pas pour des sites accessibles sur le Web : elle ne fonctionnera pas pour tout utilisateur. Il peut également y avoir d'importantes incompatibilités entre les implémentations et son comportement peut être modifié dans le futur.
Attention : Si possible, ne pas utiliser unwatch() et watch(). En effet, ces deux méthodes ne sont implémentées qu'avec Gecko et ne sont prévues que pour du débogage. De plus, l'ajout de points d'arrêts conditionnels a de graves impacts sur les performances, notamment sur les objets globaux comme window. Il est conseillé d'utiliser les accesseurs et mutateurs ou les proxies. Voir le tableau de compatibilité ci-après pour plus de détails.
La méthode unwatch() permet de retirer un point d'arrêt conditionnel créé par la méthode watch().
Syntaxe
obj.unwatch(prop)
Paramètres
prop- Le nom de la propriété dont on ne veut plus suivre l'état.
Valeur de retour
Description
Le débogueur JavaScript possède plusieurs fonctionnalités, y compris celles offertes par cette fonction. Pour plus d'informations sur cet outil, voir le débogueur JavaScript.
Par défaut, tous les objets qui descendent de Object héritent de cette méthode.
Note : unwatch() utilise le nom d'une seule propriété comme paramètre. Ce comportement est expliqué avec la méthode watch().
Exemples
Voir watch().
Spécifications
Cette méthode ne fait partie d'aucune spécification. Implémentée avec JavaScript 1.2.
Compatibilité des navigateurs
| Fonctionnalité | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
|---|---|---|---|---|---|
| Support simple | Pas de support | (Oui) | Pas de support | Pas de support | Pas de support |
| Fonctionnalité | Android | Chrome pour Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
|---|---|---|---|---|---|---|
| Support simple | Pas de support | Pas de support | (Oui) | Pas de support | Pas de support | Pas de support |
Notes de compatibilté
Si on appelle unwatch() sur un objet Document, on aura une exception TypeError à partir de Firefox 23 (bug 903332). Cette régression a été corrigée avec Firefox 27.