CKTIS / JavaScript
Object.values — wartości własnych właściwości obiektu
Object.values(obj) zwraca nową tablicę wartości własnych, wyliczalnych właściwości o kluczach tekstowych. Pomija właściwości odziedziczone, niewyliczalne oraz klucze typu Symbol.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
Object.values(obj)Object.values(obj) jest metodą statyczną: wywołujesz ją na Object, a nie na analizowanym obiekcie. Zwraca nową tablicę zawierającą wyłącznie wartości własnych, wyliczalnych właściwości o kluczach tekstowych. Nie zwraca kluczy ani par klucz–wartość. Pomija właściwości odziedziczone, niewyliczalne i właściwości z kluczami typu Symbol.
Dla zwykłych obiektów klucze będące indeksami tablicowymi są przetwarzane najpierw, rosnąco liczbowo; pozostałe klucze tekstowe — w kolejności utworzenia właściwości. Nie jest to sortowanie wartości ani alfabetyczne sortowanie kluczy. W przykładzie klucz 2 poprzedza 10, a oba poprzedzają label.
Argument jest konwertowany na obiekt. null i undefined powodują TypeError; tekst udostępnia wyliczalne właściwości indeksowe, więc Object.values("abc") daje ["a","b","c"]. Zwykłe wartości liczbowe i logiczne nie mają własnych wyliczalnych właściwości, więc dają [].
Nowa tablica nie oznacza głębokiej kopii: wartości będące obiektami pozostają referencjami do tych samych obiektów. Odczyt wartości uruchamia gettery, które mogą mieć skutki uboczne lub rzucać wyjątki. Sama metoda nie zapisuje właściwości źródła, ale kod uruchomiony podczas odczytu może je zmienić.
Przykłady
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)));Wynik
["two","ten","item"]
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.