本文へ移動
プログラミング大全動かして、比べて、理解する。

JavaScript / コードを試す

Object.assign() と Object.freeze()

Object.assign() は第1引数を書き換えて返します。後ろが勝つこと、複製が1段しか効かないこと、 getter が値に変わること、freeze() も1段しか凍らないことを実行して確かめます。

固定例はNode 24.22.3の実行記録を照合しています()。下の入力欄の結果は今回の実行で確認してください。

元の教材を読む(別タブ)

コードを編集して試す

ブラウザー内で実行します。コードの送信・自動実行・自動保存はしません。このタブを閉じると入力は失われます。機密情報は入力しないでください。

playground.js

8,192 UTF-8 byte・実行1.5秒・出力60行/8KiB以内。Ctrl / ⌘ + Enterでも実行できます。

パネルを開くと編集できます。

現在の入力は未実行です。

今回の実行結果
JavaScriptUTF-8 · LF

実行画面や検索画面の間の通常クリックでは入力をこのタブのRAMで保持します。元の教材は別タブで開きます。再読み込み・タブ終了ではRAMの入力は失われます。

Object.assign() は、第1引数そのものを書き換えて、それを返します。

example.js

const target = { a: 1 };
const result = Object.assign(target, { b: 2 }, { a: 9 });

console.log(JSON.stringify(result));
console.log(result === target);
console.log(JSON.stringify(target));
固定例の期待出力 · Node 24.22.3
{"a":9,"b":2}
true
{"a":9,"b":2}
表示用コードUTF-8 · LF

渡した target が変わっています。 ここが最大の注意点です。

  • 後ろに書いたものが勝ちます
  • 返るのは新しいオブジェクトではなく、第1引数そのもの

元を壊したくないなら先頭に空を置く

example.js

const base = { a: 1 };
const merged = Object.assign({}, base, { b: 2 });

console.log(JSON.stringify(merged));
console.log(JSON.stringify(base));
console.log(merged === base);
固定例の期待出力 · Node 24.22.3
{"a":1,"b":2}
{"a":1}
false
表示用コードUTF-8 · LF

{} を先頭に置くと、base は無傷です。 いまは { ...base, b: 2 } と書くほうが短く、意図も伝わります。 → スプレッド構文と残余

Object.assign() がいま必要なのは、「既にあるオブジェクトを書き換えたい」ときだけです。それ以外はスプレッドで足ります。

複製は1段しか効かない

javascript失敗・注意の例

const base = { deep: { n: 1 } };
const copied = Object.assign({}, base);

copied.deep.n = 99;

console.log(base.deep.n);
固定例の期待出力 · Node 24.22.3
99
表示用コードUTF-8 · LF

copied は別のオブジェクトですが、deep は同じものを指しています。 これを浅いコピーと呼びます。スプレッドでも同じです。

深く複製するなら structuredClone() です。

example.js

const base = { deep: { n: 1 } };
const copied = structuredClone(base);

copied.deep.n = 99;

console.log(base.deep.n, copied.deep.n);
固定例の期待出力 · Node 24.22.3
1 99
表示用コードUTF-8 · LF

null や undefined は無視される

example.js

console.log(JSON.stringify(Object.assign({}, { a: 1 }, null, undefined, { b: 2 })));
固定例の期待出力 · Node 24.22.3
{"a":1,"b":2}
表示用コードUTF-8 · LF

落ちません。 条件によって渡すものが消えても、そのまま通ります。

ただし第1引数が null なら落ちます。そこだけは対象になれません。

example.js

try {
  Object.assign(null, { a: 1 });
} catch (error) {
  console.log(error.name + ': ' + error.message);
}
固定例の期待出力 · Node 24.22.3
TypeError: Cannot convert undefined or null to object
表示用コードUTF-8 · LF

→ TypeError: Cannot convert undefined or null to object

入るのは「自分の・列挙できる」ものだけ

example.js

const sym = Symbol('s');
const source = Object.create({ inherited: 1 });

source.own = 2;
source[sym] = 3;
Object.defineProperty(source, 'hidden', { value: 4, enumerable: false });

const copied = Object.assign({}, source);

console.log(JSON.stringify(copied));
console.log(Object.getOwnPropertySymbols(copied).length);
console.log('hidden' in copied, 'inherited' in copied);
固定例の期待出力 · Node 24.22.3
{"own":2}
1
false false
表示用コードUTF-8 · LF
  • 受け継いだものは入らない
  • 列挙できないものは入らない
  • Symbol の鍵は入る(Object.keys() とはここだけ違う)

→ Object.keys() / values() / entries()

get は値に変わる

example.js

const source = {
  get computed() {
    return 1 + 1;
  },
};

const copied = Object.assign({}, source);

console.log(Object.getOwnPropertyDescriptor(copied, 'computed'));
固定例の期待出力 · Node 24.22.3
{ value: 2, writable: true, enumerable: true, configurable: true }
表示用コードUTF-8 · LF

呼ばれた結果が、ただの値として入ります。 get のまま持っていきたいなら Object.defineProperties() と Object.getOwnPropertyDescriptors() を使ってください。

Object.freeze() — 変えられなくする

example.js

const frozen = Object.freeze({ a: 1, deep: { n: 1 } });

frozen.a = 9;
frozen.b = 9;

console.log(JSON.stringify(frozen));
固定例の期待出力 · Node 24.22.3
{"a":1,"deep":{"n":1}}
表示用コードUTF-8 · LF

書き換えも追加も黙って無視されます。

strict モードでは、無視ではなく落ちます。

example.js

'use strict';

const frozen = Object.freeze({ a: 1 });

try {
  frozen.a = 9;
} catch (error) {
  console.log(error.name + ': ' + error.message);
}
固定例の期待出力 · Node 24.22.3
TypeError: Cannot assign to read only property 'a' of object '#<Object>'
表示用コードUTF-8 · LF

import / export のあるファイルは自動的に strict なので、 実務では落ちるほうが普通です。

freeze も1段しか効かない

javascript失敗・注意の例

const frozen = Object.freeze({ deep: { n: 1 } });

frozen.deep.n = 99;

console.log(frozen.deep.n);
console.log(Object.isFrozen(frozen), Object.isFrozen(frozen.deep));
固定例の期待出力 · Node 24.22.3
99
true false
表示用コードUTF-8 · LF

外側は凍っていますが、中の入れ子は凍っていません。 深く凍らせたいなら、自分で辿って凍らせる必要があります。

まとめ

  • Object.assign() は第1引数を書き換えて、それを返す
  • 元を壊したくないなら {} を先頭に置く。ふだんはスプレッドで足りる
  • 後ろが勝つ。null / undefined は無視される
  • 複製も凍結も1段だけ。 深くしたいなら structuredClone() か自分で辿る
  • get は呼ばれた結果の値になる
  • freeze() は strict では黙って無視ではなく落ちる

出典

この教材の原文(Markdown・別タブ)