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

CKTIS / JavaScript

El operador instanceof

Si el operando derecho es una función ordinaria no vinculada, el operador instanceof comprueba de forma predeterminada si su `prototype` aparece en la cadena de prototipos de un objeto. Tiene en cuenta la herencia, pero no demuestra cómo se creó el objeto ni que existan determinados campos.

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

value instanceof Target

value instanceof Target devuelve un valor booleano o lanza una excepción. En la prueba predeterminada, si value es un objeto y Target es una función ordinaria no vinculada, el operador busca el objeto Target.prototype en la cadena de prototipos de value, comparando la identidad de los objetos. Por eso, una instancia de una clase derivada también es una instancia de su clase base. Si Target es una función vinculada (por ejemplo, creada con bind), el mecanismo integrado repite la prueba instanceof con la función subyacente en lugar de leer Target.prototype. Para ello no hace falta un método Symbol.hasInstance personalizado. instanceof es una palabra reservada.

La prueba no inspecciona la propiedad constructor ni el historial de llamadas a new. Un objeto creado con Object.create(Target.prototype) puede superar la prueba sin ejecutar el constructor. Cambiar los prototipos puede cambiar el resultado; distintos realms, como los frames, pueden tener objetos prototipo diferentes.

Target[Symbol.hasInstance] puede personalizar la prueba; su resultado se convierte en un valor booleano. Sin una gestión personalizada, los valores primitivos a la izquierda producen false. Un valor primitivo a la derecha provoca un TypeError; si no hay un método adecuado, la expresión de la derecha debe ser invocable. Si la prueba predeterminada de objetos lee Target.prototype y ese valor no es un objeto, lanza un TypeError.

Escribe la negación como !(value instanceof Target), no como !value instanceof Target: esta última expresión comprueba !value. No consideres el resultado una prueba de que existan campos o de que los datos sean válidos.

Ejemplos

class Animal {}
class Dog extends Animal {}

const dog = new Dog();
const linked = Object.create(Dog.prototype);

console.log(dog instanceof Dog);
console.log(dog instanceof Animal);
console.log(linked instanceof Dog);
console.log("dog" instanceof String);

Resultado

true
true
true
false

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