delete
Baseline
広く利用可能
この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2015年7月以降、すべてのブラウザーで利用可能です。
delete 演算子は、オブジェクトからプロパティを除去します。プロパティの値がオブジェクトであり、そのオブジェクトへの参照がこれ以上存在しない場合、そのプロパティが保持するオブジェクトは最終的に自動的に解放されます。
試してみましょう
const employee = {
firstName: "Maria",
lastName: "Sanchez",
};
console.log(employee.firstName);
// 予想される結果: "Maria"
delete employee.firstName;
console.log(employee.firstName);
// 予想される結果: undefined
構文
delete object.property
delete object[property]
メモ:
delete 演算子の次の式は、より幅広い構文が許容されますが、意味のある動作をもたらすのは上記の方法のみです。
引数
返値
プロパティが自己の構成不可プロパティであった場合、厳格モードでなければ false を返します。それ以外の場合は true を返します。
例外
TypeError-
厳格モードで、このプロパティが自己の構成不可プロパティである場合は発生します。
ReferenceError-
objectがsuperである場合に発生します。
解説
delete 演算子は、優先順位が他の単項演算子（例：typeof）と同等です。
したがって、より優先度の高い演算子で構成される任意の式を受け入れます。ただし、以下の形式は厳格モードにおいて早期の構文エラーが発生します。
delete identifier;
delete object.#privateProperty;
クラスは自動的に厳格モードで動作し、プライベート要素はクラス本体内でのみ合法的に参照できるため、プライベート要素が削除されることは決してありません。 delete 識別子 は、識別子 がグローバルオブジェクトの構成不可プロパティを参照している場合に機能する可能性がありますが、この形式は避けるべきであり、代わりに globalThis を接頭辞として付けるべきです。
それ以外の式も受け入れられますが、それらは意味のある動作にはつながりません。
delete console.log(1);
// 1 を出力し、 true を返すが、何も削除されない
delete 演算子は、指定されたプロパティをオブジェクトから取り除きます。削除が成功した場合、true を返し、失敗した場合は false を返します。一般的に信じられていることとは異なり (おそらく C++ における delete のような他のプログラミング言語の影響ですが)、delete 演算子は、直接的にメモリーを解放することはありません。メモリーの管理は参照が切れることで間接的に行われます。詳細はメモリー管理ページを参照してください。
以下の次のシナリオを考慮することが重要です。
- 削除しようとしたプロパティが存在しない場合、
deleteは何もせずにtrueを返します。 deleteは自己のプロパティにのみ効果があります。オブジェクトのプロトタイプチェーン上に同じ名前のプロパティが存在する場合、削除後もオブジェクトはプロトタイプチェーン上のプロパティを使用します。- 構成不可のプロパティは削除できません。これには
MathやArray、Objectのような組み込みオブジェクトのプロパティやObject.defineProperty()のようなメソッドで編集不可として生成されたプロパティが含まれます。 - 変数（関数の引数 を含む）の削除は、一切動作しません。
delete variableは厳格モードではSyntaxErrorが発生し、厳格モード以外では何の効果もありません。varをつけて宣言された変数は、グローバルスコープまたは関数のスコープから削除できません。これらはグローバルオブジェクトに添付されている可能性がありますが、構成不可であるためです。letやconstで宣言された変数は、オブジェクトに添付されていないため、定義されたスコープ内から削除することはできません。
例
delete の使用
メモ: 次の例では、暗黙的にグローバル変数を生成したり識別子を削除したりするなど、厳格モードでは禁止されている厳格モード非対応の機能のみを使用しています。
// empCount プロパティをグローバルスコープに作成する。
// var を使用しているため、これは構成不可となる
var empCount = 43;
// グローバルスコープに EmployeeDetails プロパティを作成する。
// "var" なしで定義しているため、構成不可となる。
EmployeeDetails = {
name: "xyz",
age: 5,
designation: "Developer",
};
// delete を使用してオブジェクトからプロパティを削除することができる。
delete EmployeeDetails.name; // true を返す
// プロパティが存在しない場合であっても、 delete は "true" を返します。
delete EmployeeDetails.salary; // true を返す
// EmployeeDetails はグローバルスコープのプロパティである。
delete EmployeeDetails; // true を返す
// 逆に、 empCount は var が使用されているため構成不可である。
delete empCount; // false を返す
// delete は構成不可の組み込み静的プロパティには効果がない。
delete Math.PI; // false を返す
function f() {
var z = 44;
// delete はローカル変数名には効果がない。
delete z; // false を返す
}
delete とプロトタイプチェーン
次の例では、プロトタイプチェーン上に同じ名前を持つプロパティがある場合に、オブジェクトの自身のプロパティを削除しています。
function Foo() {
this.bar = 10;
}
Foo.prototype.bar = 42;
const 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 で削除されます。
const trees = ["redwood", "bay", "cedar", "oak", "maple"];
delete trees[3];
console.log(3 in trees); // false
これによって、空のスロットを持つ疎配列が作成されます。ある配列の要素を存在したまま未定義の値としたい場合は、delete 演算子の代わりに undefined 値を使用してください。次の例では、trees[3] に undefined を割り当てていますが、配列のその要素は存在したままです。
const trees = ["redwood", "bay", "cedar", "oak", "maple"];
trees[3] = undefined;
console.log(3 in trees); // true
代わりに、配列の内容を変更して配列要素を削除したい場合は、splice() メソッドを使用してください。次の例では、splice() を使用して配列から trees[3] を削除しています。
const trees = ["redwood", "bay", "cedar", "oak", "maple"];
trees.splice(3, 1);
console.log(trees); // ["redwood", "bay", "cedar", "maple"]
構成不可のプロパティの削除
プロパティが構成不可としてマークされている場合、delete は何の効果もなく、false を返します。厳格モードでは、これは TypeError が発生します。
const Employee = {};
Object.defineProperty(Employee, "name", { configurable: false });
console.log(delete Employee.name); // false を返す
var は、delete 演算子で削除できない構成不可のプロパティを作成する:
// "nameOther" は var キーワードを付けて追加するものであるため、
// 構成不可としてマークされる
var nameOther = "XYZ";
// このグローバルプロパティには以下のようにアクセスすることができる
Object.getOwnPropertyDescriptor(globalThis, "nameOther");
// {
// value: "XYZ",
// writable: true,
// enumerable: true,
// configurable: false
// }
delete globalThis.nameOther; // false を返す
厳格モードでは、これらは例外が発生します。
グローバルプロパティの削除
グローバルプロパティが構成不可な場合（例えば、直接プロパティ代入による）、そのプロパティは削除することが でき、その後グローバル変数としてそれらを参照すると ReferenceError が発生します。
globalThis.globalVar = 1;
console.log(globalVar); // 1
// 厳格モードでない場合、`delete globalVar` も使用することができる
delete globalThis.globalVar;
console.log(globalVar); // ReferenceError: globalVar is not defined
仕様書
| 仕様書 |
|---|
| ECMAScript® 2027 Language Specification # sec-delete-operator |