Skip to content

解构赋值

JavaScript 中最常用的两种数据结构是 ObjectArray

  • 对象让我们能够创建通过键来存储数据项的单个实体。
  • 数组则让我们能够将数据收集到一个有序的集合中。

但是,当我们把它们传递给函数时,函数可能不需要整个对象/数组。它可能只需要对象/数组的一部分。

解构赋值 是一种特殊的语法,它使我们可以将数组或对象“拆包”至一系列变量中,因为有时这样更方便。

解构操作对那些具有很多参数和默认值等的函数也很奏效。我们马上会看到类似的例子。

数组解构

下面是一个将数组解构到变量中的例子:

js
// 我们有一个存放了名字和姓氏的数组
let arr = ["John", "Smith"]

// 解构赋值
// sets firstName = arr[0]
// and surname = arr[1]
let [firstName, surname] = arr;

console.log(firstName); // John
console.log(surname);  // Smith

现在我们就可以针对这些变量进行操作,而不是针对原来的数组元素。

当与 split 函数(或其他返回值是数组的函数)结合使用时,看起来就更优雅了:

js
let [firstName, surname] = "John Smith".split(' ');
console.log(firstName); // John
console.log(surname);  // Smith

正如我们所看到的,语法很简单。但是有几个需要注意的细节。让我们通过更多的例子来加深理解。

“解构”并不意味着“破坏”

这种语法叫做“解构赋值”,因为它通过将结构中的各元素复制到变量中来达到“解构”的目的。但数组本身是没有被修改的。

这只是下面这些代码的更精简的写法而已:

js
// let [firstName, surname] = arr;
let firstName = arr[0];
let surname = arr[1];

忽略使用逗号的元素

数组中不想要的元素也可以通过添加额外的逗号来把它丢弃:

js
// 不需要第二个元素
let [firstName, , title] = ["Julius", "Caesar", "Consul", "of the Roman Republic"];

console.log( title ); // Consul

在上面的代码中,数组的第二个元素被跳过了,第三个元素被赋值给了 title 变量,数组中剩下的元素也都被跳过了(因为在这没有对应给它们的变量)。


等号右侧可以是任何可迭代对象

……实际上,我们可以将其与任何可迭代对象一起使用,而不仅限于数组:

js
let [a, b, c] = "abc"; // ["a", "b", "c"]
let [one, two, three] = new Set([1, 2, 3]);

这行得通,因为在内部,结构赋值是通过迭代右侧的值来完成工作的。这是一种用于对在 = 右侧的值上调用 for..of 并进行赋值的操作的语法糖。


赋值给等号左侧的任何内容

我们可以在等号左侧使用任何“可以被赋值的”东西。

例如,一个对象的属性:

js
let user = {};
[user.name, user.surname] = "John Smith".split(' ');

console.log(user.name); // John
console.log(user.surname); // Smith

与 .entries() 方法进行循环操作

在前面的章节中我们已经见过了 Object.entries(obj) 方法。

我们可以将 .entries() 方法与解构语法一同使用,来遍历一个对象的“键—值”对:

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

// 循环遍历键—值对
for (let [key, value] of Object.entries(user)) {
  console.log(`${key}:${value}`); // name:John, then age:30
}

用于 Map 的类似的代码更简单,因为它是可迭代的:

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

// Map 是以 [key, value] 对的形式进行迭代的,非常便于解构
for (let [key, value] of user) {
  console.log(`${key}:${value}`); // name:John, then age:30
}

交换变量值的技巧

有一个著名的使用结构赋值来交换两个变量的值的技巧:

js
let guest = "Jane";
let admin = "Pete";

// 让我们来交换变量的值:使得 guest = Pete,admin = Jane
[guest, admin] = [admin, guest];

console.log(`${guest} ${admin}`); // Pete Jane(成功交换!)

这里我们创建了一个由两个变量组成的临时数组,并且立即以交换了的顺序对其进行了解构。

我们可以用这种方式交换两个以上的变量。

其余的...

通常,如果数组比左边的列表长,那么“其余”的数组项会被省略。

例如,这里只取了两项,其余的就被忽略了:

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

console.log(name1); // Julius
console.log(name2); // Caesar
// 其余数组项未被分配到任何地方

如果我们还想收集其余的数组项 —— 我们可以使用三个点 "..." 来再加一个参数以获取“其余”数组项:

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

// rest 是包含从第三项开始的其余数组项的数组
console.log(rest[0]); // Consul
console.log(rest[1]); // of the Roman Republic
console.log(rest.length); // 2

rest 的值就是数组中剩下的元素组成的数组。

不一定要使用变量名 rest,我们也可以使用任何其他的变量名,只要确保它前面有三个点,并且在解构赋值的最后一个参数位置上就行了。

js
let [name1, name2, ...titles] = ["Julius", "Caesar", "Consul", "of the Roman Republic"];
// 现在 titles = ["Consul", "of the Roman Republic"]

默认值

如果数组比左边的变量列表短,这里也不会出现报错。缺少的值被认为是 undefined

js
let [firstName, surname] = [];

console.log(firstName); // undefined
console.log(surname); // undefined

如果我们想要一个“默认”值给未赋值的变量,我们可以使用 = 来提供:

js
// 默认值
let [name = "Guest", surname = "Anonymous"] = ["Julius"];

console.log(name);    // Julius(来自数组的值)
console.log(surname); // Anonymous(默认值被使用了)

默认值可以是更加复杂的表达式甚至可以是函数调用,这些表达式或函数只会在这个变量未被赋值的时候才会被计算。

举个例子,我们使用了 prompt 函数来提供两个默认值:

js
// 只会提示输入姓氏
let [name = prompt('name?'), surname = prompt('surname?')] = ["Julius"];

alert(name);    // Julius(来自数组)
alert(surname); // 你输入的值

请注意:prompt 将仅针对缺失值(surname)运行。

对象解构

解构赋值同样适用于对象。

基本语法是:

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

在等号右侧应该有一个已经存在的对象,我们想把它拆分到变量中。等号左侧包含了对象相应属性的一个类对象“模式(pattern)”。在最简单的情况下,等号左侧的就是 {...} 中的变量名列表。

举个例子:

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

let {title, width, height} = options;

console.log(title);  // Menu
console.log(width);  // 100
console.log(height); // 200

属性 options.titleoptions.widthoptions.height 值被赋给了对应的变量。

变量的顺序并不重要,下面这个代码也奏效:

js
// 改变 let {...} 中元素的顺序
let {height, width, title} = { title: "Menu", height: 200, width: 100 }

等号左侧的模式(pattern)可以更加复杂,并且指定了属性和变量之间的映射关系。

如果我们想把一个属性赋值给另一个名字的变量,比如把 options.width 属性赋值给名为 w 的变量,那么我们可以使用冒号来设置变量名称:

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

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

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

console.log(title);  // Menu
console.log(w);      // 100
console.log(h);      // 200

冒号表示“什么值:赋值给谁”。上面的例子中,属性 width 被赋值给了 w,属性 height 被赋值给了 h,属性 title 被赋值给了同名变量。

对于可能缺失的属性,我们可以使用 "=" 设置默认值,如下所示:

js
let options = {
  title: "Menu"
};

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

console.log(title);  // Menu
console.log(width);  // 100
console.log(height); // 200

就像数组或函数参数一样,默认值可以是任意表达式甚至可以是函数调用。它们只会在未提供对应的值时才会被计算/调用。

在下面的代码中,prompt 提示输入 width 值,但不会提示输入 title 值:

js
let options = {
  title: "Menu"
};

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

alert(title);  // Menu
alert(width);  // (prompt 的返回值)

我们还可以将冒号和等号结合起来:

js
let options = {
  title: "Menu"
};

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

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

如果我们有一个具有很多属性的复杂对象,那么我们可以只提取所需的内容:

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

// 仅提取 title 作为变量
let { title } = options;

alert(title); // Menu

剩余模式(pattern)...

如果对象拥有的属性数量比我们提供的变量数量还多,该怎么办?我们可以只取其中的某一些属性,然后把“剩余的”赋值到其他地方吗?

我们可以使用剩余模式(pattern),就像我们对数组那样。一些较旧的浏览器不支持此功能(例如,使用 Babel 对其进行填充),但可以在现代浏览器中使用。

看起来就像这样:

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

// title = 名为 title 的属性
// rest = 存有剩余属性的对象
let { title, ...rest } = options;

// 现在 title="Menu", rest={height: 200, width: 100}
console.log(rest); // { height: 200, width: 100 }
console.log(rest.height);  // 200
console.log(rest.width);   // 100

不使用 let 时的陷阱

在上面的示例中,变量都是在赋值中通过正确方式声明的:let {…} = {…}。当然,我们也可以使用已有的变量,而不用 let,但这里有一个陷阱。

以下代码无法正常运行:

js
let title, width, height;

// 这一行发生了错误
{title, width, height} = {title: "Menu", width: 200, height: 100};

问题在于 JavaScript 把主代码流(即不在其他表达式中)的 {...} 当做一个代码块。这样的代码块可以用于对语句分组,如下所示:

js
{
  // 一个代码块
  let message = "Hello";
  // ...
  alert( message );
}

因此,这里 JavaScript 假定我们有一个代码块,这就是报错的原因。我们需要解构它。

为了告诉 JavaScript 这不是一个代码块,我们可以把整个赋值表达式用括号 (...) 包起来:

js
let title, width, height;

// 现在就可以了
({title, width, height} = {title: "Menu", width: 200, height: 100});

alert( title ); // Menu

嵌套解构

如果一个对象或数组嵌套了其他的对象和数组,我们可以在等号左侧使用更复杂的模式(pattern)来提取更深层的数据。

在下面的代码中,options 的属性 size 是另一个对象,属性 items 是另一个数组。赋值语句中等号左侧的模式(pattern)具有相同的结构以从中提取值:

js
let options = {
    size: {
        width: 100,
        height: 200
    },
    items: ["Cake", "Donut"],
    extra: true
};

// 为了清晰起见,解构赋值语句被写成多行的形式
let {
    size: { // 把 size 赋值到这里
        width,
        height
    },
    items: [item1, item2], // 把 items 赋值到这里
    title = "Menu" // 在对象中不存在(使用默认值)
} = options;

console.log(title);  // Menu
console.log(width);  // 100
console.log(height); // 200
console.log(item1);  // Cake
console.log(item2);  // Donut

对象 options 的所有属性,除了 extra 属性在等号左侧不存在,都被赋值给了对应的变量:

image-20220225215124879

最终,我们得到了 widthheightitem1item2 和具有默认值的 title 变量。

注意,sizeitems 没有对应的变量,因为我们取的是它们的内容。

智能参数函数

有时,一个函数有很多参数,其中大部分的参数都是可选的。对用户界面来说更是如此。想象一个创建菜单的函数。它可能具有宽度参数,高度参数,标题参数和项目列表等。

下面是实现这种函数的一个很不好的写法:

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

在实际开发中存在一个问题就是你怎么记得住这么多参数的顺序。通常集成开发环境工具(IDE)会尽力帮助我们,特别是当代码有良好的文档注释的时候,但是…… 另一个问题就是,当大部分的参数采用默认值就好的情况下,怎么调用这个函数。

难道像这样?

js
// 在采用默认值就可以的位置设置 undefined
showMenu("My Menu", undefined, undefined, ["Item1", "Item2"])

这太难看了。而且,当我们处理更多参数的时候可读性会变得很差。

解构赋值语法前来救援!

我们可以把所有参数当作一个对象来传递,然后函数马上把这个对象解构成多个变量:

js
// 我们传递一个对象给函数
let options = {
    title: "My menu",
    items: ["Item1", "Item2"]
};

// ……然后函数马上把对象展开成变量
function showMenu({ title = "Untitled", width = 200, height = 100, items = [] }) {
    // title, items – 提取于 options,
    // width, height – 使用默认值
    console.log(`${title} ${width} ${height}`); // My Menu 200 100
    console.log(items); // Item1, Item2
}

showMenu(options);

我们同样可以使用带有嵌套对象和冒号映射的更加复杂的解构:

js
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 first element goes to item1, second to item2
}) {
    console.log(`${title} ${w} ${h}`); // My Menu 100 200
    console.log(item1); // Item1
    console.log(item2); // Item2
}

showMenu(options);

完整语法和解构赋值是一样的:

js
function({
  incomingProperty: varName = defaultValue
  ...
})

对于参数对象,属性 incomingProperty 对应的变量是 varName,默认值是 defaultValue

请注意,这种解构假定了 showMenu() 函数确实存在参数。如果我们想让所有的参数都使用默认值,那我们应该传递一个空对象:

js
showMenu({}); // 不错,所有值都取默认值

showMenu(); // 这样会导致错误

我们可以通过指定空对象 {} 为整个参数对象的默认值来解决这个问题:

js
function showMenu({ title = "Menu", width = 100, height = 200 } = {}) {
  console.log( `${title} ${width} ${height}` );
}

showMenu(); // Menu 100 200

在上面的代码中,整个参数对象的默认是 {},因此总会有内容可以用来解构。

总结

数组解构

  1. let [firstName, secondName] = ['John', 'Smith']

  2. let [firstName, surname] = "John Smith".split(' ')

  3. 解构并没有破坏原来的数组解构

    js
    // let [firstName, surname] = arr;
    let firstName = arr[0];
    let surname = arr[1];
  4. 忽略解构某一项,可以使用,let [firstName, , title] = ["aa", "bb", "cc", "dd"],这样第二项bb就被忽略了。

  5. 等号右侧只要是可迭代的对象都可以

    js
    let [a, b, c] = "abc"; // ["a", "b", "c"]
    let [one, two, three] = new Set([1, 2, 3]);
  6. 等号左侧可以赋值任意可以赋值的内容,比如

    js
    let user = {};
    [user.name, user.surname] = "John Smith".split(' ');
  7. .entries()方法进行循环操作

    js
    let user = {
      name: "John",
      age: 30
    };
    
    // 循环遍历键—值对
    for (let [key, value] of Object.entries(user)) {
      console.log(`${key}:${value}`); // name:John, then age:30
    }
  8. 用于Map的解构

    js
    let user = new Map();
    user.set("name", "John");
    user.set("age", "30");
    
    // Map 是以 [key, value] 对的形式进行迭代的,非常便于解构
    for (let [key, value] of user) {
      console.log(`${key}:${value}`); // name:John, then age:30
    }
  9. 变量交换

    js
    let guest = "Jane";
    let admin = "Pete";
    // 让我们来交换变量的值:使得 guest = Pete,admin = Jane
    [guest, admin] = [admin, guest];
    console.log(`${guest} ${admin}`); // Pete Jane(成功交换!)
  10. 数组的扩展运算符...

    js
    let [name1, name2, ...rest] = ["aa", "bb", "cc", "dd"];
    console.log(rest) // [ 'cc', 'dd' ]
    
    function test(...params) {
        console.log(params); // [ 'aa', 'bb', 'cc' ]
    }
    test('aa', 'bb', 'cc')
    
    function test2(p1, ...params) {
        console.log(p1); // aa
        console.log(params); // [ 'bb', 'cc' ]
    }
    test2('aa', 'bb', 'cc')
  11. 默认值,let [name = "Guest", surname = "Anonymous"] = ["Julius"]

    默认值可以是函数,如果没有传值的时候函数才会被执行,假如传值了函数不会执行。

对象解构

  1. 基本使用

    js
    let options = { title: "Menu", width: 100, height: 200 };
    let { title, width, height, aa } = options;
    
    console.log(title, width, height, aa); // Menu 100 200 undefined
    // 顺序不中要,会匹配到对应的名字上
    // 没有的就是 undefined
  2. 配置别名

    js
    let options = { title: "Menu", width: 100, height: 200 };
    let { title, width: w, height: h } = options;
    
    console.log(title, w, h); // Menu 100 200
    // 顺序不中要,会匹配到对应的名字上
    // 配置别名之后,就不能用原来的名字了,使用的话会报错,因为没有声明
  3. 默认值

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

    默认值可以传函数,有值时函数不执行,没值时函数执行

  4. 默认值与别名一起用

    js
    let options = { title: "Menu" };
    
    let {width: w = 100, height: h = 200, title} = options;
  5. 提取对象的一部分也行,一般都这么干

    js
    let options = { title: "Menu", width: 100,  height: 200 };
    // 仅提取 title 作为变量
    let { title } = options;
  6. 剩余模式 ...

    js
    let options = { title: "Menu", height: 200, width: 100 };
    let {title, ...rest} = options;
    // 现在 title="Menu", rest={height: 200, width: 100}
  7. 不使用let的陷阱

    js
    let title, width, height;
    
    // 这一行发生了错误
    {title, width, height} = {title: "Menu", width: 200, height: 100};
    // 会把 {} 识别为代码块,所以就报错了,

    可以加个括号,告诉代码,这是解构

    js
    let title, width, height;
    // 现在就可以了
    ({title, width, height} = {title: "Menu", width: 200, height: 100});
  8. 嵌套解构

    js
    let options = {
      size: {
        width: 100,
        height: 200
      },
      items: ["Cake", "Donut"],
      extra: true
    };
    
    // 为了清晰起见,解构赋值语句被写成多行的形式
    let {
      size: { // 把 size 赋值到这里
        width,
        height
      },
      items: [item1, item2], // 把 items 赋值到这里
      title = "Menu" // 在对象中不存在(使用默认值)
    } = options;
    
    // 然后那些变量就都解构出来了

智能函数参数

  1. 当函数参数过多,又有默认值,我们每次想使用默认值的时候,调用起来很麻烦,并且可读性很不好,除非编译器有非常好的提示,并且结合这注释来看

    js
    function showMenu(title = "Untitled", width = 200, height = 100, items = []) {
      // ...
    }
    // 上面这个函数调用起来就很麻烦,像下面这样
    // 在采用默认值就可以的位置设置 undefined
    showMenu("My Menu", undefined, undefined, ["Item1", "Item2"])
    // 非常糟糕的写法!!!!
  2. 所以可以用对象解构的方法来解决上面的问题,将参数变为一个对象

    js
    // 我们传递一个对象给函数
    let options = {
      title: "My menu",
      items: ["Item1", "Item2"]
    };
    
    // ……然后函数马上把对象展开成变量
    function showMenu({title = "Untitled", width = 200, height = 100, items = []}) {
      // title, items – 提取于 options,
      // width, height – 使用默认值
    }
    
    showMenu(options);
  3. 或者更复杂一点的嵌套参数,别名再加默认值

    js
    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 first element goes to item1, second to item2
    }) {
      // ...
    }
    
    showMenu(options);

一个一定要知道的点!

假如函数这样写,参数是需要让你解构的

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

你再调用的时候,就必须得传入一个空对象,否则会报错,比如

js
showMenu() // 报错 TypeError: Cannot read property 'title' of undefined

因为你没有传任何对象进去,进去的就是一个undefined,当尝试用undefined去解构时,let {a, b} = undefined肯定就报错了。

你必须这么调用这个函数,才不会报错,必须传一个空对象

js
showMenu({}) // 这样就可以了

其实我们可以改造我们的showMenu函数,利用给参数设置默认值的方法,就可以避免一定要传一个对象进去的尴尬。

js
function showMenu({ title = "Menu", width = 100, height = 200 } = {}) { // 这样就没啥事了
  // ...
}

showMenu(); // showMenu的参数你不传,默认就会传一个空对象,然后从空对象里解构,所以也不会报错了。

参考

https://zh.javascript.info/destructuring-assignment