L'opérateur set

prop

Le nom de la propriété à lier à la fonction.

val

Un alias pour la variable qui contient la valeur qu'on souhaiterait affecter à prop.

expression

Avec ECMAScript 2015, il est également possible d'utiliser des expressions pour utiliser un nom de propriété calculé à lier à la fonction.

En JavaScript, un mutateur (ou setter en anglais) peut être utiisé afin d'exécuter une fonction à chaque fois qu'on souhaite modifier la valeur d'une propriété donnée. La plupart du temps, les mutateurs sont utilisés avec les accesseurs (getters) afin de créer une pseudo-propriété. Il n'est pas possible d'avoir à la fois un mutateur et une valeur donnée pour une même propriété.

On notera que set :

• peut avoir un identifiant qui est soit un nombre soit une chaîne de caractères
• doit avoir exactement un paramètre (voir l'article « Incompatible ES5 change: literal getter and setter functions must now have exactly zero or one arguments » (en anglais) pour plus d'informations)
• ne doit pas apparaître dans un littéral objet qui possède un autre set ou une autre propriété avec la même clé : ( { set x(v) { }, set x(v) { } } et { x: ..., set x(v) { } } seront interdits)

On peut retirer un mutateur d'un objet grâce à l'opérateur delete.

Dans l'exemple qui suit, on définit une pseudo-propriété courant pour un objet o qui, lorsqu'elle recevra une valeur, mettra à jour la propriété log avec la valeur reçue :

var o = {
  set courant(str) {
    this.log[this.log.length] = str;
  },
  log: [],
};

On notera que courant n'est pas défini. Toute tentative pour y accéder renverra undefined.

Si on souhaite retirer un mutateur, on peut simplement utiliser l'opérateur delete :

delete o.courant;

On peut également ajouter un mutateur sur un objet d'ores et déjà créé. Pour cela, on utilisera la méthode Object.defineProperty().

var o = { a: 0 };

Object.defineProperty(o, "b", {
  set: function (x) {
    this.a = x / 2;
  },
});

o.b = 10; // On utilise le setter, qui affecte 10 / 2 (5) à 'a'
console.log(o.a); // 5

• get
• delete
• Object.defineProperty()
• Object.prototype.__defineGetter__()
• Object.prototype.__defineSetter__()
• Définir des accesseurs et des mutateurs, dans le Guide JavaScript