ExpertiDict

JavaScript · Intermediário · Inglês · Técnico

instanceof

/ˈɪnstəns ʌv/operador

Operador que testa se o protótipo de um construtor aparece na cadeia de protótipos de um objeto. Devolve true ou false e pode ser personalizado com Symbol.hasInstance.

Onde usar

Usado para distinguir tipos de erro num catch e checar instâncias de classe. Em code review, atenção a objetos de outro iframe, para os quais instanceof Array falha; use Array.isArray.

Em código

class A {}
const a = new A();
console.log(a instanceof A);      // true
console.log(a instanceof Object); // true
console.log('x' instanceof String); // false

Exemplos

Check the error with instanceof before reading its fields.

Cheque o erro com instanceof antes de ler seus campos.

A plain string is not an instanceof String.

Uma string comum não é instanceof String.

Cuidado

Usar instanceof com primitivos: 'a' instanceof String dá false.

Veja também

Todos os termos de JavaScript