CKTIS / JavaScript
Reflect.get — odczyt właściwości z opcjonalnym receiver
`Reflect.get` odczytuje właściwość obiektu, także odziedziczoną. Przy zwykłym wyszukiwaniu `receiver` jest przekazywany getterowi jako argument `this`, ale nie zmienia miejsca rozpoczęcia wyszukiwania.
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, propertyKey[, receiver])Reflect.get(target, propertyKey[, receiver]) wykonuje wewnętrzną operację odczytu [[Get]]. Dla zwykłego obiektu szuka właściwości w target, a następnie w łańcuchu prototypów. Brak właściwości daje undefined; właściwość akcesorowa bez gettera również daje undefined.
Jeśli pominięto receiver, przyjmuje on wartość target. Przy zwykłym wyszukiwaniu właściwości receiver jest przekazywany jako argument this przy wywołaniu gettera, także odziedziczonego. Nie musi to być jednak wartość this wewnątrz gettera. Getter będący funkcją z dowiązanym this przekazuje funkcji bazowej dowiązaną wartość zamiast argumentu this podanego przy wywołaniu gettera. Funkcja strzałkowa użyta jako getter ignoruje argument this i korzysta z leksykalnego this, nawet jeśli zdefiniowano ją poza trybem ścisłym. W funkcji działającej poza trybem ścisłym, w której this nie jest wiązane leksykalnie, argument this o wartości null lub undefined jest zastępowany globalną wartością this właściwą dla tej funkcji, a inne wartości pierwotne są opakowywane w obiekty. receiver nie zastępuje target jako początku wyszukiwania. Przy odczycie zwykłej właściwości danych zwracana jest znaleziona wartość, a nie właściwość z receiver.
target musi być obiektem: wartość pierwotna, null lub undefined powoduje TypeError, zamiast automatycznego opakowania wartości pierwotnej. propertyKey jest przekształcany do klucza będącego tekstem lub symbolem. Odczyt może uruchomić kod gettera lub pułapkę get obiektu Proxy; wyjątki nie są przechwytywane przez Reflect.get.
Używaj tej metody, gdy potrzebujesz jawnie sterować odbiorcą gettera. Sam odczyt nie jest testem istnienia właściwości: wynik undefined może oznaczać zarówno brak właściwości, jak i jej obecną wartość.
Przykłady
const prototype = {
get greeting() {
return `Hello, ${this.name}`;
}
};
const target = Object.create(prototype);
target.name = "Ada";
const receiver = { name: "Lin" };
console.log(Reflect.get(target, "greeting"));
console.log(Reflect.get(target, "greeting", receiver));
console.log(Reflect.get(target, "name", receiver));
console.log(Reflect.get(target, "missing"));Wynik
Hello, Ada Hello, Lin Ada undefined
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.