Object.prototype.__defineGetter__()
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 __defineGetter__
permet de lier une propriété d'un objet à une fonction à exécuter lorsqu'on accède à la propriété.
Syntaxe
obj.__defineGetter__(prop, func)
Paramètres
prop
- Une chaîne de caractères contenant le nom de la propriété à lier à la fonction donnée.
func
- Une fonction à utiliser à chaque fois qu'on accède à la propriété.
Valeur de retour
Description
La méthode __defineGetter__
permet de définir un accesseur sur un objet pré-existant.
Exemples
// Méthode non-standard et dépréciée
var o = {};
o.__defineGetter__('gimmeFive', function() { return 5; });
console.log(o.gimmeFive); // 5
// Façon standard
// En utilisant l'opérateur get
var o = { get gimmeFive() { return 5; } };
console.log(o.gimmeFive); // 5
// En utilisant Object.defineProperty
var o = {};
Object.defineProperty(o, 'gimmeFive', {
get: function() {
return 5;
}
});
console.log(o.gimmeFive); // 5
Spécifications
Spécification | État | Commentaires |
---|---|---|
ECMAScript (ECMA-262) La définition de 'Object.prototype.__defineGetter__()' dans cette spécification. |
Standard évolutif | 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
BCD tables only load in the browser
Voir aussi
Object.prototype.__defineSetter__()
(en-US)- L'opérateur
get
Object.defineProperty()
Object.prototype.__lookupGetter__()
(en-US)Object.prototype.__lookupSetter__()
(en-US)- Guide JavaScript : définir des getters et setters
- [Billet de blog] Deprecation of __defineGetter__ and __defineSetter__ (en anglais)
- bug 647423