CKTIS / JavaScript
Object.setPrototypeOf — cambiar el prototipo de un objeto
Para un objeto ordinario, una llamada exitosa a `Object.setPrototypeOf(obj, proto)` establece su prototipo interno sin copiar propiedades y devuelve el mismo objeto. `proto` debe ser un objeto o `null`. Si un `Proxy` tiene un objeto objetivo extensible, su trampa `setPrototypeOf` puede indicar que la operación se ha realizado correctamente sin cambiar el prototipo del objetivo. La llamada devuelve igualmente el `Proxy` original.
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
Object.setPrototypeOf(obj, proto)Para un objeto ordinario, una llamada exitosa a Object.setPrototypeOf(obj, proto) establece el [[Prototype]] interno de obj en proto. Las propiedades heredadas se buscan en la cadena de prototipos, en lugar de copiarse al objeto. En un objeto ordinario como el del ejemplo, las propiedades propias no cambian. Si obj es un Proxy con un objeto objetivo extensible, su trampa setPrototypeOf puede indicar que la operación se ha realizado correctamente sin cambiar el prototipo del objetivo. La llamada devuelve igualmente el Proxy original. La trampa también puede modificar las propiedades propias del objetivo durante una llamada que se completa correctamente. Llamar a Object.setPrototypeOf no equivale a asignar un valor a la propiedad .prototype de una función.
proto debe ser un objeto o null; cualquier otro valor provoca un TypeError. Pasar null o undefined como obj también provoca un TypeError. Los demás valores primitivos se devuelven sin cambios, pero solo después de validar proto. Si se trata de un objeto, una llamada correcta devuelve exactamente obj.
Al cambiar el prototipo de un objeto ordinario, si se detecta un ciclo, se produce un TypeError. Sin embargo, la comprobación se detiene en un prototipo que no usa la implementación ordinaria del método interno [[GetPrototypeOf]], como un Proxy. Por tanto, un ciclo que pasa por ese Proxy puede quedar sin detectar y no provocar un TypeError. Intentar cambiar el prototipo de un objeto ordinario no extensible provoca un TypeError. En un objeto ordinario se puede volver a establecer su prototipo actual aunque el objeto no sea extensible. En cambio, si un Proxy tiene un objeto objetivo no extensible, su trampa setPrototypeOf puede rechazar la operación aunque el prototipo solicitado sea el prototipo actual del objetivo. Si la trampa devuelve false, Object.setPrototypeOf lanza un TypeError. Algunos objetos, incluido Object.prototype, tienen un prototipo inmutable.
Cuando el prototipo de un objeto cambia a null, se rompe la cadena de herencia anterior; el objeto puede perder entonces el acceso a métodos heredados. Si conoces el prototipo al crear el objeto, considera usar Object.create(proto) en vez de cambiarlo más tarde. En el ejemplo, role se hereda y name sigue siendo una propiedad propia.
Ejemplos
const proto = { role: "reader" };
const user = { name: "Ada" };
const result = Object.setPrototypeOf(user, proto);
console.log(result === user);
console.log(Object.getPrototypeOf(user) === proto);
console.log(user.role);
console.log(Object.getOwnPropertyNames(user).join(","));
Object.setPrototypeOf(user, null);
console.log(user.role === undefined);Resultado
true true reader name 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.