數組方法是日常開發使用頻率最高的一批 API。這份清單分兩部分整理:基礎方法(ES5 之前)與 ECMAScript 5 新增的高階方法,並標註哪些會修改原數組——這是最容易出錯的地方。
var arr = [1, 2, 3];
console.log(arr.join()); // "1,2,3"
console.log(arr.join("-")); // "1-2-3"
var a = new Array(10); // 長度 10 的空數組
console.log(a.join("-")); // "---------"
var arr = [1, 2, 3];
arr.reverse();
console.log(arr.join()); // "3,2,1",原數組已被修改
字符串反轉的經典組合:
"abcdefg".split("").reverse().join(""); // "gfedcba"
var arr = [1, 4, 7];
arr.sort(); // [1, 4, 7]
arr.sort(function (a, b) { return a - b; });// 從小到大
arr.sort(function (a, b) { return b - a; });// 從大到小
不傳比較函數時按字符串順序排序,因此 [10, 9, 1].sort() 得到的是 [1, 10, 9]——數字排序必須傳比較函數。
var num = new Array('one', 'three', 'Six', 'Five');
num.sort(); // ["Five", "Six", "one", "three"],區分大小寫
// 忽略大小寫
num.sort(function (s, t) {
var a = s.toLowerCase(), b = t.toLowerCase();
if (a < b) return -1;
if (a > b) return 1;
return 0;
});
// ["Five", "one", "Six", "three"]
var arr = [1, 2, 3];
arr.concat(4, 5); // [1, 2, 3, 4, 5]
arr.concat([4, 5], [6, 7]); // [1, 2, 3, 4, 5, 6, 7]
arr.concat([4, [5, [6, 7]]]); // [1, 2, 3, 4, [5, [6, 7]]]
注意:只展開一層,不會遞歸扁平化;原數組不受影響。
var arr = [1, 2, 3, 4, 5];
arr.slice(0, 3); // [1, 2, 3],含頭不含尾
arr.slice(3); // [4, 5]
arr.slice(-3); // [3, 4, 5],負數從末尾算起
arr.slice(-3, -1); // [3, 4]
var arr = [1, 2, 3, 4, 5, 6, 7, 8];
arr.splice(4); // 返回 [5, 6, 7, 8],arr 變為 [1, 2, 3, 4]
arr.splice(1, 2); // 返回 [2, 3],arr 變為 [1, 4]
// 第三個參數起為待插入元素
var a2 = [1, 2, 3, 4, 5];
a2.splice(2, 0, 'a', 'b'); // 返回 [],a2 變為 [1, 2, "a", "b", 3, 4, 5]
與 concat 不同,splice 是把元素一個個插入,而不是整體塞進去。
前兩個是常規堆棧操作,後兩個是反向:
var arr = [];
arr.push(1, 2, 3); // 返回 3,arr = [1, 2, 3]
arr.pop(); // 返回 3,arr = [1, 2]
arr.push([4, 5]); // 返回 3,arr = [1, 2, [4, 5]],數組不會被展開
var a2 = [];
a2.unshift(1, 2, 3); // 返回 3,a2 = [1, 2, 3]
a2.shift(); // 返回 1,a2 = [2, 3]
這類方法有共同約定:都不修改原數組;第一個參數是回調函數;回調可接收「元素、索引、數組本身」三個參數;第二個可選參數用來指定回調中的 this。
var data = [1, 2, 3, 4, 5];
var sum = 0;
data.forEach(function (value) { sum += value; });
console.log(sum); // 15
// 利用索引與數組本身改寫元素
data.forEach(function (value, item, arr) {
arr[item] = value * value;
});
console.log(data); // [1, 4, 9, 16, 25]
var data = [1, 2, 3, 4, 5];
var data1 = data.map(function (value) { return ++value; });
console.log(data); // [1, 2, 3, 4, 5],原數組不變
console.log(data1); // [2, 3, 4, 5, 6]
var data = [1, 2, 3, 4, 5];
data.filter(function (v) { return v <= 3; }); // [1, 2, 3]
data.filter(function (v) { return v > 3; }); // [4, 5]
回調返回真值即保留該元素。
var data = [1, 2, 3, 4, 5];
data.every(function (v) { return v < 4; }); // false,並非全部滿足
data.some(function (v) { return v > 4; }); // true,存在滿足項
var data = [1, 2, 3, 4, 5];
data.reduce(function (a, b) { return a + b; }); // 15
data.reduce(function (a, b) { return a + b; }, 5); // 20,初始值為 5
data.reduce(function (a, b) { return (a < b) ? a : b; }); // 1,求最小值
不傳第二個參數時,初始值取數組首元素;傳了則以它為起點。reduceRight 方向相反,從右向左累加:
['a', 'b', 'c'].reduce(function (x, y) { return x + y; });
// "abc"
['a', 'b', 'c'].reduceRight(function (x, y) { return x + y; });
// "cba"
var data = ['a', 'b', 'a', 'c', 'a'];
data.indexOf('a'); // 0,從頭找
data.indexOf('d'); // -1
data.lastIndexOf('a'); // 4,從尾找
data.lastIndexOf('a', -2); // 2,從倒數第二個開始
data.lastIndexOf('a', 1); // 0,從正序第二個往前找
Array.isArray([]); // true
Array.isArray({}); // false
// 舊環境的模擬實現
var isArray1 = Function.isArray || function (o) {
return typeof o === "object"
&& Object.prototype.toString.call(o) === "[object Array]";
};
會修改:push、pop、shift、unshift、splice、sort、reverse、fill、copyWithin。
不改修改:join、concat、slice、map、filter、reduce、forEach、every、some、indexOf、flat。
記住這張表,能避開大多數「數據莫名被改掉」的 bug。在 React、Vuex 這類要求不可變數據的環境中尤其重要。