База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Reflect.deleteProperty — изтриване на свойства с булев резултат

Reflect.deleteProperty(target, propertyKey) се опитва да изтрие собствено свойство на обект и връща булев резултат. При обикновен обект връща true дори ако свойството липсва, и false, ако има configurable: false.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

Reflect.deleteProperty(target, propertyKey)

Reflect.deleteProperty(target, propertyKey) извиква вътрешната операция [[Delete]] на обекта. target трябва да е обект; примитивна стойност, включително null, причинява TypeError. propertyKey се преобразува в ключ на свойство: низ или Symbol.

При обикновен обект методът премахва собствено свойство, ако атрибутът му configurable е true. Тогава връща true; връща true и когато няма собствено свойство. Свойство с configurable: false остава непроменено и резултатът е false. Методът не изтрива свойства от прототипа: изтриването на собствено свойство може да разкрие наследено свойство със същия ключ.

За разлика от delete target[propertyKey] в строг режим, методът връща false, вместо да хвърля изключение само защото изтриването е отказано. Това не означава, че никога не хвърля изключения: те могат да възникнат при преобразуване на ключа или заради Proxy, чийто trap deleteProperty може да прихване операцията и е подчинен на инвариантите на спецификацията.

Примерът показва изтриване, липсващо свойство и отказано изтриване в строг режим. Това е функция на стандартната библиотека на ECMAScript, а не Web API. Самата спецификация не доказва поддръжка в конкретна версия на браузър; наличието на Node 24 в хранилище също не я доказва.

Примери

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

Резултат

true
true
false
false
2

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници