Object

解説

JavaScript のほぼすべてのオブジェクトが Object のインスタンスです。一般的なオブジェクトは、プロパティを（メソッドを含めて） Object.prototype から継承していますが、これらのプロパティはシャドウ化（別名オーバーライド）されている場合があります。 Object.prototype を継承しないオブジェクトは、 null プロトタイプを持つオブジェクトか、その他の null プロトタイプオブジェクトの子孫だけです。

Object.prototype オブジェクトへの変更は、その変更の対象となるプロパティやメソッドがプロトタイプチェーンに沿ってさらにオーバーライドされない限り、プロトタイプチェーンを通してすべてのオブジェクトに反映されます。これはとても強力ですが、オブジェクトの動作をオーバーライドしたり拡張したりするのは潜在的に危険をはらむ仕組みでもあります。より安全にするために、 Object.prototype は JavaScript のコア言語で唯一、不変のプロトタイプを持つオブジェクトです。 Object.prototype のプロトタイプは常に null であり、変更できません。

Object の prototype プロパティ

インスタンスから Object.prototype のメソッドを直接呼び出すことは避けるべきです。特に、多態性が意図されていないメソッド（つまり、初期の動作だけが意味を持ち、子孫オブジェクトが意味のある方法でそれを上書きすることはできないメソッド）は避けるべきです。 Object.prototype から子孫するすべてのオブジェクトは、同じ名前を持つが、期待するものとはまったく異なる意味づけを持つ、カスタムの自分自身でプロパティを定義することができます。さらに、これらのプロパティは null プロトタイプオブジェクトには継承されません。オブジェクトを作業するための現行の JavaScript ユーティリティはすべて静的です。もっと具体的には、次の通りです。

• valueOf()、toString()、toLocaleString() は多態的な実装として存在し、オブジェクトが賢明な振る舞いを持つ自分自身の実装を定義していることを期待する必要があるので、インスタンスメソッドとして呼び出すことができます。しかし、valueOf() と toString() は通常、型変換によって暗黙のうちに呼び出されるので、コードの中で自分で呼び出す必要はありません。
• __defineGetter__()、__defineSetter__()、__lookupGetter__()、__lookupSetter__() は非推奨であり、使用すべきではありません。代わりに静的な代替である Object.defineProperty() や Object.getOwnPropertyDescriptor() を使用してください。
• __proto__ プロパティは非推奨であり、使用すべきではありません。代替である Object.getPrototypeOf() および Object.setPrototypeOf() は静的メソッドです。
• propertyIsEnumerable() および hasOwnProperty() メソッドは、それぞれ Object.getOwnPropertyDescriptor() および Object.hasOwn() 静的メソッドに置き換えることができます。
• isPrototypeOf() メソッドは通常、コンストラクターの prototype プロパティを検査しているのであれば、instanceof で置き換えられます。

意味的に等価な静的メソッドが存在しない場合、または Object.prototype メソッドを本当に使用したい場合は、オブジェクトが予期しない結果をもたらすオーバーライドプロパティを保有しないように、代わりに対象とするオブジェクトの Object.prototype メソッドを直接 call() を呼び出す必要があります。

const obj = {
  foo: 1,
  // 自分自身でこのようなメソッドを定義すべきではありませんが、
  // 外部入力からオブジェクトを受け取っている場合には、このような
  // ことが起こらないようにすることはできないかもしれません。
  propertyIsEnumerable() {
    return false;
  },
};

obj.propertyIsEnumerable("foo"); // false; 予期しない結果
Object.prototype.propertyIsEnumerable.call(obj, "foo"); // true; 期待通りの結果

オブジェクトからのプロパティの削除

オブジェクト自体には、自身のプロパティを削除するメソッド (Map.prototype.delete() のようなもの) はありません。これを行うには、 delete 演算子を使用する必要があります。

null プロトタイプオブジェクト

JavaScript では、ほぼすべてのオブジェクトが最終的に Object.prototype から継承しています（継承とプロトタイプチェーンを参照）。ただし、 null プロトタイプオブジェクトは Object.create(null) やオブジェクト初期化子構文 で __proto__: null とすることで作成することができます（注: オブジェクトリテラル内の __proto__ キーは非推奨の Object.prototype.__proto__ プロパティとは異なります）。既存のオブジェクトのプロトタイプを null に変更するには、 Object.setPrototypeOf(obj, null) を呼び出してください。

const obj = Object.create(null);
const obj2 = { __proto__: null };

プロトタイプが null のオブジェクトは、Object.prototype からオブジェクトメソッドを継承していないため、予期しない動作をすることがあります。これは特にデバッグ時に当てはまります。一般的なオブジェクトプロパティの変換/検出ユーティリティ関数はエラーを生成したり、情報を失う可能性があるからです（特に、エラーを無視する暗黙のエラートラップを使用していた場合）。

例えば、 Object.prototype.toString() がないため、デバッグが難しくなることがよくあります。

const normalObj = {}; // 通常のオブジェクトを作成
const nullProtoObj = Object.create(null); // プロトタイプが "null" であるオブジェクトを作成

console.log(`normalObj is: ${normalObj}`); // "normalObj is: [object Object]" と表示
console.log(`nullProtoObj is: ${nullProtoObj}`); // エラー: Cannot convert object to primitive value が発生

alert(normalObj); // [object Object] と表示
alert(nullProtoObj); // エラー: Cannot convert object to primitive value が発生

他のメソッドも失敗します。

normalObj.valueOf(); // {} と表示
nullProtoObj.valueOf(); // エラー: nullProtoObj.valueOf is not a function が発生

normalObj.hasOwnProperty("p"); // "true" と表示
nullProtoObj.hasOwnProperty("p"); // エラー: nullProtoObj.hasOwnProperty is not a function が発生

normalObj.constructor; // "Object() { [native code] }" と表示
nullProtoObj.constructor; // "undefined" と表示

toString メソッドを null プロトタイプオブジェクトに割り当てることで追加することができます。

nullProtoObj.toString = Object.prototype.toString; // 新しいオブジェクトに toString が欠けているため、元の汎用的なものを追加しなおす

console.log(nullProtoObj.toString()); // "[object Object]" と表示
console.log(`nullProtoObj is: ${nullProtoObj}`); // "nullProtoObj is: [object Object]" と表示

通常のオブジェクトが toString() をオブジェクトのプロトタイプに持つのとは異なり、ここでの toString() メソッドは nullProtoObj の自分自身のプロパティです。これは nullProtoObj には (null) プロトタイプがないからです。

また、 Object.setPrototypeOf(nullProtoObj, Object.prototype) を用いて、 null プロトタイプオブジェクトを普通のオブジェクトに戻すこともできます。

実際には、 null プロトタイプを持つオブジェクトは通常、マップの安価な代用として使用されます。 Object.prototype プロパティが存在すると、いくつかのバグが発生します。

const ages = { alice: 18, bob: 27 };

function hasPerson(name) {
  return name in ages;
}

function getAge(name) {
  return ages[name];
}

hasPerson("hasOwnProperty"); // true
getAge("toString"); // [Function: toString]

null プロトタイプオブジェクトを使用することで、 hasPerson 関数や getAge 関数にあまり複雑さをもたらすことなく、この危険性を除去することができます。

const ages = Object.create(null, {
  alice: { value: 18, enumerable: true },
  bob: { value: 27, enumerable: true },
});

hasPerson("hasOwnProperty"); // false
getAge("toString"); // undefined

このような場合、データとして格納される他のキーと値のペアと混同される可能性があるため、メソッドの追加は慎重に行う必要があります。

オブジェクトを Object.prototype から継承しないようにすることで、プロトタイプ汚染攻撃を防ぐこともできます。悪意のあるスクリプトが Object.prototype にプロパティを追加した場合、プロトタイプが null であるオブジェクト以外のプログラム内のすべてのオブジェクトにアクセスすることができます。

const user = {};

// 悪意のあるスクリプト
Object.prototype.authenticated = true;

// 認証されていないユーザーを通過させる予期せぬ行為
if (user.authenticated) {
  // 機密データにアクセス
}

JavaScript には null プロトタイプオブジェクトを生成する組み込み API もあり、特にオブジェクトをアドホックなキー値の集合として使用しています。例えば、次のようなものです。

• Object.groupBy() の返値
• RegExp.prototype.exec() の返値の groups および indices.groups プロパティ
• Array.prototype[Symbol.unscopables] （すべての [Symbol.unscopables] オブジェクトはプロトタイプが null である）
• import.meta
• モジュールの名前空間オブジェクト。 import * as ns from "module"; または import() から取得したもの。

「null プロトタイプオブジェクト」という用語には、よくプロトタイプチェーンに Object.prototype がないオブジェクトも含みます。このようなオブジェクトは、クラスを使用するときに extends null で作成することができます。

オブジェクト変換

オブジェクトを期待する組み込み処理の多くは、最初に引数をオブジェクトに変換します。この処理をまとめると以下のようになります。

• オブジェクトはそのまま返されます。
• undefined および null の場合は TypeError が発生します。
• 数値、文字列、論理値、シンボル、長整数のプリミティブは、それぞれ対応するオブジェクトラッパーに変換されます。

JavaScript でほぼ同じ効果を得るには 2 つの方法があります。

• Object.prototype.valueOf(): Object.prototype.valueOf.call(x) は、上記で説明したオブジェクト変換の段階と全く同じように、 x を変換します。
• Object() 関数: Object(x) は x を変換するために同じアルゴリズムを使用しますが、undefined と null は TypeError を発生しません。

オブジェクト変換を使用する場所には以下のようなものがあります。

• for...in ループの object 引数。
• Array メソッドの this 値。
• Object のメソッド、例えば Object.keys() の引数。
• プリミティブ値はプロパティを持たないため、プリミティブ値に対してプロパティがアクセスされると自動的にボックス化されます。
• 厳格モードでない関数を呼び出したときの this 値。プリミティブはボックス化され、 null と undefined はグローバルオブジェクトに置き換わります。

プリミティブ変換とは異なり、オブジェクト変換処理は toString メソッドや valueOf メソッドのようなカスタムコードを呼び出さないので、それ自体は何か方法で監視することはできません。

コンストラクター

Object()

新しい Object オブジェクトを生成します。これは指定された値のラッパーです。

静的メソッド

Object.assign()

1 個以上のソースオブジェクトから、自身の列挙可能なプロパティの値をすべてターゲットオブジェクトにコピーします。

Object.create()

指定されたプロトタイプオブジェクトとプロパティから、新しいオブジェクトを生成します。

Object.defineProperties()

指定された記述子で記述された名前付きプロパティをオブジェクトへ追加します。

Object.defineProperty()

指定された記述子で記述された複数の名前付きプロパティをオブジェクトへ追加します。

Object.entries()

指定されたオブジェクト自身の列挙可能な文字列プロパティのすべての [key, value] の組を含む配列を返します。

Object.freeze()

オブジェクトを凍結します。他のコードがプロパティを削除したり変更したりすることができなくなります。

Object.fromEntries()

反復可能な [key, value] の組から新しいオブジェクトを返します。(これは Object.entries の逆です。)

Object.getOwnPropertyDescriptor()

オブジェクトの名前付きプロパティに対応するプロパティ記述子を返します。

Object.getOwnPropertyDescriptors()

オブジェクト自身のすべてのプロパティの記述子を含むオブジェクトを返します。

Object.getOwnPropertyNames()

指定したオブジェクト自身の列挙可能および列挙不可なすべてのプロパティの名前を、配列として返します。

Object.getOwnPropertySymbols()

指定したオブジェクト上に直接存在するすべてのシンボルプロパティからなる配列を返します。

Object.getPrototypeOf()

指定されたオブジェクトのプロトタイプ (内部の [[Prototype]] プロパティ) を返します。

Object.groupBy()

指定されたイテレーターの要素を、指定されたコールバック関数が返す文字列値に従ってグループ化します。返されるオブジェクトは、グループごとに別個のプロパティを持ち、グループ内の要素を格納した配列を含みます。

Object.hasOwn()

指定したオブジェクトが、指定したプロパティを自身のプロパティとして持っている場合は true を返し、そのプロパティが継承されているか存在しない場合は false を返します。

Object.is()

2 つの値が同じ値であるかどうかを比較します。 NaN 値はすべて同じものとして扱われます（IsLooselyEqual (==) および IsStrictlyEqual (===) のどちらとも異なります）。

Object.isExtensible()

オブジェクトの拡張が許可されているかどうかを判定します。

Object.isFrozen()

オブジェクトが凍結されているかどうかを判定します。

Object.isSealed()

オブジェクトが封印されているかどうかを判定します。

Object.keys()

指定されたオブジェクト自身の列挙可能なプロパティの名前をすべて含む配列を返します。

Object.preventExtensions()

オブジェクトのあらゆる拡張を抑止します。

Object.seal()

オブジェクトのプロパティを削除するほかのコードを抑止します。

Object.setPrototypeOf()

オブジェクトのプロトタイプ (内部の [[Prototype]] プロパティ) を設定します。

Object.values()

与えられたオブジェクト自身の列挙可能な文字列プロパティすべてに対応する値を含む配列を返します。

インスタンスプロパティ

これらのプロパティは Object.prototype で定義されており、すべての Object インスタンスで共有されます。

Object.prototype.__proto__ 非推奨;

オブジェクトがインスタンス化されたときにプロトタイプとして使用したオブジェクトを指します。

Object.prototype.constructor

インスタンスオブジェクトを作成したコンストラクター関数。プレーンな Object インスタンスの場合、初期値は Object コンストラクターです。他のコンストラクターのインスタンスは、それぞれの Constructor.prototype オブジェクトから constructor プロパティを継承します。

インスタンスメソッド

Object.prototype.__defineGetter__() 非推奨;

関数をプロパティに関連付けます。そのプロパティにアクセスすると、その関数を実行して返値を返すようにします。

Object.prototype.__defineSetter__() 非推奨;

関数をプロパティに関連付け、設定されるとプロパティを変更する関数を実行するようにします。

Object.prototype.__lookupGetter__() 非推奨;

指定されたプロパティのゲッター関数として結び付けられた関数を返します。

Object.prototype.__lookupSetter__() 非推奨;

指定されたプロパティのセッター関数として結び付けられた関数を返します。

Object.prototype.hasOwnProperty()

オブジェクトが、プロトタイプチェーンを通じて継承されたものではなくオブジェクトの直接のプロパティを持っているかどうかを示す論理値を返します。

Object.prototype.isPrototypeOf()

このメソッドが呼び出されたオブジェクトが、指定されたオブジェクトのプロトタイプチェーンにあるかどうかを示す論理値を返します。

Object.prototype.propertyIsEnumerable()

指定したプロパティが、このオブジェクトの列挙可能な自分自身のプロパティであるかどうかを示す論理値を返します。

Object.prototype.toLocaleString()

toString() を呼び出します。

Object.prototype.toString()

そのオブジェクトの文字列表現を返します。

Object.prototype.valueOf()

指定されたオブジェクトのプリミティブ値を返します。

例

空のオブジェクトの作成

次の例では、newキーワードに様々な引数を指定して、空のオブジェクトを作成しています。

const o1 = new Object();
const o2 = new Object(undefined);
const o3 = new Object(null);

Object() コンストラクターを用いてプリミティブをそれぞれの型のオブジェクトに変換

Object() コンストラクターを使用して、プリミティブ値のオブジェクトラッパーを作成します。

次の例では、論理値と長整数の値を格納するオブジェクトである変数 o1 と o2 を作成しています。

// const o1 = new Boolean(true) と等価
const o1 = new Object(true);

// BigInt() はコンストラクターとして呼び出せないので等価ではない
// 通所の関数として呼び出した場合はオブジェクトを生成しない
const o2 = new Object(1n);

オブジェクトのプロトタイプ

Object.prototype の既存のメソッドの動作を変更するには、既存のロジックの前または後で独自の拡張を囲む形でコードを挿入するようにしてください。例えば、この (テストされていない) コードは、組み込みロジックや誰かの拡張機能が実行される前に、条件付きで独自のロジックを実行します。

フックを使ってプロトタイプを変更する場合は、関数で apply() を呼び出すことで、 this と引数 (呼び出し状態) を現在の動作に渡します。このパターンは、Node.prototype や Function.prototype など、どんなプロトタイプにも使えます。

const current = Object.prototype.valueOf;

// プロパティ "-prop-value" は横断的で、同じプロトタイプチェーン上に
// あるとは限らないので、 Object.prototype を修正したいと思います。
Object.prototype.valueOf = function (...args) {
  if (Object.hasOwn(this, "-prop-value")) {
    return this["-prop-value"];
  }
  // 私のオブジェクトのようには見えないので、現在の動作をできる限り再現して、
  // 既定の動作にフォールバックします。
  // apply は、他のいくつかの言語における "super" のような動作をします。
  // valueOf() は引数を取りませんが、他のフックによっては取るかもしれません。
  return current.apply(this, args);
};

プロトタイプについては継承とプロトタイプチェーンで詳しく説明されています。

仕様書

ブラウザーの互換性

関連情報

• オブジェクト初期化子