Delete Operator - JavaScript - MDN Web Docs - Mozilla

• Skip to main content
• Skip to search

delete Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨July 2015⁩.

• Learn more
• See full compatibility
• Report feedback

The delete operator removes a property from an object. If the property's value is an object and there are no more references to the object, the object held by that property is eventually released automatically.

In this article

• Try it
• Syntax
• Description
• Examples
• Specifications
• Browser compatibility
• See also

Try it

const employee = { firstName: "Maria", lastName: "Sanchez", }; console.log(employee.firstName); // Expected output: "Maria" delete employee.firstName; console.log(employee.firstName); // Expected output: undefined

Syntax

jsdelete object.property delete object[property]

Note: The syntax allows a wider range of expressions following the delete operator, but only the above forms lead to meaningful behaviors.

Parameters

object

The name of an object, or an expression evaluating to an object.

property

The property to delete.

Return value

true for all cases except when the property is an own non-configurable property, in which case false is returned in non-strict mode.

Exceptions

TypeError

Thrown in strict mode if the property is an own non-configurable property.

ReferenceError

Thrown if object is super.

Description

The delete operator has the same precedence as other unary operators like typeof. Therefore, it accepts any expression formed by higher-precedence operators. However, the following forms lead to early syntax errors in strict mode:

jsdelete identifier; delete object.#privateProperty;

Because classes are automatically in strict mode, and private elements can only be legally referenced in class bodies, this means private elements can never be deleted. While delete identifier may work if identifier refers to a configurable property of the global object, you should avoid this form and prefix it with globalThis instead.

While other expressions are accepted, they don't lead to meaningful behaviors:

jsdelete console.log(1); // Logs 1, returns true, but nothing deleted

The delete operator removes a given property from an object. On successful deletion, it will return true, else false will be returned. Unlike what common belief suggests (perhaps due to other programming languages like delete in C++), the delete operator has nothing to do with directly freeing memory. Memory management is done indirectly via breaking references. See the memory management page for more details.

It is important to consider the following scenarios:

• If the property which you are trying to delete does not exist, delete will not have any effect and will return true.
• delete only has an effect on own properties. If a property with the same name exists on the object's prototype chain, then after deletion, the object will use the property from the prototype chain.
• Non-configurable properties cannot be removed. This includes properties of built-in objects like Math, Array, Object and properties that are created as non-configurable with methods like Object.defineProperty().
• Deleting variables, including function parameters, never works. delete variable will throw a SyntaxError in strict mode, and will have no effect in non-strict mode.
  • Any variable declared with var cannot be deleted from the global scope or from a function's scope, because while they may be attached to the global object, they are not configurable.
  • Any variable declared with let or const cannot be deleted from the scope within which they were defined, because they are not attached to an object.

Examples

Using delete

Note: The following example uses non-strict-mode only features, like implicitly creating global variables and deleting identifiers, which are forbidden in strict mode.

js// Creates the property empCount on the global scope. // Since we are using var, this is marked as non-configurable. var empCount = 43; // Creates the property EmployeeDetails on the global scope. // Since it was defined without "var", it is marked configurable. EmployeeDetails = { name: "xyz", age: 5, designation: "Developer", }; // delete can be used to remove properties from objects. delete EmployeeDetails.name; // returns true // Even when the property does not exist, delete returns "true". delete EmployeeDetails.salary; // returns true // EmployeeDetails is a property of the global scope. delete EmployeeDetails; // returns true // On the contrary, empCount is not configurable // since var was used. delete empCount; // returns false // delete also does not affect built-in static properties // that are non-configurable. delete Math.PI; // returns false function f() { var z = 44; // delete doesn't affect local variable names delete z; // returns false }

delete and the prototype chain

In the following example, we delete an own property of an object while a property with the same name is available on the prototype chain:

jsfunction Foo() { this.bar = 10; } Foo.prototype.bar = 42; const foo = new Foo(); // foo.bar is associated with the // own property. console.log(foo.bar); // 10 // Delete the own property within the // foo object. delete foo.bar; // returns true // foo.bar is still available in the // prototype chain. console.log(foo.bar); // 42 // Delete the property on the prototype. delete Foo.prototype.bar; // returns true // The "bar" property can no longer be // inherited from Foo since it has been // deleted. console.log(foo.bar); // undefined

Deleting array elements

When you delete an array element, the array length is not affected. This holds even if you delete the last element of the array.

When the delete operator removes an array element, that element is no longer in the array. In the following example, trees[3] is removed with delete.

jsconst trees = ["redwood", "bay", "cedar", "oak", "maple"]; delete trees[3]; console.log(3 in trees); // false

This creates a sparse array with an empty slot. If you want an array element to exist but have an undefined value, use the undefined value instead of the delete operator. In the following example, trees[3] is assigned the value undefined, but the array element still exists:

jsconst trees = ["redwood", "bay", "cedar", "oak", "maple"]; trees[3] = undefined; console.log(3 in trees); // true

If instead, you want to remove an array element by changing the contents of the array, use the splice() method. In the following example, trees[3] is removed from the array completely using splice():

jsconst trees = ["redwood", "bay", "cedar", "oak", "maple"]; trees.splice(3, 1); console.log(trees); // ["redwood", "bay", "cedar", "maple"]

Deleting non-configurable properties

When a property is marked as non-configurable, delete won't have any effect, and will return false. In strict mode, this will raise a TypeError.

jsconst Employee = {}; Object.defineProperty(Employee, "name", { configurable: false }); console.log(delete Employee.name); // returns false

var creates non-configurable properties that cannot be deleted with the delete operator:

js// Since "nameOther" is added using with the // var keyword, it is marked as non-configurable var nameOther = "XYZ"; // We can access this global property using: Object.getOwnPropertyDescriptor(globalThis, "nameOther"); // { // value: "XYZ", // writable: true, // enumerable: true, // configurable: false // } delete globalThis.nameOther; // return false

In strict mode, this would raise an exception.

Deleting global properties

If a global property is configurable (for example, via direct property assignment), it can be deleted, and subsequent references to them as global variables will produce a ReferenceError.

jsglobalThis.globalVar = 1; console.log(globalVar); // 1 // In non-strict mode, you can use `delete globalVar` as well delete globalThis.globalVar; console.log(globalVar); // ReferenceError: globalVar is not defined

Specifications

Specification
ECMAScript® 2026 Language Specification# sec-delete-operator

Browser compatibility

See also

• Reflect.deleteProperty()
• Map.prototype.delete()

Help improve MDN

Was this page helpful to you? Yes No Learn how to contribute

This page was last modified on ⁨Jul 17, 2025⁩ by MDN contributors.

View this page on GitHub • Report a problem with this content Filter sidebar

1. JavaScript
2. Tutorials and guides
3. JavaScript Guide
   1. Introduction
   2. Grammar and types
   3. Control flow and error handling
   4. Loops and iteration
   5. Functions
   6. Expressions and operators
   7. Numbers and strings
   8. Representing dates & times
   9. Regular expressions
   10. Indexed collections
   11. Keyed collections
   12. Working with objects
   13. Using classes
   14. Using promises
   15. JavaScript typed arrays
   16. Iterators and generators
   17. Resource management
   18. Internationalization
   19. JavaScript modules
4. Intermediate
   1. Language overview
   2. JavaScript data structures
   3. Equality comparisons and sameness
   4. Enumerability and ownership of properties
   5. Closures
5. Advanced
   1. Inheritance and the prototype chain
   2. Meta programming
   3. Memory Management
6. References
7. Built-in objects
   1. AggregateError
   2. Array
   3. ArrayBuffer
   4. AsyncDisposableStack
   5. AsyncFunction
   6. AsyncGenerator
   7. AsyncGeneratorFunction
   8. AsyncIterator
   9. Atomics
   10. BigInt
   11. BigInt64Array
   12. BigUint64Array
   13. Boolean
   14. DataView
   15. Date
   16. decodeURI()
   17. decodeURIComponent()
   18. DisposableStack
   19. encodeURI()
   20. encodeURIComponent()
   21. Error
   22. escape() Deprecated
   23. eval()
   24. EvalError
   25. FinalizationRegistry
   26. Float16Array
   27. Float32Array
   28. Float64Array
   29. Function
   30. Generator
   31. GeneratorFunction
   32. globalThis
   33. Infinity
   34. Int8Array
   35. Int16Array
   36. Int32Array
   37. InternalError Non-standard
   38. Intl
   39. isFinite()
   40. isNaN()
   41. Iterator
   42. JSON
   43. Map
   44. Math
   45. NaN
   46. Number
   47. Object
   48. parseFloat()
   49. parseInt()
   50. Promise
   51. Proxy
   52. RangeError
   53. ReferenceError
   54. Reflect
   55. RegExp
   56. Set
   57. SharedArrayBuffer
   58. String
   59. SuppressedError
   60. Symbol
   61. SyntaxError
   62. Temporal
   63. TypedArray
   64. TypeError
   65. Uint8Array
   66. Uint8ClampedArray
   67. Uint16Array
   68. Uint32Array
   69. undefined
   70. unescape() Deprecated
   71. URIError
   72. WeakMap
   73. WeakRef
   74. WeakSet
8. Expressions & operators
   1. Addition (+)
   2. Addition assignment (+=)
   3. Assignment (=)
   4. async function expression
   5. async function* expression
   6. await
   7. Bitwise AND (&)
   8. Bitwise AND assignment (&=)
   9. Bitwise NOT (~)
   10. Bitwise OR (|)
   11. Bitwise OR assignment (|=)
   12. Bitwise XOR (^)
   13. Bitwise XOR assignment (^=)
   14. class expression
   15. Comma operator (,)
   16. Conditional (ternary) operator
   17. Decrement (--)
   18. delete
   19. Destructuring
   20. Division (/)
   21. Division assignment (/=)
   22. Equality (==)
   23. Exponentiation (**)
   24. Exponentiation assignment (**=)
   25. function expression
   26. function* expression
   27. Greater than (>)
   28. Greater than or equal (>=)
   29. Grouping operator ( )
   30. import.meta
       1. import.meta.resolve()
   31. import()
   32. in
   33. Increment (++)
   34. Inequality (!=)
   35. instanceof
   36. Left shift (<<)
   37. Left shift assignment (<<=)
   38. Less than (<)
   39. Less than or equal (<=)
   40. Logical AND (&&)
   41. Logical AND assignment (&&=)
   42. Logical NOT (!)
   43. Logical OR (||)
   44. Logical OR assignment (||=)
   45. Multiplication (*)
   46. Multiplication assignment (*=)
   47. new
   48. new.target
   49. null
   50. Nullish coalescing assignment (??=)
   51. Nullish coalescing operator (??)
   52. Object initializer
   53. Operator precedence
   54. Optional chaining (?.)
   55. Property accessors
   56. Remainder (%)
   57. Remainder assignment (%=)
   58. Right shift (>>)
   59. Right shift assignment (>>=)
   60. Spread syntax (...)
   61. Strict equality (===)
   62. Strict inequality (!==)
   63. Subtraction (-)
   64. Subtraction assignment (-=)
   65. super
   66. this
   67. typeof
   68. Unary negation (-)
   69. Unary plus (+)
   70. Unsigned right shift (>>>)
   71. Unsigned right shift assignment (>>>=)
   72. void operator
   73. yield
   74. yield*
9. Statements & declarations
   1. async function
   2. async function*
   3. await using
   4. Block statement
   5. break
   6. class
   7. const
   8. continue
   9. debugger
   10. do...while
   11. Empty statement
   12. export
   13. Expression statement
   14. for
   15. for await...of
   16. for...in
   17. for...of
   18. function
   19. function*
   20. if...else
   21. import
       1. Import attributes
   22. Labeled statement
   23. let
   24. return
   25. switch
   26. throw
   27. try...catch
   28. using
   29. var
   30. while
   31. with Deprecated
10. Functions
    1. Arrow function expressions
    2. Default parameters
    3. get
    4. Method definitions
    5. Rest parameters
    6. set
    7. The arguments object
       1. [Symbol.iterator]()
       2. callee Deprecated
       3. length
11. Classes
    1. constructor
    2. extends
    3. Private elements
    4. Public class fields
    5. static
    6. Static initialization blocks
12. Regular expressions
    1. Backreference: \1, \2
    2. Capturing group: (...)
    3. Character class escape: \d, \D, \w, \W, \s, \S
    4. Character class: [...], [^...]
    5. Character escape: \n, \u{...}
    6. Disjunction: |
    7. Input boundary assertion: ^, $
    8. Literal character: a, b
    9. Lookahead assertion: (?=...), (?!...)
    10. Lookbehind assertion: (?<=...), (?<!...)
    11. Modifier: (?ims-ims:...)
    12. Named backreference: \k<name>
    13. Named capturing group: (?<name>...)
    14. Non-capturing group: (?:...)
    15. Quantifier: *, +, ?, {n}, {n,}, {n,m}
    16. Unicode character class escape: \p{...}, \P{...}
    17. Wildcard: .
    18. Word boundary assertion: \b, \B
13. Errors
    1. AggregateError: No Promise in Promise.any was resolved
    2. Error: Permission denied to access property "x"
    3. InternalError: too much recursion
    4. RangeError: argument is not a valid code point
    5. RangeError: BigInt division by zero
    6. RangeError: BigInt negative exponent
    7. RangeError: form must be one of 'NFC', 'NFD', 'NFKC', or 'NFKD'
    8. RangeError: invalid array length
    9. RangeError: invalid date
    10. RangeError: precision is out of range
    11. RangeError: radix must be an integer
    12. RangeError: repeat count must be less than infinity
    13. RangeError: repeat count must be non-negative
    14. RangeError: x can't be converted to BigInt because it isn't an integer
    15. ReferenceError: "x" is not defined
    16. ReferenceError: assignment to undeclared variable "x"
    17. ReferenceError: can't access lexical declaration 'X' before initialization
    18. ReferenceError: must call super constructor before using 'this' in derived class constructor
    19. ReferenceError: super() called twice in derived class constructor
    20. SyntaxError: 'arguments'/'eval' can't be defined or assigned to in strict mode code
    21. SyntaxError: "0"-prefixed octal literals are deprecated
    22. SyntaxError: "use strict" not allowed in function with non-simple parameters
    23. SyntaxError: "x" is a reserved identifier
    24. SyntaxError: \ at end of pattern
    25. SyntaxError: a declaration in the head of a for-of loop can't have an initializer
    26. SyntaxError: applying the 'delete' operator to an unqualified name is deprecated
    27. SyntaxError: arguments is not valid in fields
    28. SyntaxError: await is only valid in async functions, async generators and modules
    29. SyntaxError: await/yield expression can't be used in parameter
    30. SyntaxError: cannot use `??` unparenthesized within `||` and `&&` expressions
    31. SyntaxError: character class escape cannot be used in class range in regular expression
    32. SyntaxError: continue must be inside loop
    33. SyntaxError: duplicate capture group name in regular expression
    34. SyntaxError: duplicate formal argument x
    35. SyntaxError: for-in loop head declarations may not have initializers
    36. SyntaxError: function statement requires a name
    37. SyntaxError: functions cannot be labelled
    38. SyntaxError: getter and setter for private name #x should either be both static or non-static
    39. SyntaxError: getter functions must have no arguments
    40. SyntaxError: identifier starts immediately after numeric literal
    41. SyntaxError: illegal character
    42. SyntaxError: import declarations may only appear at top level of a module
    43. SyntaxError: incomplete quantifier in regular expression
    44. SyntaxError: invalid assignment left-hand side
    45. SyntaxError: invalid BigInt syntax
    46. SyntaxError: invalid capture group name in regular expression
    47. SyntaxError: invalid character in class in regular expression
    48. SyntaxError: invalid class set operation in regular expression
    49. SyntaxError: invalid decimal escape in regular expression
    50. SyntaxError: invalid identity escape in regular expression
    51. SyntaxError: invalid named capture reference in regular expression
    52. SyntaxError: invalid property name in regular expression
    53. SyntaxError: invalid range in character class
    54. SyntaxError: invalid regexp group
    55. SyntaxError: invalid regular expression flag "x"
    56. SyntaxError: invalid unicode escape in regular expression
    57. SyntaxError: JSON.parse: bad parsing
    58. SyntaxError: label not found
    59. SyntaxError: missing : after property id
    60. SyntaxError: missing ) after argument list
    61. SyntaxError: missing ) after condition
    62. SyntaxError: missing ] after element list
    63. SyntaxError: missing } after function body
    64. SyntaxError: missing } after property list
    65. SyntaxError: missing = in const declaration
    66. SyntaxError: missing formal parameter
    67. SyntaxError: missing name after . operator
    68. SyntaxError: missing variable name
    69. SyntaxError: negated character class with strings in regular expression
    70. SyntaxError: new keyword cannot be used with an optional chain
    71. SyntaxError: nothing to repeat
    72. SyntaxError: numbers out of order in {} quantifier.
    73. SyntaxError: octal escape sequences can't be used in untagged template literals or in strict mode code
    74. SyntaxError: parameter after rest parameter
    75. SyntaxError: private fields can't be deleted
    76. SyntaxError: property name __proto__ appears more than once in object literal
    77. SyntaxError: raw bracket is not allowed in regular expression with unicode flag
    78. SyntaxError: redeclaration of formal parameter "x"
    79. SyntaxError: reference to undeclared private field or method #x
    80. SyntaxError: rest parameter may not have a default
    81. SyntaxError: return not in function
    82. SyntaxError: setter functions must have one argument
    83. SyntaxError: string literal contains an unescaped line break
    84. SyntaxError: super() is only valid in derived class constructors
    85. SyntaxError: tagged template cannot be used with optional chain
    86. SyntaxError: Unexpected '#' used outside of class body
    87. SyntaxError: Unexpected token
    88. SyntaxError: unlabeled break must be inside loop or switch
    89. SyntaxError: unparenthesized unary expression can't appear on the left-hand side of '**'
    90. SyntaxError: use of super property/member accesses only valid within methods or eval code within methods
    91. SyntaxError: Using //@ to indicate sourceURL pragmas is deprecated. Use //# instead
    92. TypeError: 'caller', 'callee', and 'arguments' properties may not be accessed
    93. TypeError: 'x' is not iterable
    94. TypeError: "x" is (not) "y"
    95. TypeError: "x" is not a constructor
    96. TypeError: "x" is not a function
    97. TypeError: "x" is not a non-null object
    98. TypeError: "x" is read-only
    99. TypeError: already executing generator
    100. TypeError: BigInt value can't be serialized in JSON
    101. TypeError: calling a builtin X constructor without new is forbidden
    102. TypeError: can't access/set private field or method: object is not the right class
    103. TypeError: can't assign to property "x" on "y": not an object
    104. TypeError: can't convert BigInt to number
    105. TypeError: can't convert x to BigInt
    106. TypeError: can't define property "x": "obj" is not extensible
    107. TypeError: can't delete non-configurable array element
    108. TypeError: can't redefine non-configurable property "x"
    109. TypeError: can't set prototype of this object
    110. TypeError: can't set prototype: it would cause a prototype chain cycle
    111. TypeError: cannot use 'in' operator to search for 'x' in 'y'
    112. TypeError: class constructors must be invoked with 'new'
    113. TypeError: cyclic object value
    114. TypeError: derived class constructor returned invalid value x
    115. TypeError: getting private setter-only property
    116. TypeError: Initializing an object twice is an error with private fields/methods
    117. TypeError: invalid 'instanceof' operand 'x'
    118. TypeError: invalid Array.prototype.sort argument
    119. TypeError: invalid assignment to const "x"
    120. TypeError: Iterator/AsyncIterator constructor can't be used directly
    121. TypeError: matchAll/replaceAll must be called with a global RegExp
    122. TypeError: More arguments needed
    123. TypeError: null/undefined has no properties
    124. TypeError: property "x" is non-configurable and can't be deleted
    125. TypeError: Reduce of empty array with no initial value
    126. TypeError: setting getter-only property "x"
    127. TypeError: WeakSet key/WeakMap value 'x' must be an object or an unregistered symbol
    128. TypeError: X.prototype.y called on incompatible type
    129. URIError: malformed URI sequence
    130. Warning: -file- is being assigned a //# sourceMappingURL, but already has one
    131. Warning: unreachable code after return statement
14. Misc
    1. JavaScript technologies overview
    2. Execution model
    3. Lexical grammar
    4. Iteration protocols
    5. Strict mode
    6. Template literals
    7. Trailing commas
    8. Deprecated features