Esta página ha sido traducida del inglés por la comunidad.Aprende más y únete a la comunidad de MDN Web Docs.
Object.setPrototypeOf()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since septiembre de 2015.
El métodoObject.setPrototypeOf() establece el prototipo (p.e., la propiedad interna[[Prototype]]) de un objeto especificado a otro objeto o sino establecenull.
Advertencia:Adverdencia: Cambiar la propiedad[[Prototype]] de un objeto, debido a la naturaleza de la optimización del acceso a propiedades de los motores modernos de JavaScript, es una operación bastante lenta, en todotodo navegador y motor de JavaScript. Los efectos sobre el rendimiento al alterar la herencia son sutiles y vastos., y no están limitados a simplemente el tiempo gastado en la sentenciaobj.__proto___ = ..., but may extend toany code that has access toany object whose[[Prototype]] has been altered. If you care about performance you should avoid setting the[[Prototype]] of an object. Instead, create a new object with the desired[[Prototype]] usingObject.create().
Sintaxis
Object.setPrototypeOf(obj, prototype);
Parámetros
Descripción
Arroja una excepción del tipoTypeError si el objeto cuyo[[Prototype]] se va a modificar no es extensible de acuerdo conObject.isExtensible(). No hace nada si el parametroprototype no es un objeto onull (p.e., número, cadena, booleano, oundefined). De cualquier otra forma, este método cambia la propiedad[[Prototype]] delobj al valor nuevo.
Object.setPrototypeOf() está en el último borrador del estandar ECMAScript6. Es considerado generalmente la manera adecuada de establecer el prototipo de un objeto, contra la propiedad más controversialObject.prototype.__proto__.
Ejemplos
var dict = Object.setPrototypeOf({}, null);Polyfill
Utilizando la vieja propiedadObject.prototype.__proto__, podemos definir facilmenteObject.setPrototypeOf si aún no está disponible:
// Solo funciona en Chrome y FirefoxOnly works in Chrome y FireFox, no funciona en IE:Object.setPrototypeOf = Object.setPrototypeOf || function (obj, proto) { obj.__proto__ = proto; return obj; };Agregando cadenas de prototipo
Una combinación deObject.getPrototypeOf() yObject.prototype.__proto__ permite agregar una nueva cadena de prototipos al nuevo prototipo del objeto.
/** *** Object.appendChain(@object, @prototype) * * Agrega el primer prototipo no-nativo de una cadena a un nuevo prototipo. * Retorna @object (si es Primitivo (Primitive value) será transoformado a Objeto). * *** Object.appendChain(@object [, "@arg_name_1", "@arg_name_2", "@arg_name_3", "..."], "@function_body") *** Object.appendChain(@object [, "@arg_name_1, @arg_name_2, @arg_name_3, ..."], "@function_body") * * Agrega el primer prototipo no-nativo de una cadena a la Function.prototype nativa del objeto, luego agrega una * ueva Function(["@arg"(s)], "@function_body") a la cadena. * Retorna la función. * **/Object.appendChain = function (oChain, oProto) { if (arguments.length < 2) { throw new TypeError("Object.appendChain - Not enough arguments"); } if (typeof oProto === "number" || typeof oProto === "boolean") { throw new TypeError( "second argument to Object.appendChain must be an object or a string", ); } var oNewProto = oProto, oReturn = (o2nd = oLast = oChain instanceof this ? oChain : new oChain.constructor(oChain)); for ( var o1st = this.getPrototypeOf(o2nd); o1st !== Object.prototype && o1st !== Function.prototype; o1st = this.getPrototypeOf(o2nd) ) { o2nd = o1st; } if (oProto.constructor === String) { oNewProto = Function.prototype; oReturn = Function.apply(null, Array.prototype.slice.call(arguments, 1)); this.setPrototypeOf(oReturn, oLast); } this.setPrototypeOf(o2nd, oNewProto); return oReturn;};Uso
Primer ejemplo: Agregar una cadena a un prototipo
function Mammal() { this.isMammal = "yes";}function MammalSpecies(sMammalSpecies) { this.species = sMammalSpecies;}MammalSpecies.prototype = new Mammal();MammalSpecies.prototype.constructor = MammalSpecies;var oCat = new MammalSpecies("Felis");console.log(oCat.isMammal); // 'yes'function Animal() { this.breathing = "yes";}Object.appendChain(oCat, new Animal());console.log(oCat.breathing); // 'yes'Segundo ejemplo: Transformando un valor Primitivo en una instancia de su constructor y agregar su cadena al prototipo
function Symbol() { this.isSymbol = "yes";}var nPrime = 17;console.log(typeof nPrime); // 'number'var oPrime = Object.appendChain(nPrime, new Symbol());console.log(oPrime); // '17'console.log(oPrime.isSymbol); // 'yes'console.log(typeof oPrime); // 'object'Tercer ejemplo: Agregando una cadena a la Function.prototype de un objeto y agregando una nueva función a la cadena
function Person(sName) { this.identity = sName;}var george = Object.appendChain( new Person("George"), 'console.log("Hello guys!!");',);console.log(george.identity); // 'George'george(); // 'Hello guys!!'Especificaciones
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-object.setprototypeof |