CKTIS / JavaScript
Operador in — verificar a existência de propriedades
O operador `in` verifica a presença de uma propriedade pela chave, não pelo valor. Se o objeto e os da sua cadeia de protótipos forem ordinários, tem em conta tanto as propriedades próprias como as herdadas. A armadilha `has` de um `Proxy` pode alterar o resultado. O operando da direita tem de ser um objeto; um valor primitivo provoca um `TypeError`.
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
propertyKey in object
#privateName in objectSe o objeto e todos os objetos da sua cadeia de protótipos forem ordinários, propertyKey in object devolve true para uma propriedade própria ou herdada e false caso contrário. O operando da esquerda é convertido numa chave de propriedade: uma cadeia de caracteres ou um Symbol. O operando da direita tem de ser um objeto; null, undefined e as cadeias primitivas também provocam um TypeError.
A armadilha has de um Proxy pode intercetar a verificação da chave, mesmo durante a pesquisa na cadeia de protótipos. Por exemplo, pode indicar que uma chave está presente quando não existe no objeto-alvo nem nos seus protótipos, ou ocultar uma propriedade própria configurável que exista num objeto-alvo extensível.
A existência não significa que o valor seja diferente de undefined: uma propriedade com esse valor continua a existir. Para verificar apenas propriedades próprias, usa Object.hasOwn(object, propertyKey). O operador in também inclui propriedades não enumeráveis; não é um ciclo for...in.
Em arrays, in verifica chaves de índice, não a presença de um valor. Uma lacuna deixada por delete não é um elemento próprio, mesmo que o seu índice seja inferior a length. Se nenhum Proxy intercetar a verificação e a pesquisa também não encontrar a chave na cadeia de protótipos, o resultado é false.
A sintaxe distinta #privateName in object verifica a presença de um elemento privado específico, não de uma propriedade com uma chave de texto. O nome privado tem de ser declarado no âmbito de uma classe que englobe a expressão; o operando da direita continua a ter de ser um objeto.
Exemplos
const parent = { inherited: 42 };
const item = Object.create(parent);
item.own = undefined;
console.log("own" in item);
console.log("inherited" in item);
console.log("missing" in item);
console.log(Object.hasOwn(item, "inherited"));
const values = [undefined];
console.log(0 in values);
delete values[0];
console.log(0 in values);Resultado
true true false false 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.