【Node.js24.x】String::endsWith()メソッドの使い方
endsWithメソッドの使い方について、初心者にもわかりやすく解説します。
基本的な使い方
endsWithメソッドは、ある文字列が特定の文字列で終わっているかどうかを判定するメソッドです。Node.jsのStringクラスに組み込まれている標準機能であり、JavaScriptの文字列インスタンスから利用できます。
このメソッドは、呼び出し元の文字列の末尾が、引数として指定されたsearchString(検索対象の文字列)と一致するかどうかを調べます。例えば、ファイル名が「.txt」で終わるかどうかを判定したり、URLのパスが特定のサフィックスを持つかどうかを確認したりする際などに便利です。
戻り値は真偽値(boolean)で、文字列がsearchStringで終わっていればtrueを、そうでなければfalseを返します。この判定は大文字と小文字を区別して行われます。
また、このメソッドはオプションで第二引数lengthを受け取ります。lengthは数値で、呼び出し元の文字列のうち、検索を終了する位置(文字列の長さ)を指定します。例えば、文字列「apple pie」に対してlengthを5と指定した場合、メソッドは「apple」という部分文字列がsearchStringで終わるかどうかを判定します。このlength引数を省略した場合、検索対象は文字列全体の長さとなります。
システム開発において、ファイルやデータの検証、ユーザー入力のチェック、文字列処理の条件分岐など、さまざまな場面で文字列の末尾を効率的に確認するために活用される非常に有用なメソッドです。
構文(syntax)
1const myString = "Hello Node.js"; 2console.log(myString.endsWith("Node.js"));
引数(parameters)
searchString, endPosition = this.length
- searchString: string: 検索する文字列
- endPosition: number = this.length: 検索の終了位置を示す数値。指定しない場合は文字列の末尾が検索の終了位置となります。
戻り値(return)
boolean
指定された文字列で終わる場合にtrue、そうでない場合にfalseを返します。