JavaScriptで最も使われる2つのデータ構造は ObjectArray です。

オブジェクトは多くの情報を1つのエンティティにまとめることができ、配列は順序付けされたコレクションを格納することが出来ます。従って、私たちはオブジェクトまたは配列を作りそれを1つのエンティティとして扱うことができます。もしくはそれを関数呼出しに渡すこともできます。

Destructuring assignment (分割代入) は配列またはオブジェクトの中身を複数の変数に代入できる特別な構文で、便利な場合があります。デストラクタリング(構造の分解)は、多くのパラメータとデフォルト値を持つ複雑な関数でもうまく機能し、このチャプターですぐにこれらがどのように処理されているかわかるでしょう。

Array のデストラクタリング

配列がどのように変数に分解されるかの例です:

// 名前と姓の配列を持っています
let arr = ["Ilya", "Kantor"]

// 分割代入
let [firstName, surname] = arr;

alert(firstName); // Ilya
alert(surname);  // Kantor

これで、配列メンバーの代わりに変数を扱うことができます。

split や他の配列を返すメソッドと組み合わせるとよいです:

let [firstName, surname] = "Ilya Kantor".split(' ');
“分割” は “破壊的” を意味しません

これは、項目を変数にコピーすることによって “非構造化(destructurizes)” するため、“分割代入(destructuring assignment)” と呼ばれています。 配列自体は変更されません。

これは、より短い書き方になります:

// let [firstName, surname] = arr;
let firstName = arr[0];
let surname = arr[1];
最初の要素を無視する

配列の不要な要素は、余分なカンマをつけることで捨てることができます:

// 1番目、2番めの要素は不要です
let [, , title] = ["Julius", "Caesar", "Consul", "of the Roman Republic"];

alert( title ); // Consul

上のコードでは、最初と2つ目の配列の要素がスキップされていますが、3つ目は title に代入され、残りもまたスキップされています。

右辺の任意の反復可能なもの(iterable)に対して動作します

…実際には、配列だけでなく任意の反復可能なもの(iterable)で使うことができます:

let [a, b, c] = "abc"; // ["a", "b", "c"]
let [one, two, three] = new Set([1, 2, 3]);
左辺の任意のものに代入する

左辺には任意の “割り当て可能なもの” を使用できます。

例えば、オブジェクトのプロパティも指定できます:

let user = {};
[user.name, user.surname] = "Ilya Kantor".split(' ');

alert(user.name); // Ilya
.entries() を使ったループ

以前のチャプターで、私たちは Object.entries(obj) メソッドを見ました。

オブジェクトの key-value をループするために、それをデストラクタリングと一緒使うこともできます:

let user = {
  name: "John",
  age: 30
};

// key-value のループ
for (let [key, value] of Object.entries(user)) {
  alert(`${key}:${value}`); // name:John, then age:30
}

…また、map でも同じです:

let user = new Map();
user.set("name", "John");
user.set("age", "30");

for (let [key, value] of user.entries()) {
  alert(`${key}:${value}`); // name:John, then age:30
}

残り ‘…’

もしも、単に1つ目の値だけではなく、それに続く全てを集めたい場合 – 3つのドッド "..." を使うことで “残りの部分” を取得するもう1つのパラメータを追加することができます:

let [name1, name2, ...rest] = ["Julius", "Caesar", "Consul", "of the Roman Republic"];

alert(name1); // Julius
alert(name2); // Caesar

alert(rest[0]); // Consul
alert(rest[1]); // of the Roman Republic
alert(rest.length); // 2

rest の値は残りの配列要素の配列です。 rest の代わりに他の変数名を使うこともできます。その前に3つのドットがあることを確認して、最後に分割代入を行います。

デフォルト値

もしも代入変数よりも配列の値のほうが少ない場合、エラーにはなりません。不足している値は undefined とみなされます:

let [firstName, surname] = [];

alert(firstName); // undefined

値がなかった場合に “デフォルト” 値に置き換えたいとき、= を使って値を指定することができます:

// デフォルト値
let [name = "Guest", surname = "Anonymous"] = ["Julius"];

alert(name);    // Julius (配列から)
alert(surname); // Anonymous (デフォルtが使用された)

デフォルト値はより複雑な式や関数呼び出しにすることもできます。それらは値が提供されなかったときのみ評価されます。

例えば、ここでは、2つのデフォルトのために prompt 関数を使っていますが、それは値がなかったものの場合にだけ実行されます:

// 姓のプロンプトのみを実行する
let [name = prompt('name?'), surname = prompt('surname?')] = ["Julius"];

alert(name);    // Julius (配列から)
alert(surname); // プロンプトが得たもの

オブジェクトのデストラクタリング

分割代入はオブジェクトでも動作します。

基本の構文は次の通りです:

let {var1, var2} = {var1:…, var2…}

右辺には、変数に分割したい既存のオブジェクトがあります。左辺は該当するプロパティの “パターン” を含みます。シンプルなケースでは、それは {...} の変数名のリストです。

例:

let options = {
  title: "Menu",
  width: 100,
  height: 200
};

let {title, width, height} = options;

alert(title);  // Menu
alert(width);  // 100
alert(height); // 200

プロパティ options.title, options.widthoptions.height は、該当する変数に代入されます。順序は関係ありません。これも動作します。:

// let {...} 内のプロパティ順を変えた場合
let {height, width, title} = { title: "Menu", height: 200, width: 100 }

左辺のパターンはより複雑で、プロパティと変数の間のマッピングを指定することができます。

もしプロパティを別の名前の変数に代入したい場合、例えば、options.width を変数名 w にしたい場合、コロンを使うことでセットすることができます:

let options = {
  title: "Menu",
  width: 100,
  height: 200
};

// { sourceProperty: targetVariable }
let {width: w, height: h, title} = options;

// width -> w
// height -> h
// title -> title

alert(title);  // Menu
alert(w);      // 100
alert(h);      // 200

コロンは “代入するプロパティ名: 代入先の変数名” となります。上の例では、プロパティ widthwに、プロパティ heighth, title は同じ名前に代入されます。

潜在的に不足しているプロパティについては、次のように "=" を使ってデフォルト値を設定できます:

let options = {
  title: "Menu"
};

let {width = 100, height = 200, title} = options;

alert(title);  // Menu
alert(width);  // 100
alert(height); // 200

ちょうど配列や関数のパラメータのように、デフォルト値は任意の式または関数呼び出しにすることができます。それらは値がない場合に評価されます。

下のコードは、 width はプロンプトで尋ねられますが、 title は聞かれません。

let options = {
  title: "Menu"
};

let {width = prompt("width?"), title = prompt("title?")} = options;

alert(title);  // Menu
alert(width);  // (プロンプトの結果)

コロンと等号の両方を組み合わせることも出来ます。:

let options = {
  title: "Menu"
};

let {width: w = 100, height: h = 200, title} = options;

alert(title);  // Menu
alert(w);      // 100
alert(h);      // 200

残りの演算子

仮に、指定した変数よりも多くのプロパティをオブジェクトがもっていたらどうなるでしょうか。いくつかを設定し、“残り” をどこかに代入することはできるでしょうか?

残りの演算子(3つの点)を使用するための仕様はほぼ標準ですが、ほとんどのブラウザではまだサポートされていません。

このようになります:

let options = {
  title: "Menu",
  height: 200,
  width: 100
};

let {title, ...rest} = options;

// now title="Menu", rest={height: 200, width: 100}
alert(rest.height);  // 200
alert(rest.width);   // 100
Gotcha without let

上の例で、変数は代入の直前に宣言されています: let {…} = {…}。もちろん既存の変数を使うこともできますが、罠もあります。

これは動作しません:

let title, width, height;

// この行はエラーです
{title, width, height} = {title: "Menu", width: 200, height: 100};

問題は、JavaScriptが(別の式の中ではなく)メインコードフローの `{…}’ をコードブロックとして扱うことです。このようなコードブロックを使用すると、次のように文をグループ化できます。

{
  // a code block
  let message = "Hello";
  // ...
  alert( message );
}

コードブロックではない JavaScript と示すためには、代入全体を括弧 (...) で囲む必要があります:

let title, width, height;

// これでOKです
({title, width, height} = {title: "Menu", width: 200, height: 100});

alert( title ); // Menu

入れ子構造のデストラクタリング

オブジェクトまたは配列に他のオブジェクトや配列が含まれている場合、より複雑な左辺のパターンを使用してより深い部分を抽出することができます。

下のコードでは、options はプロパティ size の中に別のオブジェクトを持っており、プロパティ items に配列を持っています。代入の左辺のパターンは同じ構造を持ちます。:

let options = {
  size: {
    width: 100,
    height: 200
  },
  items: ["Cake", "Donut"],
  extra: true    // 分割されない何か追加のデータ
};

// わかりやすくするために、複数の行での分割代入
let {
  size: { // put size here
    width,
    height
  },
  items: [item1, item2], // ここで items を割り当て
  title = "Menu" // オブジェクトには存在しない (デフォルト値が使われます)
} = options;

alert(title);  // Menu
alert(width);  // 100
alert(height); // 200
alert(item1);  // Cake
alert(item2);  // Donut

言及されていなかった extra を除いた options オブジェクト全体が該当する変数に代入されます。

最終的に、width, height, item1, item2 とデフォルト値から title を持ちます。

それは分割代入ではよく起こります。私たちは、多くのプロパティを持つ複雑なオブジェクトを持っており、必要なものだけを抽出したいため。

このようなことも頻繁にあります。:

// 変数全体から size を取り、残りは無視します
let { size } = options;

スマートな関数パラメータ

ある関数が多くのパラメータを持っており、ほどんどがオプションであることがあります。特にユーザインタフェースのときに当てはまります。メニューを作る関数を想像してみてください。幅と高さ、タイトル、アイテムのリストなどを持っています。

ここに、このような関数の悪い書き方があります:

function showMenu(title = "Untitled", width = 200, height = 100, items = []) {
  // ...
}

現実において、問題はどうやって引数の順番を覚えるか、です。通常は IDE が助けてくれます、特にコードが良くドキュメント化されていれば。しかし、他にも…別の問題はほとんどのパタメータがデフォルトでOKの場合の関数の呼び方です。

こうなりますか?

showMenu("My Menu", undefined, undefined, ["Item1", "Item2"])

これは酷く、より多くのパラメータを扱うときに読みにくくなります。

このようなケースでデストラクタリングが助けに来てくれます!

オブエジェクトとしてパラメータを渡し、関数はそれらを変数に分解することができます:

// オブジェクトを関数に渡す
let options = {
  title: "My menu",
  items: ["Item1", "Item2"]
};

// ...そしてすぐに変数に展開されます
function showMenu({title = "Untitled", width = 200, height = 100, items = []}) {
  // title, items – options から取得,
  // width, height – デフォルト値を利用
  alert( `${title} ${width} ${height}` ); // My Menu 200 100
  alert( items ); // Item1, Item2
}

showMenu(options);

また、入れ子のオブジェクトやコロンのマッピング使った複雑なデストラクタリングを使うこともできます:

let options = {
  title: "My menu",
  items: ["Item1", "Item2"]
};

function showMenu({
  title = "Untitled",
  width: w = 100,  // width goes to w
  height: h = 200, // height goes to h
  items: [item1, item2] // items の最初の要素は item1 へ、次は item2 へ
}) {
  alert( `${title} ${w} ${h}` ); // My Menu 100 200
  alert( item1 ); // Item1
  alert( item2 ); // Item2
}

showMenu(options);

構文は分割代入と同じです:

function({
  incomingProperty: parameterName = defaultValue
  ...
})

このような分割代入は showMenu() に引数があることを前提にしている点に注意してください。もし全ての値をデフォルトにしたい場合には、空のオブジェクトを指定する必要があります:

showMenu({});

// これはエラーになります
showMenu();

これについては、デストラクタリング対象全体のデフォルト値に {} を指定することで直すことができます:

// 明快にするためのちょっとしたパラメータの簡略化
function showMenu({ title = "Menu", width = 100, height = 200 } = {}) {
  alert( `${title} ${width} ${height}` );
}

showMenu(); // Menu 100 200

上のコードでは、全体の引数オブジェクトがデフォルトで {} なので常に分解する何かがあります。

サマリ

  • 分割代入はオブジェクトや配列を多数の変数に即座にマッピングすることができます。

  • オブジェクト構文:

    let {prop : varName = default, ...} = object

    これはプロパティ prop が変数 varName に代入され、もしこのようなプロパティが存在しない場合には default が使われることを意味します。

  • 配列構文:

    let [item1 = default, item2, ...rest] = array

    最初のアイテムは item1 に行き、2つ目は item2 に行きます。残りのすべてのアイテムは配列 rest になります。

  • より複雑なケースでは、左辺は右辺と同じ構造を指定します。

タスク

重要性: 5

次のオブジェクトがあります:

let user = {
  name: "John",
  years: 30
};

以下のような分割代入を書いてください:

  • name プロパティを変数 name に、
  • years プロパティを変数 age に、
  • isAdmin プロパティを変数 isAdmin (存在しない場合は false )にしてください。

代入後の値は次のようになる必要があります:

let user = { name: "John", years: 30 };

// your code to the left side:
// ... = user

alert( name ); // John
alert( age ); // 30
alert( isAdmin ); // false
let user = {
  name: "John",
  years: 30
};

let {name, years: age, isAdmin = false} = user;

alert( name ); // John
alert( age ); // 30
alert( isAdmin ); // false
重要性: 5

salaries オブジェクトがあります:

let salaries = {
  "John": 100,
  "Pete": 300,
  "Mary": 250
};

支払い額がトップの名前を返す関数 topSalary(salaries) を作ってください。

  • salaries がからの場合、null を返します。
  • トップの人が複数いる場合、それらのいずれかを返します。

P.S. キー/値ベアを反復するために Object.entries と分割代入を使ってください。

テストと一緒にサンドボックスを開く

チュートリアルマップ

コメント

コメントをする前に読んでください…
  • 自由に記事への追加や質問を投稿をしたり、それらに回答してください。
  • 数語のコードを挿入するには、<code> タグを使ってください。複数行の場合は <pre> を、10行を超える場合にはサンドボックスを使ってください(plnkr, JSBin, codepen…)。
  • 記事の中で理解できないことがあれば、詳しく説明してください。