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.