Operador in

Testa a existência de uma propriedade em um objeto.

property in object

Argumentos

  • propriedade
    Obrigatório. Uma expressão que avalia uma seqüência de caracteres.

  • object
    Obrigatório. Qualquer objeto.

Comentários

O em operador verifica se um objeto tem uma propriedade chamada propriedade. Ele também verifica o protótipo do objeto para ver se propriedade é parte da cadeia de protótipos. Se propriedade está na cadeia de objeto ou o protótipo, o em operador retorna true, caso contrário retorna false.

O em operador não deve ser confundida com o para...na instrução.

ObservaçãoObservação

Para testar se o próprio objeto tem uma propriedade e não herda a propriedade de cadeia de protótipos, use o objeto hasOwnProperty método.

Exemplo

O exemplo a seguir ilustra um uso o em operador.

function cityName(key : String, cities : Object) : String {
   // Returns a city name associated with an index letter.
   var ret : String = "Key '" + key + "'";
   if( key in cities )
      return ret + " represents " + cities[key] + ".";
   else  // no city indexed by the key
      return ret + " does not represent a city."
}

// Make an object with city names and an index letter.
var cities : Object = {"a" : "Athens" , "b" : "Belgrade", "c" : "Cairo"}

// Look up cities with an index letter.
print(cityName("a",cities));
print(cityName("z",cities));

A saída desse código é:

Key 'a' represents Athens.
Key 'z' does not represent a city.

Requisitos

Versão 1

Consulte também

Referência

loop for... na instrução

Método de hasOwnProperty

Conceitos

Precedência de operador

Resumo do operador