Array.prototype.includes() - 配列にある要素が含まれているか確認する

2017/09/26

Array.prototype.includes()は、配列に指定した要素が存在するか検索するメソッドです。ヒットした場合はtrue、しなかった場合はfalseが返ります。

概要

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

説明

Array.prototype.includes ( searchElement [ , fromIndex ] )

第1引数(searchElement)に、検索したい値を指定します。

第2引数(fromIndex)には、検索を開始するインデックス番号を指定します。このインデックス番号よりも前方にある値は無視されます。

デモ

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

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

<!DOCTYPE html>
<html>
<head>
	<style>
body {
	white-space: pre-wrap ;
}
	</style>
</head>
<body>
<script>
/** try it! **/
var array = [ "S", "Y", "N", "C", "E", "R", ] ;

var a = array.includes( "N" ) ;
var b = array.includes( "W" ) ;
var c = array.includes( "N", 3 ) ;
/** try it! **/

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

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