in operator

Оператор in повертає true, якщо властивість присутня у вказаному об'єкті.

Синтаксис

prop in objectName

Параметри

prop

Рядок або символ, що є іменем властивості або індексом масиву (не-символи будуть приведені до рядка).

objectName

Ім'я об'єкта.

Опис

Приклад, наведений нижче, ілюструє деякі випадки використання in оператора.

// Arrays
var trees = ['redwood', 'bay', 'cedar', 'oak', 'maple'];
0 in trees        // returns true
3 in trees        // returns true
6 in trees        // returns false
'bay' in trees    // returns false (you must specify the 
                  // index number, not the value at that index)
'length' in trees // returns true (length is an Array property)
Symbol.iterator in trees // returns true (arrays are iterable, works only in ES2015+)

// Predefined objects
'PI' in Math          // returns true

// Custom objects
var mycar = {make: 'Honda', model: 'Accord', year: 1998};
'make' in mycar  // returns true
'model' in mycar // returns true

Необхідно вказати об'єкт зправа  від in оператора. Наприклад, можна вказати рядок, створений за допомогою String конструктора, але не можна вказувати рядок як літерал.

var color1 = new String('green');
'length' in color1 // returns true

var color2 = 'coral';
// generates an error (color2 is not a String object)
'length' in color2

Використання in з видаленими або undefined властивостями

Якщо видалити властивість використовуючи delete оператор,  in оператор поверне false для цієї властивості.

var mycar = {make: 'Honda', model: 'Accord', year: 1998};
delete mycar.make;
'make' in mycar;  // returns false

var trees = new Array('redwood', 'bay', 'cedar', 'oak', 'maple');
delete trees[3];
3 in trees; // returns false

Якщо задати властивість як undefinedале не видалити її,  in оператор поверне true для цієї властивості.

var mycar = {make: 'Honda', model: 'Accord', year: 1998};
mycar.make = undefined;
'make' in mycar;  // returns true

var trees = new Array('redwood', 'bay', 'cedar', 'oak', 'maple');
trees[3] = undefined;
3 in trees; // returns true

Успадковані властивості

Оператор in повертає true для властивостей з ланцюжка прототипів.

'toString' in {}; // returns true

Специфікації

Сумісність з браузерами

Також дивіться

• for...in
• delete
• Object.prototype.hasOwnProperty()
• Reflect.has()
• Enumerability and ownership of properties