【JS応用｜豆知識】JavaScriptの隠れた実力者！Object.definePropertiesでオブジェクトを「守る」方法

導入: なぜObject.definePropertiesが必要なのか

普段、JavaScriptでオブジェクトを扱う際、私たちは「const user = { name: ‘太郎’ };」のように記述します。しかし、この方法では後から誰でも「user.name = ‘次郎’」と値を書き換えたり、削除したりできてしまいます。大規模なアプリケーション開発では、意図しない値の変更がバグの温床になります。Object.definePropertiesを使うと、オブジェクトの各プロパティに対して「読み取り専用」や「設定変更不可」といった厳格なルールを定義でき、堅牢なコードを実現できます。

基礎知識: プロパティ記述子（Property Descriptor）

Object.definePropertiesを理解するには「プロパティ記述子」という概念を知る必要があります。これは、値そのものだけでなく、その値がどう振る舞うかを定義する設定項目です。

主な設定項目は以下の通りです：

value: プロパティに格納する値。
writable: trueなら書き換え可能。falseなら読み取り専用。
enumerable: trueならfor…inやObject.keysで列挙可能。
configurable: trueならプロパティの削除や、記述子の再定義が可能。

実装/解決策

Object.definePropertiesは、オブジェクトに対して一度に複数のプロパティを定義するメソッドです。単一の定義を行うObject.definePropertyよりも、複数の設定を一括で管理できるため、設定オブジェクトの定義に適しています。

サンプルプログラム

以下のコードは、書き換え不可の「固定設定」を持つオブジェクトを作成する例です。

const config = {};

// Object.definePropertiesを使用して、厳格なプロパティを定義
Object.defineProperties(config, {
  'version': {
    value: '1.0.0',
    writable: false,     // 書き換え不可
    enumerable: true,    // 列挙可能
    configurable: false  // 削除や再定義不可
  },
  'apiKey': {
    value: 'ABC-12345',
    writable: false,
    enumerable: false,   // 列挙不可（コンソールで見えにくくする）
    configurable: false
  }
});

// テスト実行
console.log(config.version); // 1.0.0 と出力
config.version = '2.0.0';    // 書き換えを試みる
console.log(config.version); // 1.0.0 のまま（変更されない）

// 列挙の確認
console.log(Object.keys(config)); // ['version'] のみ表示される

応用・注意点

注意すべき点として、’use strict’（厳格モード）環境下で、writable: falseのプロパティに値を代入しようとすると、プログラムがエラーを投げて停止します。非厳格モードでは単に無視されるだけですが、予期せぬ挙動を防ぐためにも、常に厳格モードで開発することをお勧めします。

また、Object.definePropertiesで設定したプロパティは、通常の代入文とは異なる挙動をするため、チーム開発では「このオブジェクトは変更不可である」というコメントを添えるか、TypeScriptの「as const」や「readonly」と組み合わせて型安全性を高めるのが現代的なベストプラクティスです。ぜひ、設定ファイルや定数オブジェクトの管理に活用してみてください。