setter

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since julio de 2015.

La sintaxis set asocia la propiedad de un objeto a una función que será llamada cuando haya un intento de asignar valor a esa propiedad.

Sintaxis

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

Parámetros

prop

El nombre de la propiedad a asociar con la función dada.

val

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

expression

A partir de ECMAScript 2015, se puede también usar expresiones para nombres de propiedades computados para asociar a la función dada.

En JavaScript, un setter puede ser usado para ejecutar una función 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 simultáneamente 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 parámentro (ver Incompatible ES5 change: literal getter and setter functions must now have exactly zero or one arguments para más información);
No debe aparecer en un objeto de notación 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) { } } están 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:

js
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 añadir un setter a un objeto existente, use Object.defineProperty()

js
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

Nota: Propiedades computadas son 'experimental technology', parte de la propuesta para ECMAScript 6, y no está soportado en todos los navegadores. Dará error de sintaxis en entornos no soportados.

js
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"

getter
delete
Object.defineProperty()
Object.prototype.__defineGetter__()
Object.prototype.__defineSetter__()
Definiendo Getters y Setters en la Guía JavaScript

Help improve MDN

Was this page helpful to you?

Yes No

Learn how to contribute

This page was last modified on 24 jun 2025 by MDN contributors.

View this page on GitHub • Report a problem with this content

setter

In this article

Sintaxis

Parámetros

Descripción

Ejemplos

Definiendo un setter en el inicializador de nuevos objetos

Eliminando un setter con el operador delete

Definiendo un setter en un objecto existente usando defineProperty

Usando un nombre de propiedad computado

Especificaciones

Compatibilidad con navegadores

Ver también

Help improve MDN