阿西河

所有教程

公众号
🌙
阿西河前端的公众号

我的收藏

    最近访问  (文章)

      教程列表

      抓包专区
      测试专区

      JS array splice()

      splice() 方法通过删除或替换现有元素或者原地添加新的元素来修改数组,并以数组形式返回被修改的内容。此方法会改变原数组。

      var months = ['Jan', 'March', 'April', 'June'];
      months.splice(1, 0, 'Feb');
      // inserts at index 1
      console.log(months);
      // expected output: Array ['Jan', 'Feb', 'March', 'April', 'June']
      
      months.splice(4, 1, 'May');
      // replaces 1 element at index 4
      console.log(months);
      // expected output: Array ['Jan', 'Feb', 'March', 'April', 'May']
      

      语法

      array.splice(start[, deleteCount[, item1[, item2[, ...]]]])
      
      

      参数

      start​

      指定修改的开始位置(从0计数)。如果超出了数组的长度,则从数组末尾开始添加内容;如果是负值,则表示从数组末位开始的第几位(从-1计数,这意味着-n是倒数第n个元素并且等价于array.length-n);如果负数的绝对值大于数组的长度,则表示开始位置为第0位。

      deleteCount 可选

      整数,表示要移除的数组元素的个数。

      如果 deleteCount 大于 start 之后的元素的总数,则从 start 后面的元素都将被删除(含第 start 位)。

      如果 deleteCount 被省略了,或者它的值大于等于array.length - start(也就是说,如果它大于或者等于start之后的所有元素的数量),那么start之后数组的所有元素都会被删除。

      如果 deleteCount 是 0 或者负数,则不移除元素。这种情况下,至少应添加一个新元素。

      item1, item2, _..._ 可选

      要添加进数组的元素,从start 位置开始。如果不指定,则 splice() 将只删除数组元素。

      返回值

      由被删除的元素组成的一个数组。如果只删除了一个元素,则返回只包含一个元素的数组。如果没有删除元素,则返回空数组。

      描述

      如果添加进数组的元素个数不等于被删除的元素个数,数组的长度会发生相应的改变。

      示例

      从第 2 位开始删除 0 个元素,插入“drum”

      var myFish = ["angel", "clown", "mandarin", "sturgeon"];
      var removed = myFish.splice(2, 0, "drum");
      
      // 运算后的 myFish: ["angel", "clown", "drum", "mandarin", "sturgeon"]
      // 被删除的元素: [], 没有元素被删除
      
      

      从第 2 位开始删除 0 个元素,插入“drum” 和 “guitar”

      var myFish = ['angel', 'clown', 'mandarin', 'sturgeon'];
      var removed = myFish.splice(2, 0, 'drum', 'guitar');
      
      // 运算后的 myFish: ["angel", "clown", "drum", "guitar", "mandarin", "sturgeon"]
      // 被删除的元素: [], 没有元素被删除
      
      

      从第 3 位开始删除 1 个元素

      var myFish = ['angel', 'clown', 'drum', 'mandarin', 'sturgeon'];
      var removed = myFish.splice(3, 1);
      
      // 运算后的 myFish: ["angel", "clown", "drum", "sturgeon"]
      // 被删除的元素: ["mandarin"]
      
      

      从第 2 位开始删除 1 个元素,插入“trumpet”

      var myFish = ['angel', 'clown', 'drum', 'sturgeon'];
      var removed = myFish.splice(2, 1, "trumpet");
      
      // 运算后的 myFish: ["angel", "clown", "trumpet", "sturgeon"]
      // 被删除的元素: ["drum"]
      
      

      从第 0 位开始删除 2 个元素,插入"parrot"、“anemone"和"blue”

      var myFish = ['angel', 'clown', 'trumpet', 'sturgeon'];
      var removed = myFish.splice(0, 2, 'parrot', 'anemone', 'blue');
      
      // 运算后的 myFish: ["parrot", "anemone", "blue", "trumpet", "sturgeon"]
      // 被删除的元素: ["angel", "clown"]
      
      

      从第 2 位开始删除 2 个元素

      var myFish = ['parrot', 'anemone', 'blue', 'trumpet', 'sturgeon'];
      var removed = myFish.splice(myFish.length - 3, 2);
      
      // 运算后的 myFish: ["parrot", "anemone", "sturgeon"]
      // 被删除的元素: ["blue", "trumpet"]
      
      

      从倒数第 2 位开始删除 1 个元素

      var myFish = ['angel', 'clown', 'mandarin', 'sturgeon'];
      var removed = myFish.splice(-2, 1);
      
      // 运算后的 myFish: ["angel", "clown", "sturgeon"]
      // 被删除的元素: ["mandarin"]
      

      从第 2 位开始删除所有元素

      var myFish = ['angel', 'clown', 'mandarin', 'sturgeon'];
      var removed = myFish.splice(2);
      
      // 运算后的 myFish: ["angel", "clown"]
      // 被删除的元素: ["mandarin", "sturgeon"]
      
      

      规范

      规范状态备注
      ECMAScript 3rd Edition (ECMA-262)StandardInitial definition. Implemented in JavaScript 1.2.
      ECMAScript 5.1 (ECMA-262) Array.prototype.spliceStandard 
      ECMAScript 2015 (6th Edition, ECMA-262) Array.prototype.spliceStandard 
      ECMAScript Latest Draft (ECMA-262) Array.prototype.spliceDraft 

      参见

      • push() - 在数组末尾增/删元素;
      • unshift() - 在数组首部增/删元素;
      • concat() - 把一个(或多个)数组和(或)值与原数组拼接,返回拼接后的数组。
      目录
      目录