Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

Reflect.deleteProperty — mazání vlastností s logickým výsledkem

Reflect.deleteProperty(target, propertyKey) se pokusí odstranit vlastní vlastnost objektu a vrátí logickou hodnotu. U běžného objektu vrátí true i tehdy, když vlastnost neexistuje, a false, pokud má configurable: false.

Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

Reflect.deleteProperty(target, propertyKey)

Reflect.deleteProperty(target, propertyKey) volá interní operaci objektu [[Delete]]. target musí být objekt; primitivní hodnota včetně null způsobí TypeError. propertyKey se převede na klíč vlastnosti: řetězec nebo Symbol.

U běžného objektu metoda odstraní vlastní vlastnost, pokud má její atribut configurable hodnotu true. Poté vrátí true; true vrátí také tehdy, když žádná vlastní vlastnost neexistuje. Vlastnost s configurable: false zůstane beze změny a výsledkem je false. Metoda neodstraňuje vlastnosti z prototypu: odstraněním vlastní vlastnosti se může zpřístupnit zděděná vlastnost se stejným klíčem.

Na rozdíl od delete target[propertyKey] ve strict mode metoda vrátí false, místo aby pouze kvůli odmítnutí odstranění vyvolala výjimku. To neznamená, že výjimky nikdy nevyvolá: mohou vzniknout při převodu klíče nebo kvůli Proxy, jehož past deleteProperty může operaci zachytit a podléhá invariantům specifikace.

Příklad ukazuje odstranění vlastnosti, chybějící vlastnost a odmítnuté odstranění ve strict mode. Jde o funkci standardní knihovny ECMAScript, nikoli o Web API. Samotná specifikace nedokládá podporu v konkrétní verzi prohlížeče; nedokládá ji ani přítomnost Node 24 v repozitáři.

Příklady

"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);

Výsledek

true
true
false
false
2

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje