CKTIS / JavaScript
Reflect.setPrototypeOf — establecer el prototipo de un objeto
Reflect.setPrototypeOf(target, proto) intenta establecer el prototipo de un objeto y devuelve un valor booleano. Permite distinguir entre un cambio rechazado y unos argumentos no válidos, que provocan TypeError.
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.setPrototypeOf(target, proto)Reflect.setPrototypeOf(target, proto) invoca la operación interna [[SetPrototypeOf]] del objeto target. El prototipo se utiliza para buscar propiedades heredadas; el método no las copia al objeto. proto debe ser un objeto o null, que significa que no hay prototipo. Esto no modifica la propiedad .prototype de una función.
El resultado true indica que la operación se ha completado correctamente, incluso si el prototipo solicitado ya está establecido. El resultado false indica que se ha rechazado. En un objeto ordinario, cambiar a otro prototipo después de Object.preventExtensions(target) devuelve false. Volver a establecer el mismo prototipo sigue estando permitido, incluso en un objeto no extensible. Al comprobar si se formaría un ciclo en un objeto ordinario, la operación devuelve false si el recorrido de la cadena desde proto llega a target. Sin embargo, la comprobación se detiene al encontrar un objeto que no utiliza el método interno ordinario [[GetPrototypeOf]]. Por tanto, un Proxy en la cadena puede permitir que se forme un ciclo aunque target sea un objeto ordinario.
Un resultado booleano no garantiza que no se produzcan excepciones: un target primitivo o un proto no válido provoca TypeError. Los errores de la operación interna, incluidos los de una trampa de Proxy, se propagan. En cambio, si target es un objeto, Object.setPrototypeOf devuelve el objeto cuando tiene éxito y lanza TypeError si la operación interna devuelve false.
El ejemplo muestra la herencia sin copiar y la diferencia entre conservar y cambiar el prototipo después de impedir las extensiones. La especificación del lenguaje no es una tabla de compatibilidad de navegadores; usar Node 24 en un repositorio no demuestra que haya compatibilidad con navegadores.
Ejemplos
const proto = { label: "shared" };
const item = {};
console.log(Reflect.setPrototypeOf(item, proto));
console.log(item.label);
console.log(Object.hasOwn(item, "label"));
Object.preventExtensions(item);
console.log(Reflect.setPrototypeOf(item, proto));
console.log(Reflect.setPrototypeOf(item, null));
console.log(Object.getPrototypeOf(item) === proto);Resultado
true shared false true false true
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.