Webエンジニア向けプログラミング解説動画をYouTubeで配信中!
▶ チャンネル登録はこちら

【Node.js24.x】String::startsWith()メソッドの使い方

startsWithメソッドの使い方について、初心者にもわかりやすく解説します。

作成日: 更新日:

基本的な使い方

startsWithメソッドは、ある文字列が別の特定の文字列で開始しているかどうかを判定する際に使用するメソッドです。Node.js環境で利用できるJavaScriptの組み込み機能であり、Stringオブジェクトのインスタンスに対して呼び出すことができます。このメソッドは、呼び出し元の文字列の先頭部分が、引数として指定された文字列と一致するかどうかを調べ、その結果をブール値(trueまたはfalse)で返します。

利用方法は、対象文字列.startsWith(検索文字列, 開始位置)の形式です。最初の引数である検索文字列には、対象文字列の先頭と比較したい文字列を指定します。例えば、「Hello World」という文字列が「Hello」で始まっているかを確認する場合、「Hello」を渡します。二番目の引数である開始位置は任意で、対象文字列のどのインデックスから検索を開始するかを指定できます。この開始位置を省略した場合、デフォルトで文字列の先頭(インデックス0)から検索が開始されます。

もし対象文字列が指定した検索文字列で始まっていればtrueが返され、そうでなければfalseが返されます。この判定は、大文字と小文字を区別して行われますのでご注意ください。ファイル名の種類を判別したり、URLのスキーム(httpやhttpsなど)を確認したり、ユーザーの入力が特定の接頭辞を持つかを検証したりするなど、文字列の先頭部分を基準にした条件分岐処理を簡潔に記述したい場合に非常に役立ちます。

構文(syntax)

const greeting = "Hello Node.js world!";
const startsWithHello = greeting.startsWith("Hello");
console.log(startsWithHello);

引数(parameters)

searchString, position = 0

  • searchString: string: 検索する文字列
  • position: number = 0: 検索を開始する位置を指定する数値(省略可能、デフォルトは0)

戻り値(return)

boolean

指定された文字列が、この文字列の先頭で始まるかどうかを示す真偽値(trueまたはfalse)を返します。

関連コンテンツ

関連プログラミング言語