setter

Il costrutto sintattico set collega una proprietà di un oggetto ad una funzione che viene chiamata quando si ha un tentavo di modifica quella proprietà.

Sintassi

{set prop(val) { . . . }}
{set [expression](val) { . . . }}

Parametri

prop

Il nome della proprietà da collegare alla funzione data.

val

Un alias per la variabile che contiene il valore che si sta cercando di assegnare a prop.

expression

A partire da ECMAScript 6, è possibile anche usare espressioni per nomi di proprietà computate da collegare alla funzione data.

Descrizione

In JavaScript, un setter può essere utilizzato per eseguire una funzione ogniqualvolta una proprietà specificata sta per essere modificata. I Setters sono quasi sempre utilizzati insieme ai getters per creare un tipo di pseudo proprietà. Non è possibile avere un setter su una normale proprietà che contiene un valore.

Alcune note da considerare quando si utilizza il costrutto sintattico set:

Un setter può essere eliminato usando l'operatore delete.

Esempi

Definire un setter per nuovi oggetti in inizializzatori di oggetti

Questo snippet di codice definisce una pseudo proprietà current di un oggetto o che, una volta che vi si assegna un valore, aggiornerà log con quel valore:

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

Nota che  current non è definito ed ogni tentativo di accedervi risulterà in un undefined.

Rimuovere un setter con l'operatore delete

Se vuoi rimuovere il setter usato sopra, puoi semplicemente usare delete:

delete o.current;

Definire un setter su oggetti pre-esistenti usando defineProperty

Per aggiungere un setter ad un oggetto pre-esistente, usaObject.defineProperty().

var o = { a:0 };

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

o.b = 10; // Runs the setter, which assigns 10 / 2 (5) to the 'a' property
console.log(o.a) // 5

Usare il nome di una proprietà computata

var expr = "foo";

var obj = {
  baz: "bar",
  set [expr](v) { this.baz = v; }
};

console.log(obj.baz); // "bar"
obj.foo = "baz";      // run the setter
console.log(obj.baz); // "baz"

Specifiche

Compatibilità dei browsers

Note specifiche per SpiderMonkey

• A partire da JavaScript 1.8.1,  i setters non sono più chiamati durante il setting delle properietà negli inizializzatori di oggetti od array.
• A partire da SpiderMonkey 38, un setter con rest parameter produce un SyntaxError come  da specifica ES6.

Guarda anche

• getter
• delete
• Object.defineProperty()
• __defineGetter__
• __defineSetter__
• Defining Getters and Setters nella guida JavaScript