Skip to content

Rest参数与Spread语法

在 JavaScript 中,很多内建函数都支持传入任意数量的参数。

例如:

  • Math.max(arg1, arg2, ..., argN) —— 返回入参中的最大值。
  • Object.assign(dest, src1, ..., srcN) —— 依次将属性从 src1..N 复制到 dest
  • ……等。

在本章中,我们将学习如何编程实现支持函数可传入任意数量的参数。以及,如何将数组作为参数传递给这类函数。

Rest参数...

在 JavaScript 中,无论函数是如何定义的,你都可以使用任意数量的参数调用函数。

例如:

js
function sum(a, b) {
  return a + b;
}

console.log( sum(1, 2, 3, 4, 5) );

虽然这里不会因为传入“过多”的参数而报错。但是当然,在结果中只有前两个参数被计算进去了。

Rest 参数可以通过使用三个点 ... 并在后面跟着包含剩余参数的数组名称,来将它们包含在函数定义中。这些点的字面意思是“将剩余参数收集到一个数组中”。

例如,我们需要把所有的参数都放到数组 args 中:

js
function sumAll(...args) { // 数组名为 args
  let sum = 0;

  for (let arg of args) sum += arg;

  return sum;
}

console.log( sumAll(1) ); // 1
console.log( sumAll(1, 2) ); // 3
console.log( sumAll(1, 2, 3) ); // 6

我们也可以选择获取第一个参数作为变量,并将剩余的参数收集起来。

下面的例子把前两个参数定义为变量,并把剩余的参数收集到 titles 数组中:

js
function showName(firstName, lastName, ...titles) {
  console.log( firstName + ' ' + lastName ); // Julius Caesar

  // 剩余的参数被放入 titles 数组中
  // i.e. titles = ["Consul", "Imperator"]
  console.log( titles[0] ); // Consul
  console.log( titles[1] ); // Imperator
  console.log( titles.length ); // 2
}

showName("Julius", "Caesar", "Consul", "Imperator");

Rest 参数必须放到参数列表的末尾

Rest 参数会收集剩余的所有参数,因此下面这种用法没有意义,并且会导致错误:

js
function f(arg1, ...rest, arg2) { // arg2 在 ...rest 后面?!
  // error
}

...rest 必须处在最后。

arguments变量

有一个名为 arguments 的特殊的类数组对象,该对象按参数索引包含所有参数。

例如:

js
function showName() {
    console.log( arguments.length );
    console.log( arguments[0] );
    console.log( arguments[1] );

  // 它是可遍历的
  // for(let arg of arguments)   console.log(arg);
}

// 依次显示:2,Julius,Caesar
showName("Julius", "Caesar");

// 依次显示:1,Ilya,undefined(没有第二个参数)
showName("Ilya");

在过去,JavaScript 中没有 rest 参数,而使用 arguments 是获取函数所有参数的唯一方法。现在它仍然有效,我们可以在一些老代码里找到它。

但缺点是,尽管 arguments 是一个类数组,也是可迭代对象,但它终究不是数组。它不支持数组方法,因此我们不能调用 arguments.map(...) 等方法。

此外,它始终包含所有参数,我们不能像使用 rest 参数那样只截取入参的一部分。

因此,当我们需要这些功能时,最好使用 rest 参数。

箭头函数是没有 "arguments"

如果我们在箭头函数中访问 arguments,访问到的 arguments 并不属于箭头函数,而是属于箭头函数外部的“普通”函数。

举个例子:

js
function f() {
  let showArg = () => console.log(arguments[0]);
  showArg();
}

f(1); // 1

我们已经知道,箭头函数没有自身的 this。现在我们知道了它们也没有特殊的 arguments 对象。

Spread语法

我们刚刚看到了如何从参数列表中获取数组。

不过有时候我们也需要做与之相反的事儿。

例如,内建函数 Math.max 会返回参数中最大的值:

js
console.log( Math.max(3, 5, 1) ); // 5

假如我们有一个数组 [3, 5, 1],我们该如何用它调用 Math.max 呢?

直接把数组“原样”传入是不会奏效的,因为 Math.max 希望你传入一个列表形式的数值型参数,而不是一个数组:

js
let arr = [3, 5, 1];

console.log( Math.max(arr) ); // NaN

毫无疑问,我们不可能手动地去一一设置参数 Math.max(arg[0], arg[1], arg[2]),因为我们不确定这儿有多少个。在脚本执行时,可能参数数组中有很多个元素,也可能一个都没有。并且这样设置的代码也很丑。

Spread 语法 来帮助你了!它看起来和 rest 参数很像,也使用 ...,但是二者的用途完全相反。

当在函数调用中使用 ...arr 时,它会把可迭代对象 arr “展开”到参数列表中。

Math.max 为例:

js
let arr = [3, 5, 1];

console.log( Math.max(...arr) ); // 5(spread 语法把数组转换为参数列表)

我们还可以通过这种方式传递多个可迭代对象:

js
let arr1 = [1, -2, 3, 4];
let arr2 = [8, 3, -8, 1];

console.log( Math.max(...arr1, ...arr2) ); // 8

我们甚至还可以将 spread 语法与常规值结合使用:

js
let arr1 = [1, -2, 3, 4];
let arr2 = [8, 3, -8, 1];

console.log( Math.max(1, ...arr1, 2, ...arr2, 25) ); // 25

并且,我们还可以使用 spread 语法来合并数组:

js
let arr = [3, 5, 1];
let arr2 = [8, 9, 15];

let merged = [0, ...arr, 2, ...arr2];

console.log(merged); // 0,3,5,1,2,8,9,15(0,然后是 arr,然后是 2,然后是 arr2)

在上面的示例中,我们使用数组展示了 spread 语法,其实任何可迭代对象都可以。

例如,在这儿我们使用 spread 语法将字符串转换为字符数组:

js
let str = "Hello";

console.log([...str]); // [ 'H', 'e', 'l', 'l', 'o' ]

Spread 语法内部使用了迭代器来收集元素,与 for..of 的方式相同。

因此,对于一个字符串,for..of 会逐个返回该字符串中的字符,...str 也同理会得到 "H","e","l","l","o" 这样的结果。随后,字符列表被传递给数组初始化器 [...str]

对于这个特定任务,我们还可以使用 Array.from 来实现,因为该方法会将一个可迭代对象(如字符串)转换为数组:

js
let str = "Hello";

// Array.from 将可迭代对象转换为数组
console.log(Array.from(str)); // [ 'H', 'e', 'l', 'l', 'o' ]

运行结果与 [...str] 相同。

不过 Array.from(obj)[...obj] 存在一个细微的差别:

  • Array.from 适用于类数组对象也适用于可迭代对象。
  • Spread 语法只适用于可迭代对象。

因此,对于将一些“东西”转换为数组的任务,Array.from 往往更通用。

复制Array/Object

还记得我们 之前讲过的 Object.assign() 吗?

使用 spread 语法也可以做同样的事情(译注:也就是进行浅拷贝)。

js
let arr = [1, 2, 3];

let arrCopy = [...arr]; // 将数组 spread 到参数列表中
                        // 然后将结果放到一个新数组

// 两个数组中的内容相同吗?
console.log(JSON.stringify(arr) === JSON.stringify(arrCopy)); // true

// 两个数组相等吗?
console.log(arr === arrCopy); // false(它们的引用是不同的)

// 修改我们初始的数组不会修改副本:
arr.push(4);
console.log(arr); // 1, 2, 3, 4
console.log(arrCopy); // 1, 2, 3

并且,也可以通过相同的方式来复制一个对象:

js
let obj = { a: 1, b: 2, c: 3 };

let objCopy = { ...obj }; // 将对象 spread 到参数列表中
                          // 然后将结果返回到一个新对象

// 两个对象中的内容相同吗?
console.log(JSON.stringify(obj) === JSON.stringify(objCopy)); // true

// 两个对象相等吗?
console.log(obj === objCopy); // false (not same reference)

// 修改我们初始的对象不会修改副本:
obj.d = 4;
console.log(JSON.stringify(obj)); // {"a":1,"b":2,"c":3,"d":4}
console.log(JSON.stringify(objCopy)); // {"a":1,"b":2,"c":3}

这种方式比使用 let arrCopy = Object.assign([], arr) 来复制数组,或使用 let objCopy = Object.assign({}, obj) 来复制对象写起来要短得多。因此,只要情况允许,我们更喜欢使用它。

总结

  1. 当代码中看到...时,要么是rest参数,要么就是spread语法

  2. rest参数是在函数接收参数的时候使用的

    js
    function sumAll(...args) { // 数组名为 args
        // 传的参数都扔进了 args 数组里了
    }
    
    console.log( sumAll(1) ); // 1
    console.log( sumAll(1, 2) ); // 3
    console.log( sumAll(1, 2, 3) ); // 6

    或者

    js
    function showName(firstName, lastName, ...titles) {
      console.log( firstName + ' ' + lastName ); // Julius Caesar
        // 拿出来两个参数,赋值给前面两个形参,后面的都扔到了 titles数组里了
    }
    
    showName("Julius", "Caesar", "Consul", "Imperator");
  3. rest参数必须放到参数列表的最后,要不就报错

  4. function 有个arguments参数,是一个类数组对象,也能到拿到传入的所有变量,箭头函数没有arguments,打印的也是上一级非箭头函数的。

  5. 当有的函数需要一个一个传参数时,你用...(spread语法)也能将数组里的元素,一个一个的展开出来

    js
    let arr = [3, 5, 1];
    console.log( Math.max(...arr) ); // 5(spread 语法把数组转换为参数列表)

    或者传递多个参数

    js
    let arr1 = [1, -2, 3, 4];
    let arr2 = [8, 3, -8, 1];
    
    console.log( Math.max(...arr1, ...arr2) ); // 8

    或者结合常规值一起使用

    js
    let arr1 = [1, -2, 3, 4];
    let arr2 = [8, 3, -8, 1];
    
    console.log( Math.max(1, ...arr1, 2, ...arr2, 25) ); // 25

    或者合并数组

    js
    let arr = [3, 5, 1];
    let arr2 = [8, 9, 15];
    
    let merged = [0, ...arr, 2, ...arr2];
  6. 其实任何可迭代的对象都可以使用spread语法,给展开出来

    js
    let str = "Hello";
    
    console.log([...str]); // [ 'H', 'e', 'l', 'l', 'o' ]

    不过如果想要转换为数组,可以使用Array.from方法,它与spread语法的区别是,

    • Array.from 适用于类数组对象也适用于可迭代对象。
    • Spread 语法只适用于可迭代对象。
  7. spread语法,浅复制数组

    js
    let arr = [1, 2, 3];
    
    let arrCopy = [...arr]; // 将数组 spread 到参数列表中
  8. spread语法,浅复制对象

    js
    let obj = { a: 1, b: 2, c: 3 };
    
    let objCopy = { ...obj }; // 将对象 spread 到参数列表中

参考

https://zh.javascript.info/rest-parameters-spread#spread-syntax