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.
Please take two minutes to fill out our short survey.
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
構文
delete expression;
expression
は下記のように、プロパティへの参照として評価されるべきものです。
delete object.property;
delete object["property"];
引数
返値
例外
strict モードでは、プロパティが編集不可の場合、TypeError
が発生します。
解説
一般的に信じられていることとは異なり (おそらく C++ における delete のような他のプログラミング言語の影響ですが)、delete
演算子は、直接的にメモリーを解放することはありません。メモリーの管理は参照が切れることで間接的に行われます。詳細はメモリー管理を参照してください。
delete
演算子は指定したプロパティをオブジェクトから取り除きます。削除に成功すると true
を返し、そうでなければ false
を返します。
ただし、次のようなシナリオを考慮することが重要です。
-
削除しようとしたプロパティが存在しない場合、
delete
は何もせずにtrue
を返します。 -
そのオブジェクトのプロトタイプチェーンに同名のプロパティが存在する場合、削除後はプロトタイプチェーンのプロパティをオブジェクトが使うようになります (つまり、
delete
は自身のプロパティにのみ効果があります)。 -
グローバルスコープや関数スコープから
var
で宣言されたプロパティは削除できません。- そのため、
delete
はグローバルスコープ内の関数を削除できません (関数定義の一部であるか関数式の一部であるかにかかわらず)。 - (グローバルスコープを除く) オブジェクトの一部である関数は
delete
で削除できます。
- そのため、
-
編集不可能なプロパティは削除できません。これには
Math
やArray
、Object
のような組み込みオブジェクトのプロパティやObject.defineProperty()
のようなメソッドで編集不可として生成されたプロパティが含まれます。
次のスニペットがシンプルな例です。
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 returned
console.log(delete Employee.salary); // true を返す
編集不可のプロパティ
プロパティが編集不可に設定されているとき、delete
は何もせずに false
を返します。strict モードでは、これは TypeError
を生成します。
var Employee = {};
Object.defineProperty(Employee, "name", { configurable: false });
console.log(delete Employee.name); // false を返す
var
や let
、const
は、delete
演算子で削除できない編集不可のプロパティを生成します:
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']
の形で使用する必要があります。
Object.defineProperty(globalThis, "variable1", {
value: 10,
configurable: true,
});
Object.defineProperty(globalThis, "variable2", {
value: 10,
configurable: false,
});
// strict モードでは SyntaxError
console.log(delete variable1); // true
// strict モードでは SyntaxError
console.log(delete variable2); // false
function func(param) {
// strict モードでは SyntaxError
console.log(delete param); // false
}
// strict モードでは SyntaxError
console.log(delete func); // false
ブラウザーの互換性の注意
ECMAScript はオブジェクトに対して反復処理を行った時の順序を実装系依存であるとしているにもかかわらず、主要なブラウザーはいずれも、(少なくともプロトタイプ上にないプロパティについては) 最初に追加されたプロパティを最初に処理する順序に対応しているようです。しかし Internet Explorer では、プロパティに対して delete
を用いたときにややこしい結果になることがあり、これが他のブラウザーが単純なオブジェクトを整列された連想配列のように用いることの障害になります。Internet Explorer では、プロパティの値を undefined
に設定しようとしたとき、後から同じ名前で再びプロパティを追加すると、そのプロパティは元の場所で処理されるようになります。削除済みのプロパティを再度追加した場合に予想されるような、最後の場所ではありません。
複数のブラウザーで同じ連想配列を使用したい場合は、可能であれば Map
を使用してください。または、2 つに分けた配列 (片方はキー、もう片方は値) やプロパティを一つだけ持ったオブジェクトの配列を構築するなどの方法でこの構造をシミュレーションしてください。
例
// 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
とプロトタイプチェーン
次の例では、プロトタイプチェーン上に同じ名前を持つプロパティがある場合に、オブジェクトの自身のプロパティを削除しています。
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
で削除されます。
var trees = ["redwood", "bay", "cedar", "oak", "maple"];
delete trees[3];
if (3 in trees) {
// これは実行されない
}
ある配列の要素を存在したまま未定義の値としたい場合は、delete
演算子の代わりに undefined
値を使用してください。次の例では、trees[3]
に undefined
を割り当てていますが、配列のその要素は存在したままです。
var trees = ["redwood", "bay", "cedar", "oak", "maple"];
trees[3] = undefined;
if (3 in trees) {
// これは実行される
}
代わりに、配列の内容を変更して配列要素を削除したい場合は、
メソッドを使用してください。次の例では、splice()
splice()
を使用して配列から trees[3]
を削除しています。
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 |