このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docsコミュニティーについてもっと知り、仲間になるにはこちらから。
Object.assign()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2015年9月.
Object.assign() は静的メソッドで、すべての列挙可能な自身のプロパティの値を、 1 つ以上のコピー元オブジェクトからコピー先オブジェクトにコピーするために使用されます。変更されたコピー先オブジェクトを返します。
試してみましょう
const target = { a: 1, b: 2 };const source = { b: 4, c: 5 };const returnedTarget = Object.assign(target, source);console.log(target);// 予想される結果: Object { a: 1, b: 4, c: 5 }console.log(returnedTarget === target);// 予想される結果: true構文
Object.assign(target)Object.assign(target, source1)Object.assign(target, source1, source2)Object.assign(target, source1, source2, /* …, */ sourceN)引数
targetコピー先オブジェクト — コピー元のプロパティを適用するもので、変更後に返されます。対象とするプリミティブ値が指定された場合、その値はオブジェクトに変換されます。
source1, …,sourceNコピー元オブジェクト (単数または複数) — 適用したいプロパティを含むオブジェクトです。
返値
コピー先オブジェクトです。
例外
解説
コピー先オブジェクトのプロパティは、コピー元に同じキーのプロパティがあると上書きされます。より後のコピー元のプロパティが、より前のものを同様に上書きします。
Object.assign() メソッドは、コピー元オブジェクトから列挙可能 (enumerable) かつ直接所有 (own) のプロパティだけをコピー先オブジェクトにコピーします。この際、コピー元オブジェクトには[[Get]]、コピー先オブジェクトには[[Set]] を使いますので、ゲッターとセッターを呼び出すことになります。これはプロパティの代入 (assign) であり、プロパティをコピーしたり新しく定義したりするのとは異なります。そのため、コピー元にゲッターが存在する場合、新しいプロパティをプロトタイプにマージする用途には不適切でしょう。
プロパティ定義を (列挙可能属性も含めて) プロトタイプの中にコピーするには、このメソッドではなくObject.getOwnPropertyDescriptor() とObject.defineProperty() を使用してください。
String とSymbol の両方のプロパティがコピーされます。
エラーが発生した場合、例えばプロパティが書き込み不可の場合は、TypeError が発生しますが、エラーが発生する前にプロパティが追加される場合、target オブジェクトが変更されることがあります。
例
オブジェクトの複製
const obj = { a: 1 };const copy = Object.assign({}, obj);console.log(copy); // { a: 1 }ディープクローンについての注意
ディープクローンを行う場合、別にstructuredClone() のような代替手段を使用する必要があります。Object.assign() はプロパティ値のみをコピーするからです。
元の値がオブジェクトへの参照である場合、参照の値のみがコピーされます。
const obj1 = { a: 0, b: { c: 0 } };const obj2 = Object.assign({}, obj1);console.log(obj2); // { a: 0, b: { c: 0 } }obj1.a = 1;console.log(obj1); // { a: 1, b: { c: 0 } }console.log(obj2); // { a: 0, b: { c: 0 } }obj2.a = 2;console.log(obj1); // { a: 1, b: { c: 0 } }console.log(obj2); // { a: 2, b: { c: 0 } }obj2.b.c = 3;console.log(obj1); // { a: 1, b: { c: 3 } }console.log(obj2); // { a: 2, b: { c: 3 } }// ディープクローンconst obj3 = { a: 0, b: { c: 0 } };const obj4 = structuredClone(obj3);obj3.a = 4;obj3.b.c = 4;console.log(obj4); // { a: 0, b: { c: 0 } }オブジェクトのマージ
const o1 = { a: 1 };const o2 = { b: 2 };const o3 = { c: 3 };const obj = Object.assign(o1, o2, o3);console.log(obj); // { a: 1, b: 2, c: 3 }console.log(o1); // { a: 1, b: 2, c: 3 }, コピー先オブジェクト自体が変化する。同じプロパティを持つオブジェクトのマージ
const o1 = { a: 1, b: 1, c: 1 };const o2 = { b: 2, c: 2 };const o3 = { c: 3 };const obj = Object.assign({}, o1, o2, o3);console.log(obj); // { a: 1, b: 2, c: 3 }プロパティは、引数の順でより後にあるオブジェクトが同じプロパティを持っていると上書きされます。
シンボル型のプロパティのコピー
const o1 = { a: 1 };const o2 = { [Symbol("foo")]: 2 };const obj = Object.assign({}, o1, o2);console.log(obj); // { a : 1, [Symbol("foo")]: 2 } (cf. bug 1207182 on Firefox)Object.getOwnPropertySymbols(obj); // [Symbol(foo)]プロトタイプチェーン上のプロパティと列挙可能ではないプロパティはコピー不可
const obj = Object.create( // foo is on obj's prototype chain. { foo: 1 }, { bar: { value: 2, // bar は列挙可能なプロパティではない。 }, baz: { value: 3, enumerable: true, // baz は直接所有で列挙可能なプロパティ。 }, },);const copy = Object.assign({}, obj);console.log(copy); // { baz: 3 }プリミティブはオブジェクトでラップされる
const v1 = "abc";const v2 = true;const v3 = 10;const v4 = Symbol("foo");const obj = Object.assign({}, v1, null, v2, undefined, v3, v4);// プリミティブ値はラップされ、 null と undefined は無視される// なお、文字列をラップした時だけ、直接所有で列挙可能なプロパティが存在するconsole.log(obj); // { "0": "a", "1": "b", "2": "c" }// プリミティブ型をターゲットとして扱う場合も、オブジェクトでラップするconst number = Object.assign(3, { a: 1 });console.log(number); // Number {3, a: 1}console.log(typeof number); // objectconsole.log(number.a); // 1// null と undefined を対象として指定すると TypeError が発生します。try { Object.assign(null, { a: 1 });} catch (e) { console.log(e.message); // "Cannot convert undefined or null to object"}例外が発生すると実行中のコピー作業が中断される
const target = Object.defineProperty({}, "foo", { value: 1, writable: false,}); // target.foo is a read-only propertyObject.assign(target, { bar: 2 }, { foo2: 3, foo: 3, foo3: 3 }, { baz: 4 });// TypeError: "foo" is read-only// target.foo に代入しようとすると、この例外が発生するconsole.log(target.bar); // 2, 一番目のコピー元オブジェクトはコピーされているconsole.log(target.foo2); // 3, 二番目のコピー元の最初のプロパティもコピーされているconsole.log(target.foo); // 1, ここで例外が発生console.log(target.foo3); // undefined, assign メソッドが終了したので foo3 はコピーされないconsole.log(target.baz); // undefined, 三番目のコピー元もコピーされないアクセサーのコピー
const obj = { foo: 1, get bar() { return 2; },};let copy = Object.assign({}, obj);console.log(copy);// { foo: 1, bar: 2 }// copy.bar の値は obj.bar のゲッターの返値。// 記述子を完全にコピーする代入関数function completeAssign(target, ...sources) { sources.forEach((source) => { const descriptors = Object.keys(source).reduce((descriptors, key) => { descriptors[key] = Object.getOwnPropertyDescriptor(source, key); return descriptors; }, {}); // 既定では、 Object.assign は列挙可能なシンボルもコピーする Object.getOwnPropertySymbols(source).forEach((sym) => { const descriptor = Object.getOwnPropertyDescriptor(source, sym); if (descriptor.enumerable) { descriptors[sym] = descriptor; } }); Object.defineProperties(target, descriptors); }); return target;}copy = completeAssign({}, obj);console.log(copy);// { foo:1, get bar() { return 2 } }仕様書
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-object.assign |