From b629f0073e139214131cee90e9dfb2e75f8125e2 Mon Sep 17 00:00:00 2001 From: JasonLamv-t Date: Tue, 11 Jul 2023 14:45:51 +0800 Subject: [PATCH 1/2] [zh-cn]: Update translation of String.includes() --- .../global_objects/string/includes/index.md | 17 +++++++++++------ 1 file changed, 11 insertions(+), 6 deletions(-) diff --git a/files/zh-cn/web/javascript/reference/global_objects/string/includes/index.md b/files/zh-cn/web/javascript/reference/global_objects/string/includes/index.md index 0ebce2f598f485..003fc05e16dcf0 100644 --- a/files/zh-cn/web/javascript/reference/global_objects/string/includes/index.md +++ b/files/zh-cn/web/javascript/reference/global_objects/string/includes/index.md @@ -5,7 +5,7 @@ slug: Web/JavaScript/Reference/Global_Objects/String/includes {{JSRef}} -**`includes()`** 方法执行区分大小写的搜索，以确定是否可以在另一个字符串中找到一个字符串，并根据情况返回 `true` 或 `false`。 +**`includes()`** 方法执行区分大小写的搜索，以确定是否可以在一个字符串中找到另一个字符串，并根据情况返回 `true` 或 `false`。 {{EmbedInteractiveExample("pages/js/string-includes.html", "shorter")}} @@ -23,14 +23,19 @@ includes(searchString, position) - `position` {{optional_inline}} - : 在字符串中开始搜索 `searchString` 的位置。（默认为 `0`。） +- `searchString` + - : 一个要在 `str` 中查找的字符串。[不能是正则表达式](/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/RegExp#正则表达式的特殊处理)。所有非正则表达式的值都会被[强制转换为字符串](/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/String#字符串强制转换)，因此如果该参数被省略或传入 `undefined`，`includes()` 方法会在字符串中搜索 `"undefined"`，这通常不是你想要的。 +- `position` {{optional_inline}} + - : 在字符串中开始搜索 `searchString` 的位置。默认值为 `0`。 + ### 返回值 -如果当前字符串包含被搜寻的字符串，就返回 **`true`**，否则返回 **`false`**。 +如果在给定的字符串中找到了被搜索到字符串（包括 `searchString` 为空字符串的情况），则返回 **`true`**，否则返回 **`false`**。 ### 异常 - {{jsxref("TypeError")}} - - : 如果 `searchString` 是一个[正则表达式](/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/RegExp#special_handling_for_regexes)。 + - : 如果 `searchString` [是一个正则表达式](/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/RegExp#正则表达式的特殊处理)，则会抛出。 ## 描述 @@ -41,13 +46,13 @@ includes(searchString, position) `includes()` 方法是区分大小写的。例如，下面的表达式会返回 `false`： ```js -"Blue Whale".includes("blue"); // returns false +"Blue Whale".includes("blue"); // 返回 false ``` 你可以通过将原字符串和搜索字符串全部转换为小写来解决这个约束： ```js -"Blue Whale".toLowerCase().includes("blue"); // returns true +"Blue Whale".toLowerCase().includes("blue"); // 返回 true ``` ## 示例 @@ -75,7 +80,7 @@ console.log(str.includes("")); // true ## 参见 -- [Polyfill of `String.prototype.includes` in `core-js`](https://github.com/zloirock/core-js#ecmascript-string-and-regexp) +- [`core-js` 中 `String.prototype.includes` 的 polyfill](https://github.com/zloirock/core-js#ecmascript-string-and-regexp) - {{jsxref("Array.prototype.includes()")}} - {{jsxref("TypedArray.prototype.includes()")}} - {{jsxref("String.prototype.indexOf()")}} From ec07a832a5a32314f1ebededc6973eab3b5de2b7 Mon Sep 17 00:00:00 2001 From: Jason Lam Date: Wed, 12 Jul 2023 09:11:13 +0800 Subject: [PATCH 2/2] Apply suggestions from code review --- .../reference/global_objects/string/includes/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/files/zh-cn/web/javascript/reference/global_objects/string/includes/index.md b/files/zh-cn/web/javascript/reference/global_objects/string/includes/index.md index 003fc05e16dcf0..8a8da137995930 100644 --- a/files/zh-cn/web/javascript/reference/global_objects/string/includes/index.md +++ b/files/zh-cn/web/javascript/reference/global_objects/string/includes/index.md @@ -30,7 +30,7 @@ includes(searchString, position) ### 返回值 -如果在给定的字符串中找到了被搜索到字符串（包括 `searchString` 为空字符串的情况），则返回 **`true`**，否则返回 **`false`**。 +如果在给定的字符串中找到了要搜索的字符串（包括 `searchString` 为空字符串的情况），则返回 **`true`**，否则返回 **`false`**。 ### 异常