--- title: Object.getOwnPropertyNames() slug: Web/JavaScript/Reference/Global_Objects/Object/getOwnPropertyNames tags: - ECMAScript5 - JavaScript - Об'єкт - метод translation_of: Web/JavaScript/Reference/Global_Objects/Object/getOwnPropertyNames ---
{{JSRef}}

Метод Object.getOwnPropertyNames() повертає масив усіх властивостей (в тому числі неперелічуваних, за винятком властивостей, що використовують символ), знайдених безпосередньо на наданому об'єкті.

{{EmbedInteractiveExample("pages/js/object-getownpropertynames.html")}}

Синтаксис

Object.getOwnPropertyNames(obj)

Параметри

obj
Об'єкт, чиї перелічувані та неперелічувані властивості будуть повернені.

Значення, що повертається

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

Опис

Object.getOwnPropertyNames() повертає масив, чиї елементи є рядками, що відповідають перелічуваним та неперелічуваним властивостям, знайденим безпосередньо на наданому об'єкті obj. Порядок перелічуваних властивостей у масиві відповідає порядку, в якому видає властивості об'єкта цикл {{jsxref("Statements/for...in", "for...in")}} (або метод {{jsxref("Object.keys()")}}). Порядок неперелічуваних властивостей у масиві, а також порядок посеред перелічуваних властивостей, не визначені.

Приклади

Використання Object.getOwnPropertyNames()

var arr = ['а', 'б', 'в'];
console.log(Object.getOwnPropertyNames(arr).sort());
// виведе ["0", "1", "2", "length"]

// подібний до масиву об'єкт
var obj = { 0: 'а', 1: 'б', 2: 'в' };
console.log(Object.getOwnPropertyNames(obj).sort());
// виведе ["0", "1", "2"]

// Виведення імен та значень властивостей через Array.forEach
Object.getOwnPropertyNames(obj).forEach(
  function (val, idx, array) {
    console.log(val + ' -> ' + obj[val]);
  }
);
// виведе
// 0 -> а
// 1 -> б
// 2 -> в

// неперелічувана властивість
var my_obj = Object.create({}, {
  getFoo: {
    value: function() { return this.foo; },
    enumerable: false
  }
});
my_obj.foo = 1;

console.log(Object.getOwnPropertyNames(my_obj).sort());
// виведе ["foo", "getFoo"]

Якщо вам потрібні тільки перелічувані властивості, дивіться {{jsxref("Object.keys()")}} або скористайтесь циклом {{jsxref("Statements/for...in", "for...in")}} (зауважте, що це також поверне перелічувані властивості, знайдені у ланцюжку прототипів об'єкта, якщо тільки вони не були відфільтровані методом {{jsxref("Object.prototype.hasOwnProperty()", "hasOwnProperty()")}}).

Елементи, знайдені у ланцюжку прототипів, не додаються у список:

function ParentClass() {}
ParentClass.prototype.inheritedMethod = function() {};

function ChildClass() {
  this.prop = 5;
  this.method = function() {};
}
ChildClass.prototype = new ParentClass;
ChildClass.prototype.prototypeMethod = function() {};

console.log(
  Object.getOwnPropertyNames(
    new ChildClass() // ["prop", "method"]
  )
);

Отримати лише неперелічувані властивості

Тут використовується функція {{jsxref("Array.prototype.filter()")}} для видалення перелічуваних ключів (отриманих методом {{jsxref("Object.keys()")}}) зі списка усіх ключів (отриманих методом Object.getOwnPropertyNames()), таким чином, повертаючи тільки неперелічувані ключі.

var target = myObject;
var enum_and_nonenum = Object.getOwnPropertyNames(target);
var enum_only = Object.keys(target);
var nonenum_only = enum_and_nonenum.filter(function(key) {
  var indexInEnum = enum_only.indexOf(key);
  if (indexInEnum == -1) {
    // Ключ не знайдений у ключах enum_only,
    // це означає, що він є неперелічуваним,
    // тому повертаємо true, щоб залишити його у фільтрі
    return true;
  } else {
    return false;
  }
});

console.log(nonenum_only);

Примітки

У ES5, якщо аргумент цього методу не є об'єктом (примітив), це спричинить помилку {{jsxref("TypeError")}}. У ES2015 аргумент, що не є об'єктом, буде приведений до об'єкта.

Object.getOwnPropertyNames('foo');
// TypeError: "foo" is not an object (код ES5)

Object.getOwnPropertyNames('foo');
// ["0", "1", "2", "length"]  (код ES2015)

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

Специфікація Статус Коментар
{{SpecName('ESDraft', '#sec-object.getownpropertynames', 'Object.getOwnPropertyNames')}} {{Spec2('ESDraft')}}
{{SpecName('ES6', '#sec-object.getownpropertynames', 'Object.getOwnPropertyNames')}} {{Spec2('ES6')}}
{{SpecName('ES5.1', '#sec-15.2.3.4', 'Object.getOwnPropertyNames')}} {{Spec2('ES5.1')}} Початкове визначення. Реалізоване у JavaScript 1.8.5.

Сумісність з веб-переглядачами

{{Compat("javascript.builtins.Object.getOwnPropertyNames")}}

Примітки щодо Firefox

До Firefox 28 метод Object.getOwnPropertyNames не бачив невирішених властивостей об'єктів {{jsxref("Error")}}. Це було виправлено у пізніших версіях ({{bug("724768")}}).

Див. також