setter

Sintaxis

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

Parmetros

prop

El nombre de la propiedad a asociar con la funcin dada.

val

Un alias para la variable que contiene el valor a asignar a la propiedad.

expression

A partir de ECMAScript 2015, se puede tambin usar expresiones para nombres de propiedades computados para asociar a la funcin dada.

Descripcin

En JavaScript, un setter puede ser usado para ejecutar una funcin donde sea que una propiedad se intente cambiar. Los setters son regularmente usados en conjunto con getters para crear un tipo de pseudo-propiedad. No es posible tener simultneamente un setter en una propiedad que ya tiene un valor.

Tenga en cuenta lo siguiente al trabajar con setters:

• Puede tener un identificador ya sea number o string;
• Debe tener exactamente un parmentro (ver Incompatible ES5 change: literal getter and setter functions must now have exactly zero or one arguments para ms informacin);
• No debe aparecer en un objeto de notacin literal con otro set o con otra entrada de datos con la misma propiedad. ( { set x(v) { }, set x(v) { } } y { x: ..., set x(v) { } } estn prohibidos )

Ejemplos

Definiendo un setter en el inicializador de nuevos objetos

En el siguiente ejemplo definimos una pseudo-propiedad actual al objeto lenguaje. Cuando se le asigne un valor a actual, actualiza log con ese valor:

var lenguaje = {
  set actual(mensaje) {
    this.log.push(mensaje);
  },
  log: [],
};
lenguaje.actual = "ES";
console.log(lenguaje.log); // ['ES']

lenguaje.actual = "FR";
console.log(lenguaje.log); // ['ES', 'FR']

Note que actual no est definido y cualquier intento de accederlo devolver undefined.

Eliminando un setter con el operador delete

Si desea eliminar el setter, puede simplemente aplicar delete en l:

delete lenguaje.actual;

Definiendo un setter en un objecto existente usando defineProperty

Para aadir un setter a un objeto existente, use Object.defineProperty()

const o = { a: 0 };

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

o.b = 10; // Ejecuta el setter, el cual asigna 10 / 2 (5) a la propiedad 'a'
console.log(o.a); // 5

Usando un nombre de propiedad computado

const expr = "foo";

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

console.log(obj.baz); // "bar"
obj.foo = "baz"; // ejecuta el setter
console.log(obj.baz); // "baz"

Especificaciones

Compatibilidad con navegadores

Ver tambin

• getter
• delete
• Object.defineProperty()
• Object.prototype.__defineGetter__()
• Object.prototype.__defineSetter__()
• Definiendo Getters y Setters en la Gua JavaScript