CKTIS / JavaScript
Reflect — jawne operacje na obiektach
Reflect udostępnia statyczne metody do odczytu, zapisu i introspekcji obiektów. Wynik logiczny operacji zapisu pozwala sprawdzić jej powodzenie, ale nie oznacza, że metoda nigdy nie rzuca wyjątku.
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
Reflect.get(target, key[, receiver])
Reflect.set(target, key, value[, receiver])
Reflect.defineProperty(target, key, descriptor)
Reflect.ownKeys(target)Reflect jest wbudowanym obiektem ECMAScript, nie funkcją ani konstruktorem: Reflect() i new Reflect() rzucają TypeError. Jego metody udostępniają operacje odpowiadające wewnętrznym mechanizmom obiektów.
Reflect.get odczytuje właściwość, a Reflect.set próbuje ją zapisać i zwraca wynik logiczny, nie przypisywaną wartość. Opcjonalny receiver w obu metodach domyślnie jest równy target i określa this podczas wywoływania getterów lub setterów. Reflect.ownKeys zwraca wszystkie własne klucze tekstowe i symbolowe, także nieenumerowalne; pomija odziedziczone.
Reflect.defineProperty zwraca false, gdy obiekt odrzuca poprawny deskryptor, podczas gdy Object.defineProperty w takiej sytuacji rzuca wyjątek. Wynik logiczny nie gwarantuje braku wyjątków: niepoprawne argumenty oraz kod getterów, setterów lub pułapek Proxy mogą je powodować. Metody operujące na właściwościach wymagają obiektu jako target.
W przykładzie właściwość jest nieenumerowalna i niezapisywalna. Reflect.set zwraca false również w trybie ścisłym, wartość pozostaje równa 10, a Reflect.ownKeys nadal znajduje klucz.
Przykłady
"use strict";
const target = {};
Reflect.defineProperty(target, "score", {
value: 10,
writable: false,
enumerable: false,
configurable: false
});
console.log(Reflect.get(target, "score"));
console.log(Reflect.set(target, "score", 20));
console.log(Reflect.ownKeys(target).join(","));
console.log(Reflect.get(target, "score"));Wynik
10 false score 10
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.