Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Reflect.set — zapis właściwości z wynikiem logicznym

Reflect.set wykonuje operację przypisania właściwości i zwraca logiczną informację o jej powodzeniu. Opcjonalny receiver pozwala oddzielić obiekt, od którego zaczyna się wyszukiwanie właściwości, od odbiorcy zapisu.

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.set(target, key, value[, receiver])

Reflect.set(target, key, value[, receiver]) wywołuje wewnętrzną operację [[Set]] obiektu target. Argument key jest przekształcany w klucz właściwości: tekst lub symbol. Pominięty receiver domyślnie przyjmuje wartość target.

Wynikiem jest true albo false, a nie przypisywana wartość. Dla zwykłych obiektów false oznacza na przykład próbę zmiany właściwości z writable: false, użycia akcesora bez settera lub dodania właściwości do nierozszerzalnego odbiorcy. Sam wynik false nie powoduje wyjątku nawet w trybie ścisłym, w przeciwieństwie do odrzuconego przypisania target[key] = value w tym trybie.

Wyszukiwanie deskryptora zaczyna się od target i może przejść przez jego prototypy. Przy zapisywalnej właściwości danych zapis zwykle tworzy lub aktualizuje własną właściwość obiektu receiver, z uwzględnieniem jego ograniczeń. Przy wywołaniu settera receiver jest przekazywany jako argument this. Jeśli setter jest zwykłą funkcją JavaScript działającą poza trybem ścisłym, jego this przyjmuje globalną wartość this zamiast null lub undefined, a pozostałe wartości prymitywne są opakowywane w obiekty. Wynik zwracany przez setter jest ignorowany. Dlatego true nie gwarantuje, że późniejszy odczyt zwróci value.

Metoda nie jest mechanizmem przechwytywania błędów: nieobiektowy target powoduje TypeError, a wyjątki z konwersji klucza, settera lub pułapki Proxy są przekazywane dalej. Bezpośrednie definiowanie własnej właściwości nie przeszukuje łańcucha prototypów ani nie wywołuje odziedziczonych setterów, ale nadal podlega ograniczeniom deskryptora istniejącej właściwości własnej. Nie pozwala na przykład zmienić wartości własnej właściwości danych, która jest jednocześnie niekonfigurowalna i niezapisywalna.

Przykłady

"use strict";
const target = { score: 1 };
const receiver = {};
console.log(Reflect.set(target, "score", 7, receiver));
console.log(target.score, receiver.score);

Object.defineProperty(target, "fixed", {
  value: 10,
  writable: false
});
console.log(Reflect.set(target, "fixed", 20));
console.log(target.fixed);

Wynik

true
1 7
false
10

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła