Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Reflect.deleteProperty — usuwanie właściwości z wynikiem logicznym

Reflect.deleteProperty(target, propertyKey) próbuje usunąć własną właściwość obiektu i zwraca wynik logiczny. Dla zwykłego obiektu zwraca true także wtedy, gdy właściwość nie istnieje, a false, gdy ma ona configurable: false.

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.deleteProperty(target, propertyKey)

Reflect.deleteProperty(target, propertyKey) wywołuje wewnętrzną operację [[Delete]] obiektu. target musi być obiektem; wartość pierwotna, w tym null, powoduje TypeError. propertyKey jest przekształcany w klucz właściwości: ciąg znaków albo Symbol.

Dla zwykłego obiektu metoda usuwa własną właściwość, jeśli jej atrybut configurable ma wartość true. Zwraca wtedy true; zwraca też true, jeśli własna właściwość nie istnieje. Właściwość z configurable: false pozostaje bez zmian, a wynikiem jest false. Metoda nie usuwa właściwości prototypu: usunięcie własnej właściwości może odsłonić odziedziczoną właściwość o tym samym kluczu.

W przeciwieństwie do delete target[propertyKey] w trybie ścisłym, metoda zwraca false, zamiast zgłaszać wyjątek wyłącznie z powodu odmowy usunięcia. Nie oznacza to, że nigdy nie zgłasza wyjątków: mogą one pochodzić z przekształcania klucza lub działania Proxy, którego pułapka deleteProperty może przechwycić operację i podlega ograniczeniom specyfikacji.

Przykład pokazuje usunięcie, brak właściwości i odmowę usunięcia w trybie ścisłym. Jest to funkcja standardowej biblioteki ECMAScript, nie interfejs Web API. Sama specyfikacja nie potwierdza obsługi w konkretnej wersji przeglądarki; obecność Node 24 w repozytorium również jej nie dowodzi.

Przykłady

"use strict";
const item = { temporary: 1 };
Object.defineProperty(item, "fixed", {
  value: 2,
  configurable: false
});

console.log(Reflect.deleteProperty(item, "temporary"));
console.log(Reflect.deleteProperty(item, "missing"));
console.log(Reflect.deleteProperty(item, "fixed"));
console.log(Object.prototype.hasOwnProperty.call(item, "temporary"));
console.log(item.fixed);

Wynik

true
true
false
false
2

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

Źródła