Movatterモバイル変換

[0]ホーム
URL:

MDN Web Docs

このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docs コミュニティーについてもっと知り、仲間になるにはこちらから。

delete 演算子

BaselineWidely available

JavaScript のdelete 演算子は、オブジェクトからプロパティを削除します。同じプロパティへの参照がそれ以上保持されていない場合は、自動的に解放されます。

試してみましょう

const Employee = {  firstname: "Maria",  lastname: "Sanchez",};console.log(Employee.firstname);// Expected output: "Maria"delete Employee.firstname;console.log(Employee.firstname);// Expected output: undefined

構文

js
delete expression;

expression は下記のように、プロパティへの参照として評価されるべきものです。

js
delete object.property;delete object["property"];

引数

object

オブジェクト名、またはオブジェクトとして評価される式です。

property

削除するプロパティです。

返値

プロパティが自分自身の構成不可のプロパティであった場合、 strict モードでなければfalse を返します。それ以外の場合はtrue を返します。

例外

strict モードでは、プロパティが編集不可の場合、TypeError が発生します。

解説

一般的に信じられていることとは異なり (おそらくC++ における delete のような他のプログラミング言語の影響ですが)、delete 演算子は、直接的にメモリーを解放することはありません。メモリーの管理は参照が切れることで間接的に行われます。詳細はメモリー管理を参照してください。

delete 演算子は指定したプロパティをオブジェクトから取り除きます。削除に成功するとtrue を返し、そうでなければfalse を返します。

ただし、次のようなシナリオを考慮することが重要です。

  • 削除しようとしたプロパティが存在しない場合、delete は何もせずにtrue を返します。

  • そのオブジェクトのプロトタイプチェーンに同名のプロパティが存在する場合、削除後はプロトタイプチェーンのプロパティをオブジェクトが使うようになります (つまり、delete は自身のプロパティにのみ効果があります)。

  • グローバルスコープや関数スコープからvar で宣言されたプロパティは削除できません。

    • そのため、delete はグローバルスコープ内の関数を削除できません (関数定義の一部であるか関数式の一部であるかにかかわらず)。
    • (グローバルスコープを除く) オブジェクトの一部である関数はdelete で削除できます。

  • let やconst で宣言された任意のプロパティはそれらが宣言されたスコープから削除できません。

  • 編集不可能なプロパティは削除できません。これにはMath やArray、Object のような組み込みオブジェクトのプロパティやObject.defineProperty() のようなメソッドで編集不可として生成されたプロパティが含まれます。

次のスニペットがシンプルな例です。

js
var Employee = {  age: 28,  name: "abc",  designation: "developer",};console.log(delete Employee.name); // true を返すconsole.log(delete Employee.age); // true を返す// When trying to delete a property that does// not exist, true is returnedconsole.log(delete Employee.salary); // true を返す

編集不可のプロパティ

プロパティが編集不可に設定されているとき、delete は何もせずにfalse を返します。strict モードでは、これはTypeError を生成します。

js
var Employee = {};Object.defineProperty(Employee, "name", { configurable: false });console.log(delete Employee.name); // false を返す

var やlet、const は、delete 演算子で削除できない編集不可のプロパティを生成します:

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

strict モードでは、例外が発生します。

strict モードとそれ以外の違い

strict モードのとき、delete が変数や関数の引数、関数名への直接参照に使われた場合、SyntaxError が発生します。したがって、 strict モードでエラーが発生することを防ぐためには、delete 演算子をdelete object.property またはdelete object['property'] の形で使用する必要があります。

js
Object.defineProperty(globalThis, "variable1", {  value: 10,  configurable: true,});Object.defineProperty(globalThis, "variable2", {  value: 10,  configurable: false,});// strict モードでは SyntaxErrorconsole.log(delete variable1); // true// strict モードでは SyntaxErrorconsole.log(delete variable2); // false
js
function func(param) {  // strict モードでは SyntaxError  console.log(delete param); // false}// strict モードでは SyntaxErrorconsole.log(delete func); // false

ブラウザーの互換性の注意

ECMAScript はオブジェクトに対して反復処理を行った時の順序を実装系依存であるとしているにもかかわらず、主要なブラウザーはいずれも、(少なくともプロトタイプ上にないプロパティについては) 最初に追加されたプロパティを最初に処理する順序に対応しているようです。しかし Internet Explorer では、プロパティに対してdelete を用いたときにややこしい結果になることがあり、これが他のブラウザーが単純なオブジェクトを整列された連想配列のように用いることの障害になります。Internet Explorer では、プロパティの値をundefined に設定しようとしたとき、後から同じ名前で再びプロパティを追加すると、そのプロパティは元の場所で処理されるようになります。削除済みのプロパティを再度追加した場合に予想されるような、最後の場所ではありません。

複数のブラウザーで同じ連想配列を使用したい場合は、可能であればMap を使用してください。または、2 つに分けた配列 (片方はキー、もう片方は値) やプロパティを一つだけ持ったオブジェクトの配列を構築するなどの方法でこの構造をシミュレーションしてください。

例

js
// adminName プロパティをグローバルスコープに生成adminName = "xyz";// empCount プロパティをグローバルスコープに生成// var を使用しているため、これは構成不可となります。 let や const でも同じことになります。var empCount = 43;EmployeeDetails = {  name: "xyz",  age: 5,  designation: "Developer",};// adminName はグローバルスコープのプロパティです。// var を使用せずに生成されたため、構成可能になっているので// 削除することができます。delete adminName; // true を返す// 対照的に、 empCount は var が使用されたので// 構成可能ではありません。delete empCount; // false を返す// delete を使用してオブジェクトからプロパティを削除することができます。delete EmployeeDetails.name; // true を返す// プロパティが存在しない場合であっても、 delete は "true" を返します。delete EmployeeDetails.salary; // true を返す// delete は組み込み静的プロパティには効果がありません。delete Math.PI; // false を返す// EmployeeDetails はグローバルスコープのプロパティです。// "var" を使用せずに定義されたため、構成可能となっています。delete EmployeeDetails; // true を返すfunction f() {  var z = 44;  // delete はローカル変数名には効果がありません。  delete z; // false を返す}

delete とプロトタイプチェーン

次の例では、プロトタイプチェーン上に同じ名前を持つプロパティがある場合に、オブジェクトの自身のプロパティを削除しています。

js
function Foo() {  this.bar = 10;}Foo.prototype.bar = 42;var foo = new Foo();// foo.bar は自身のプロパティに関連付けられて// います。console.log(foo.bar); // 10// foo オブジェクトにある自身のプロパティを// 削除します。delete foo.bar; // true を返す// foo.bar がプロトタイプチェーン上でまだ// 利用できます。console.log(foo.bar); // 42// プロトタイプ上のプロパティを削除します。delete Foo.prototype.bar; // true を返す// "bar" プロパティは Foo 上で削除されたので// 継承されなくなりました。console.log(foo.bar); // undefined

配列の要素の削除

配列の要素を削除したとき、配列のlength は影響を受けません。これは配列の最後の要素を削除しても保持されます。

delete 演算子が配列の要素を削除すると、要素は配列からなくなります。 次の例では、trees[3] がdelete で削除されます。

js
var trees = ["redwood", "bay", "cedar", "oak", "maple"];delete trees[3];if (3 in trees) {  // これは実行されない}

ある配列の要素を存在したまま未定義の値としたい場合は、delete 演算子の代わりにundefined 値を使用してください。次の例では、trees[3] にundefined を割り当てていますが、配列のその要素は存在したままです。

js
var trees = ["redwood", "bay", "cedar", "oak", "maple"];trees[3] = undefined;if (3 in trees) {  // これは実行される}

代わりに、配列の内容を変更して配列要素を削除したい場合は、splice() メソッドを使用してください。次の例では、splice() を使用して配列からtrees[3] を削除しています。

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

仕様書

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

ブラウザーの互換性

関連情報

Help improve MDN

Learn how to contribute.

This page was last modified on byMDN contributors.

[8]ページ先頭
©2009-2025 Movatter.jp