indexOf() 是 JavaScript 最常用的搜尋方法,適用於字串與陣列。本文完整涵蓋語法、參數、回傳值、邊界情況與實務技巧。
str.indexOf(searchString[, fromIndex])
searchString:要搜尋的子字串(會自動轉字串)fromIndex(可選):開始搜尋的索引,預設 0。負值視為 0,超過長度視為長度-1const str = 'Hello World Hello';
str.indexOf('Hello'); // 0
str.indexOf('Hello', 1); // 12(從索引 1 開始找)
str.indexOf('World'); // 6
str.indexOf('world'); // -1(區分大小寫)
str.indexOf(''); // 0(空字串永遠在開頭)
str.indexOf('', 5); // 5(空字串在 fromIndex)
arr.indexOf(searchElement[, fromIndex])
NaN(NaN !== NaN)const arr = ['a', 'b', 'c', 'a', 'b'];
arr.indexOf('a'); // 0
arr.indexOf('a', 1); // 3
arr.indexOf('z'); // -1
// 物件參考比較
const obj = { x: 1 };
const arr2 = [obj, { x: 1 }];
arr2.indexOf(obj); // 0
arr2.indexOf({ x: 1 }); // -1(不同參考)
// NaN 無法搜尋
[1, NaN, 3].indexOf(NaN); // -1
// 解法:用 findIndex
[1, NaN, 3].findIndex(x => Number.isNaN(x)); // 1
const str = 'a b a b a';
str.lastIndexOf('a'); // 8
str.lastIndexOf('a', 5); // 4(從索引 5 往前找)
const arr = [1, 2, 3, 2, 1];
arr.lastIndexOf(2); // 3
搜尋字元陣列中任一字元最早/最後出現位置:
function indexOfAny(str, chars, fromIndex = 0) {
for (let i = fromIndex; i < str.length; i++) {
if (chars.includes(str[i])) return i;
}
return -1;
}
function lastIndexOfAny(str, chars, fromIndex = str.length - 1) {
for (let i = fromIndex; i >= 0; i--) {
if (chars.includes(str[i])) return i;
}
return -1;
}
// 使用
const text = 'hello world';
indexOfAny(text, ['a', 'e', 'i', 'o', 'u']); // 1 (e)
lastIndexOfAny(text, ['a', 'e', 'i', 'o', 'u']); // 7 (o)
// 舊寫法
if (str.indexOf('substr') !== -1) { ... }
// 現代寫法
if (str.includes('substr')) { ... }
if (arr.includes('value')) { ... }
function countOccurrences(str, substr) {
let count = 0;
let pos = str.indexOf(substr);
while (pos !== -1) {
count++;
pos = str.indexOf(substr, pos + 1);
}
return count;
}
countOccurrences('ababa', 'aba'); // 1(不重疊)
countOccurrences('aaaa', 'aa'); // 2
function extractContext(text, keyword, radius = 20) {
const idx = text.indexOf(keyword);
if (idx === -1) return null;
const start = Math.max(0, idx - radius);
const end = Math.min(text.length, idx + keyword.length + radius);
return '...' + text.slice(start, end) + '...';
}
includes() 語意更清晰,效能相同indexOf 回傳首次出現索引,找不到回傳 -1fromIndex 參數指定搜尋起點NaN,改用 findIndexincludes() 判斷存在性