This page was translated from English by the community.Learn more and join the MDN Web Docs community.
Object.values()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since март 2017 г..
МетодObject.values() возвращает массив значений перечисляемых свойств объекта в том же порядке что и циклfor...in. Разница между циклом и методом в том, что цикл перечисляет свойства и из цепочки прототипов.
Интерактивный пример
const object1 = { a: "somestring", b: 42, c: false,};console.log(Object.values(object1));// Expected output: Array ["somestring", 42, false]Синтаксис
Object.values(obj)
Параметры
objОбъект, чьи значения перечисляемых свойств будут возвращены.
Возвращаемое значение
Массив содержащий значения перечисляемых свойств объекта.
Описание
Object.values() возвращает массив, чьи элементы это значения перечисляемых свойств найденных в объекте. Порядок такой же как если пройтись по объекту циклом вручную.
Примеры
var obj = { foo: "bar", baz: 42 };console.log(Object.values(obj)); // ['bar', 42]// Массив как объектvar obj = { 0: "a", 1: "b", 2: "c" };console.log(Object.values(obj)); // ['a', 'b', 'c']// Массив как объект со случайным порядком ключей// Когда мы используем нумерованные ключ, значения возвращаются в порядке возрастанияvar an_obj = { 100: "a", 2: "b", 7: "c" };console.log(Object.values(an_obj)); // ['b', 'c', 'a']// getFoo неперечисляемое свойствоvar my_obj = Object.create( {}, { getFoo: { value: function () { return this.foo; }, }, },);my_obj.foo = "bar";console.log(Object.values(my_obj)); // ['bar']// Аргумент, не являющийся объектом, будет приведён к объектуconsole.log(Object.values("foo")); // ['f', 'o', 'o']Полифил
Для добавления совместимостиObject.values со старым окружением, которое не поддерживает нативно его, вы можете найти полифил здесьtc39/proposal-object-values-entries или вes-shims/Object.values репозитории.
Спецификации
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-object.values |