База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Object.values — стойности на собствените свойства на обект

Object.values(obj) връща нов масив със стойностите на собствените изброими свойства с ключове низове. Изключва наследените и неизброимите свойства, както и ключовете Symbol.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

Object.values(obj)

Object.values(obj) е статичен метод: извикайте го върху Object, а не върху обекта, който разглеждате. Той връща нов масив, съдържащ само стойностите на собствените изброими свойства с ключове низове. Не връща ключове или двойки ключ–стойност. Наследените свойства, неизброимите свойства и свойствата с ключове Symbol се изключват.

При обикновените обекти ключовете, които са индекси на масив, се обработват първо във възходящ числов ред; останалите ключове низове следват реда, в който са създадени свойствата. Това не е сортиране на стойностите или азбучно сортиране на ключовете. В примера ключът 2 е преди 10, а и двата са преди label.

Аргументът се преобразува в обект. null и undefined предизвикват TypeError; низът предоставя изброими индексирани свойства, затова Object.values("abc") дава ["a","b","c"]. Обикновените примитивни числови и булеви стойности нямат собствени изброими свойства и затова дават [].

Нов масив не означава дълбоко копие: стойностите, които са обекти, остават препратки към същите обекти. Четенето на стойностите извиква гетъри, които могат да имат странични ефекти или да хвърлят изключения. Самият метод не записва в свойствата на изходния обект, но кодът, изпълнен по време на четенето, може да ги промени.

Примери

const record = Object.create({ inherited: "ignored" });
record.label = "item";
record[10] = "ten";
record[2] = "two";
Object.defineProperty(record, "hidden", { value: "ignored" });
record[Symbol("secret")] = "ignored";

console.log(JSON.stringify(Object.values(record)));

Резултат

["two","ten","item"]

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници