SYNCERのロゴ
アイキャッチ画像

String.prototype.includes() - 文字を含むか否かを確認する

String.prototype.includes()は、元の文字列が引数で指定した文字列を含むか否かを確認するメソッドです。大文字、小文字は区別されます。

概要

名前
includes
所属
String.prototype
仕様書
https://tc39.github.io/ecma262/#sec-string.prototype.includes

説明

String.prototype.includes ( searchString [ , position ] )

第1引数(searchString)には、検索対象の文字列を指定する。

第2引数(position)には、任意で検索を開始する位置を指定する。これより前は検索対象外となる。位置は区切り線をどこに入れるかで考えると分かりやすい。負の数は指定できない。

文字列が含まれている場合はtrue、それ以外はfalseが返る。

開始位置の指定
開始位置の指定

デモ

String.prototype.includes()のデモです。

<!-- このコードは編集できます。 -->

<!DOCTYPE html>
<html>
<head>
	<style>
body {
	white-space: pre-wrap ;
}
	</style>
</head>
<body>
<script>
/** try it! **/
var string = "SYNCER" ;

var a = string.includes( "NCE" ) ;
var b = string.includes( "CER" ) ;
var c = string.includes( "nce" ) ;
var d = string.includes( "NCE", 3 ) ;
var e = string.includes( "CER", 3 ) ;
/** try it! **/

var results = { a:a, b:b, c:c, d:d, e:e, } ;

for( var name in results ) {
	console.log( name, results[name] ) ;
	document.body.appendChild( new Text( name + " = " + JSON.stringify( results[name] ) + "\n" ) ) ;
}
</script>
</body>
</html>

サポート状況

ChromeFirefoxSafariEdgeIEOperaiOS SafariAndroid
41+ 40+ 9.1+× 28+ 9.1+×
  • Twitterでシェア
  • Facebookでシェア
  • Google+でシェア
  • はてなブックマークでシェア
  • pocketに保存
  • LINEでシェア
更新履歴
2017年9月29日 (金)
コンテンツを公開しました。