CKTIS / JavaScript
O operador instanceof
Se o operando da direita for uma função comum não vinculada, o operador instanceof verifica, por predefinição, se o seu `prototype` aparece na cadeia de protótipos de um objeto. Tem em conta a herança, mas não prova como o objeto foi criado nem que determinados campos existem.
Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxe
value instanceof Targetvalue instanceof Target devolve um valor booleano ou lança uma exceção. No teste predefinido, se value for um objeto e Target for uma função comum não vinculada, o operador procura o objeto Target.prototype na cadeia de protótipos de value, comparando a identidade dos objetos. Assim, uma instância de uma classe derivada também é uma instância da respetiva classe base. Se Target for uma função vinculada (por exemplo, criada com bind), o mecanismo incorporado repete o teste instanceof com a função subjacente em vez de ler Target.prototype. Para isso, não é necessário um método Symbol.hasInstance personalizado. instanceof é uma palavra reservada.
O teste não inspeciona a propriedade constructor nem o histórico de chamadas a new. Um objeto criado com Object.create(Target.prototype) pode passar no teste sem que o construtor seja executado. Alterar os protótipos pode alterar o resultado; realms separados, como frames, podem ter objetos protótipo diferentes.
Target[Symbol.hasInstance] pode personalizar o teste; o resultado é convertido num valor booleano. Sem tratamento personalizado, os valores primitivos à esquerda produzem false. Um valor primitivo à direita provoca um TypeError; na ausência de um método adequado, o lado direito tem de ser invocável. Se o teste predefinido de objetos ler Target.prototype e esse valor não for um objeto, lança um TypeError.
Escreve a negação como !(value instanceof Target), e não como !value instanceof Target: esta última expressão testa !value. Não consideres o resultado uma prova de que existem campos ou de que os dados são válidos.
Exemplos
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
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.