JavaScript String includes（）方法

JavaScript String includes（） 方法搜索字符串的一部分，并确定是否在原始字符串中找到指定的字符串。如果在当前字符串中找到字符串，则返回布尔值 'true'，否则返回 'false'。

这是一种区分大小写的方法，它将字符串 “hi” 和 “Hi” 视为两个不同的字符串值。它会引发 'TypeError' 异常;如果搜索字符串是正则表达式（正则表达式）。

语法

以下是 JavaScript String includes（）方法的语法 -


 includes(searchString, position)

参数

此方法接受两个参数：'searchString' 和 'position'，如下所述 -

searchString − 要搜索的字符串。
position − 搜索开始的位置。

返回值

如果在原始字符串中找到指定的字符串，则此方法返回 'true';否则为 'false'。

示例 1

如果在原始字符串中找到 searchString，此方法将返回 'true'。

在以下示例中，我们使用字符串 JavaScript includes（）方法来确定原始字符串 “Qikepu Com” 中是否存在 searchString “Qikepu Com”。


<html>
<head>
<title>JavaScript String includes() Method</title>
</head>
<body>
<script>
	 	const str = "Welcome to Qikepu Com";
	 	const searchString = "Qikepu Com";
	 	document.write("Original string: ", str);
	 	document.write("<br>Search string: ", searchString);
	 	document.write("<br>Is string '", searchString,"' found in '", str, "' or not? ", str.includes(searchString));
</script> 	 	
</body>
</html>

输出

上面的程序返回 'true'。

Original string: Welcome to Qikepu Com
Search string: Qikepu Com
Is string 'Qikepu Com' found in 'Welcome to Qikepu Com' or not? true

示例 2

如果我们将 searchString 和 position 参数都传递给此方法，它将从指定位置开始搜索 searchString。

以下是 JavaScript String includes（）方法的另一个示例。在此示例中，我们在字符串 'Hypertext Markup Language' 的起始位置 12 中搜索 searchString 'text'。


<html>
<head>
<title>JavaScript String includes() Method</title>
</head>
<body>
<script>
	 	const str = "Hypertext Markup Language";
	 	const searchString = "text";
	 	let position = 12;
	 	document.write("Original string: ", str);
	 	document.write("<br>Search string: ", searchString);
	 	document.write("<br>Position: ", position);
	 	document.write("<br>Is string '", searchString,"' found in '", str, "' or not? ", str.includes(searchString, position));
</script> 	 	
</body>
</html>

输出

执行上述程序后，返回 'false'。

Original string: Hypertext Markup Language
Search string: text
Position: 12
Is string 'text' found in 'Hypertext Markup Language' or not? false

示例 3

正如我们之前讨论的，它是一个区分大小写的方法，因此它会将 “hi” 和 “Hi” 视为两个不同的值。例如：“hi how are you”.includes（“Hi”）方法返回 'false'。


<html>
<head>
<title>JavaScript String includes() Method</title>
</head>
<body>
<script>
	 	const str = "hi how are you";
	 	const searchString = "Hi";
	 	document.write("Original string: ", str);
	 	document.write("<br>Search string: ", searchString);
	 	document.write("<br>Is string '", searchString,"' found in '", str, "' or not? ", str.includes(searchString));
</script> 	 	
</body>
</html>

输出

上述程序返回 'false'。

Original string: hi how are you
Search string: Hi
Is string 'Hi' found in 'hi how are you' or not? false

示例 4

如果 searchString 是正则表达式（正则表达式），此方法将引发 'TypeError' 异常。


<html>
<head>
<title>JavaScript String includes() Method</title>
</head>
<body>
<script>
	 	const str = "hi how are you";
	 	const searchString = /\w+/;
	 	document.write("Original string: ", str);
	 	document.write("<br>Search string: ", searchString);
	 	try {
	 	 	 document.write(str.includes(searchString));
	 	} catch (error) {
	 	 	 document.write("<br>", error);
	 	}
</script> 	 	
</body>
</html>

输出

一旦执行了上述程序，它将抛出 'TypeError' 异常。

Original string: hi how are you
Search string: /\w+/
TypeError: First argument to String.prototype.includes must not be a regular expression

打印本页

JavaScript String includes（） 方法

语法

参数

返回值

示例 1

示例 2

示例 3

示例 4

JavaScript String includes（）方法