Reflect.deleteProperty()

Статический метод Reflect.deleteProperty() похож на оператор delete, но представлен в виде функции. Он удаляет свойство из объекта.

Попробовать

const object = {
  foo: 42,
};

Reflect.deleteProperty(object, "foo");

console.log(object.foo);
// Expected output: undefined

const array = [1, 2, 3, 4, 5];
Reflect.deleteProperty(array, "3");

console.log(array);
// Expected output: Array [1, 2, 3, <1 empty slot>, 5]

Синтаксис

Reflect.deleteProperty(target, propertyKey)

Параметры

target

Целевой объект, из которого нужно удалить свойство.

propertyKey

Имя удаляемого свойства.

Возвращаемое значение

Логическое значение, указывающее, было ли свойство успешно удалено.

Исключения

TypeError

Вызывается, если target не является объектом.

Описание

Reflect.deleteProperty() обеспечивает рефлексивную семантику оператора delete. То есть Reflect.deleteProperty(target, propertyKey) семантически эквивалентен следующему:

delete target.propertyKey;

На очень низком уровне удаление свойства возвращает логическое значение (как в случае с обработчиком прокси). Reflect.deleteProperty() напрямую возвращает статус, в то время как delete вызовет TypeError в строгом режиме, если статус равен false. В нестрогом режиме delete и Reflect.deleteProperty() имеют одинаковое поведение.

Reflect.deleteProperty() вызывает внутренний метод объекта [[Delete]] для target.

Примеры

Использование Reflect.deleteProperty()

const obj = { x: 1, y: 2 };
Reflect.deleteProperty(obj, "x"); // true
console.log(obj); // { y: 2 }

const arr = [1, 2, 3, 4, 5];
Reflect.deleteProperty(arr, "3"); // true
console.log(arr); // [1, 2, 3, <1 empty slot>, 5]

// Returns true if no such property exists
Reflect.deleteProperty({}, "foo"); // true

// Returns false if a property is unconfigurable
Reflect.deleteProperty(Object.freeze({ foo: 1 }), "foo"); // false

Спецификации

Совместимость с браузерами

См. также

• Полифил Reflect.deleteProperty в core-js
• Reflect
• delete
• handler.deleteProperty()