Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

Reflect.set — asignación de propiedad con un resultado booleano

Reflect.set realiza una operación de asignación de propiedad y devuelve un booleano que indica si se ha realizado correctamente. Su receiver opcional permite separar el objeto donde comienza la búsqueda de la propiedad del objeto que recibe la escritura.

Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxis

Reflect.set(target, key, value[, receiver])

Reflect.set(target, key, value[, receiver]) invoca la operación interna [[Set]] del objeto target. El argumento key se convierte en una clave de propiedad: una cadena o un símbolo. Si se omite receiver, su valor predeterminado es target.

El resultado es true o false, no el valor asignado. En objetos ordinarios, false puede indicar, por ejemplo, que se ha intentado cambiar una propiedad con writable: false, usar un accesor sin setter o añadir una propiedad a un receptor no extensible. Por sí solo, un resultado false no provoca una excepción ni siquiera en modo estricto, a diferencia de una asignación rechazada target[key] = value en ese modo.

La búsqueda del descriptor comienza en target y puede recorrer sus prototipos. Para una propiedad de datos escribible, la escritura suele crear o actualizar una propiedad propia de receiver, teniendo en cuenta sus restricciones. Al llamar a un setter, se pasa receiver como argumento this. Si el setter es una función ordinaria de JavaScript en modo no estricto, su this toma el valor global de this en lugar de null o undefined, y los demás valores primitivos se convierten en objetos envoltorio. Se ignora el valor que devuelve el setter. Por tanto, true no garantiza que una lectura posterior devuelva value.

El método no sirve para capturar errores: un target que no sea un objeto provoca un TypeError, y las excepciones de la conversión de la clave, de un setter o de una trampa de Proxy se propagan. Al definir directamente una propiedad propia no se recorre la cadena de prototipos ni se invocan setters heredados, pero siguen aplicándose las restricciones del descriptor de una propiedad propia existente. Por ejemplo, no se puede cambiar el valor de una propiedad de datos propia que no sea configurable ni escribible.

Ejemplos

"use strict";
const target = { score: 1 };
const receiver = {};
console.log(Reflect.set(target, "score", 7, receiver));
console.log(target.score, receiver.score);

Object.defineProperty(target, "fixed", {
  value: 10,
  writable: false
});
console.log(Reflect.set(target, "fixed", 20));
console.log(target.fixed);

Resultado

true
1 7
false
10

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes