このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docsコミュニティーについてもっと知り、仲間になるにはこちらから。
String.prototype.indexOf()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2015年7月.
indexOf() はString 値のメソッドで、この文字列を検索し、指定した部分文字列が最初に出現するインデックスを返します。 オプションで開始位置を取り、指定した数値以上のインデックスで指定した部分文字列が最初に出現するインデックスを返します。
試してみましょう
const paragraph = "I think Ruth's dog is cuter than your dog!";const searchTerm = "dog";const indexOfFirst = paragraph.indexOf(searchTerm);console.log(`The index of the first "${searchTerm}" is ${indexOfFirst}`);// 予想される結果: "The index of the first "dog" is 15"console.log( `The index of the second "${searchTerm}" is ${paragraph.indexOf( searchTerm, indexOfFirst + 1, )}`,);// 予想される結果: "The index of the second "dog" is 38"構文
indexOf(searchString)indexOf(searchString, position)引数
searchString検索する値を表す文字列です。すべての値は文字列に変換されますので、省略したり
undefinedを渡したりすると、indexOf()は"undefined"という文字列を検索します。これはおそらく望むところではないでしょう。position省略可このメソッドは、
position（既定値は0）以上の位置で、指定した部分文字列が最初に現れるインデックスを返します。positionが呼び出された文字列の長さよりも大きい場合、このメソッドは呼び出される文字列をまったく検索しません。positionが0未満の場合、このメソッドはpositionが0のときと同じように動作します。'hello world hello'.indexOf('o', -5)は4を返します。これは第 2 引数が0であるかのように動作し、oが0以上の位置で最初に現れるのが4だからです。'hello world hello'.indexOf('world', 12)は-1を返します。実際に部分文字列worldが現れるのは6のインデックスですが、その位置は12以上ではないからです。'hello world hello'.indexOf('o', 99)は-1を返します。99がhello world helloの長さよりも大きいため、メソッドが全く文字列を検索しなくなるからです。
返値
searchString が最初に見つかったインデックス、または見つからなかった場合は-1 です。
空の検索文字列を使用した場合の返値
空の検索文字列で検索すると、奇妙な結果になります。第 2 引数がなかった場合や、第 2 引数の値が呼び出した文字列の長さよりも小さかった場合、返値は第 2 引数と同じになります。
"hello world".indexOf(""); // 0 を返す"hello world".indexOf("", 0); // 0 を返す"hello world".indexOf("", 3); // 3 を返す"hello world".indexOf("", 8); // 8 を返すしかし、第 2 引数の値が文字列の長さ以上であった場合、返値は文字列の長さになります。
"hello world".indexOf("", 11); // 11 を返す"hello world".indexOf("", 13); // 11 を返す"hello world".indexOf("", 22); // 11 を返す前者の例では、メソッドは第 2 引数で指定した位置の直後に空文字列を見つけたかのように動作します。 後者の例では、メソッドは呼び出した文字列の終わりに空文字列を見つけたかのように動作します。
解説
文字列は 0 基点です。文字列の最初の文字のインデックスは0 で、文字列の最後の文字のインデックスは文字列の長さから 1 を引いたものになります。
"Blue Whale".indexOf("Blue"); // 0 を返す"Blue Whale".indexOf("Wale"); // -1 を返す"Blue Whale".indexOf("Whale", 0); // 5 を返す"Blue Whale".indexOf("Whale", 5); // 5 を返す"Blue Whale".indexOf("Whale", 7); // -1 を返す"Blue Whale".indexOf(""); // 0 を返す"Blue Whale".indexOf("", 9); // 9 を返す"Blue Whale".indexOf("", 10); // 10 を返す"Blue Whale".indexOf("", 11); // 10 を返すindexOf() メソッドは大文字と小文字を区別します。例えば、以下の式は-1 を返します。
"Blue Whale".indexOf("blue"); // -1 を返す出現のチェック
文字列の中に特定の部分文字列があるかどうかを調べる場合、返値が-1 であるかどうかを調べるのが正しい方法です。
"Blue Whale".indexOf("Blue") !== -1; // true。'Blue' が 'Blue Whale' の中で見つかった"Blue Whale".indexOf("Wale") !== -1; // false。 'Wale' が 'Blue Whale' の中で見つからなかった例
indexOf() の使用
以下の例はindexOf() を使用して、"Brave new world" という文字列において指定された値の位置を求めています。
const str = "Brave new world";console.log(str.indexOf("w")); // 8console.log(str.indexOf("new")); // 6indexOf() と 大文字と小文字の区別
以下の例は 2 つの文字列の変数を定義しています。
それらの変数は、2 番目の文字列が大文字を含んでいることを除けば、同じ文字列を含んでいます。1 番目のconsole.log() メソッドは19 を表示します。しかし、indexOf() メソッドは大文字と小文字を区別するので、"cheddar" という文字列はmyCapString では見つけられません。ですから、console.log() メソッドは-1 を表示します。
const myString = "brie, pepper jack, cheddar";const myCapString = "Brie, Pepper Jack, Cheddar";console.log(myString.indexOf("cheddar")); // 19console.log(myCapString.indexOf("cheddar")); // -1indexOf() を使って文字列中である文字が現れる回数を数える
以下の例は、count に、str という文字列中でe という文字が出現する回数を設定します。
const str = "To be, or not to be, that is the question.";let count = 0;let position = str.indexOf("e");while (position !== -1) { count++; position = str.indexOf("e", position + 1);}console.log(count); // 4仕様書
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-string.prototype.indexof |