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

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

インスタンスから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 演算子を使用する必要があります。

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"); // truegetAge("toString"); // [Function: toString]

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

const ages = Object.create(null, {  alice: { value: 18, enumerable: true },  bob: { value: 27, enumerable: true },});hasPerson("hasOwnProperty"); // falsegetAge("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() コンストラクターを使用して、プリミティブ値のオブジェクトラッパーを作成します。

次の例では、論理値と長整数の値を格納するオブジェクトである変数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"];  } else {    // 私のオブジェクトのようには見えないので、現在の動作をできる限り再現して、    // 既定の動作にフォールバックします。    // apply は、他のいくつかの言語における "super" のような動作をします。    // valueOf() は引数を取りませんが、他のフックによっては取るかもしれません。    return current.apply(this, args);  }};

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

• オブジェクト初期化子