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étodo Object.setPrototypeOf() establece el prototipo (p.e., la propiedad interna [[Prototype]]) de un objeto especificado a otro objeto o sino establece null.
Advertencia:
Cambiar la propiedad [[Prototype]] de un objeto es actualmente una operación muy lenta en todos los navegadores y motores de JavaScript, debido a la forma en que los motores modernos de JavaScript optimizan el acceso a las propiedades. Además, los efectos de alterar la herencia son sutiles y de amplio alcance, y no se limitan al tiempo empleado en la sentencia Object.setPrototypeOf(...), sino que pueden extenderse a cualquier código que tenga acceso a un objeto cuyo [[Prototype]] haya sido modificado. Puedes leer más sobre esto en Fundamentos de los motores de JavaScript: optimización de prototipos.
Dado que esta característica forma parte del lenguaje, corresponde a los desarrolladores de motores implementarla de forma eficiente. Hasta que eso ocurra, si te preocupa el rendimiento, evita establecer el [[Prototype]] de un objeto. En su lugar, crea un nuevo objeto con el [[Prototype]] deseado usando Object.create().
Sintaxis
Object.setPrototypeOf(obj, prototype);
Parámetros
Descripción
Arroja una excepción del tipo TypeError si el objeto cuyo [[Prototype]] se va a modificar no es extensible de acuerdo con Object.isExtensible(). No hace nada si el parametro prototype no es un objeto o null (p.e., número, cadena, booleano, o undefined). De cualquier otra forma, este método cambia la propiedad [[Prototype]] del obj 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 controversial Object.prototype.__proto__.
Ejemplos
var dict = Object.setPrototypeOf({}, null);
Polyfill
Utilizando la vieja propiedad Object.prototype.__proto__, podemos definir facilmente Object.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 de Object.getPrototypeOf() y Object.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® 2027 Language Specification # sec-object.setprototypeof |