Attention : Cette fonctionnalité est dépréciée et il est préférable d'utiliser l'API Object.defineProperty() et la syntaxe d'initialisation d'objets. Toutefois, __defineGetter__ est largement utilisée sur le Web et est implémentée. Il est donc peu probable que les navigateurs retirent cette méthode.
La méthode __defineSetter__ permet de lier une propriété d'un objet à une fonction qui sera exécutée pour toute tentative de définition/changement de cette propriété.
Syntaxe
obj.__defineSetter__(prop, fun)
Paramètres
prop- Une chaîne de caractères qui contient le nom de la propriété qu'on souhaite lier à la fonction.
fun- Une fonction à appeler pour chaque modification de la propriété. Cette fonction prend la forme suivante :
function(val) { . . . }val- Un alias pour la variable contenant la nouvelle valeur qu'on souhaite affecter à
prop.
Valeur de retour
Description
La méthode __defineSetter__ permet de définir un mutateur sur un objet pré-existant.
Exemples
// Méthode non-standard et dépréciée
var o = {};
o.__defineSetter__('valeur', function(val) { this.uneAutreValeur = val; });
o.valeur = 5;
console.log(o.valeur); // undefined
console.log(o.uneAutreValeur); // 5
// Façons standard
// En utilisant l'opérateur set
var o = { set valeur(val) { this.uneAutreValeur = val; } };
o.valeur = 5;
console.log(o.valeur); // undefined
console.log(o.uneAutreValeur); // 5
// En utilisant Object.defineProperty
var o = {};
Object.defineProperty(o, 'valeur', {
set: function(val) {
this.uneAutreValeur = val;
}
});
o.valeur = 5;
console.log(o.valeur); // undefined
console.log(o.uneAutreValeur); // 5
Spécifications
| Spécification | État | Commentaires |
|---|---|---|
| ECMAScript 2017 Draft (ECMA-262) La définition de 'Object.prototype.__defineSetter__()' dans cette spécification. |
Projet | Incluse dans l'annexe normative pour les fonctionnalités historiques liées aux navigateurs web (la spécification codifie ce qui est déjà présent dans les différentes implémentations). |
Compatibilité des navigateurs
| Fonctionnalité | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
|---|---|---|---|---|---|
| Support simple | (Oui) | (Oui) | 11 | (Oui) | (Oui) |
| Fonctionnalité | Android | Chrome pour Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
|---|---|---|---|---|---|---|
| Support simple | (Oui) | (Oui) | (Oui) | ? | (Oui) | (Oui) |
Notes de compatibilité
- À partir de Firefox 48 (Firefox 48 / Thunderbird 48 / SeaMonkey 2.45), cette méthode ne peut plus être appelée dans la portée globale sans être rattachée à aucun objet, sinon, elle lèvera une exception
TypeError. Avant, l'objet global était utilisé automatiquement mais ce n'est désormais plus le cas (cf. bug 1253016).