[zh-cn]: Update translation of String.subString() (#15091)

Co-authored-by: A1lo <[email protected]>

files/zh-cn/web/javascript/reference/global_objects/string/substring/index.md

@@ -5,92 +5,129 @@ slug: Web/JavaScript/Reference/Global_Objects/String/substring
 
 {{JSRef}}
 
-**`substring()`** 方法返回一个字符串在开始索引到结束索引之间的一个子集，或从开始索引直到字符串的末尾的一个子集。
+{{jsxref("String")}} 的 **`substring()`** 方法返回该字符串从起始索引到结束索引（不包括）的部分，如果未提供结束索引，则返回到字符串末尾的部分。
+
+{{EmbedInteractiveExample("pages/js/string-substring.html")}}
 
 ## 语法
 
-```plain
-str.substring(indexStart[, indexEnd])
+```js-nolint
+substring(indexStart)
+substring(indexStart, indexEnd)
 ```
 
 ### 参数
 
 - `indexStart`
-  - : 需要截取的第一个字符的索引，该索引位置的字符作为返回的字符串的首字母。
-- `indexEnd`
-  - : 可选。一个 0 到字符串长度之间的整数，以该数字为索引的字符不包含在截取的字符串内。
+  - : 返回子字符串中第一个要包含的字符的索引。
+- `indexEnd` {{optional_inline}}
+  - : 返回子字符串中第一个要排除的字符的索引。
 
 ### 返回值
 
 包含给定字符串的指定部分的新字符串。
 
 ## 描述
 
-`substring` 提取从 `indexStart` 到 `indexEnd`（不包括）之间的字符。特别地：
+`substring()` 方法从 `indexStart` 开始提取字符，直到（_但不包括_）`indexEnd`。具体来说：
+
+- 如果省略了 `indexEnd`，则 `substring()` 提取字符直到字符串的末尾。
+- 如果 `indexStart` 等于 `indexEnd`，则 `substring()` 返回一个空字符串。
+- 如果 `indexStart` 大于 `indexEnd`，则 `substring()` 的效果就像交换了这两个参数一样；请参考下面的示例。
 
-- 如果 `indexStart` 等于 `indexEnd`，`substring` 返回一个空字符串。
-- 如果省略 `indexEnd`，`substring` 提取字符一直到字符串末尾。
-- 如果任一参数小于 0 或为 {{jsxref("NaN")}}，则被当作 0。
-- 如果任一参数大于 `stringName.length`，则被当作 `stringName.length`。
-- 如果 `indexStart` 大于 `indexEnd`，则 `substring` 的执行效果就像两个参数调换了一样。见下面的例子。
+任何小于 `0` 或大于 `str.length` 的参数值都会被视为分别等于 `0` 和 `str.length`。
+
+任何值为 {{jsxref("NaN")}} 的参数将被视为等于 `0`。
 
 ## 示例
 
-### 示例：使用 `substring`
+### 使用 substring()
 
-下例使用 `substring` 输出字符串 "`Mozilla`" 中的字符：
+下例使用 `substring` 输出字符串 `"Mozilla"` 中的字符：
 
 ```js
-var anyString = "Mozilla";
+const anyString = "Mozilla";
+
+console.log(anyString.substring(0, 1)); // 'M'
+console.log(anyString.substring(1, 0)); // 'M'
+
+console.log(anyString.substring(0, 6)); // 'Mozill'
+
+console.log(anyString.substring(4)); // 'lla'
+console.log(anyString.substring(4, 7)); // 'lla'
+console.log(anyString.substring(7, 4)); // 'lla'
+
+console.log(anyString.substring(0, 7)); // 'Mozilla'
+console.log(anyString.substring(0, 10)); // 'Mozilla'
+```
 
-// 输出 "Moz"
-console.log(anyString.substring(0, 3));
-console.log(anyString.substring(3, 0));
-console.log(anyString.substring(3, -3));
-console.log(anyString.substring(3, NaN));
-console.log(anyString.substring(-2, 3));
-console.log(anyString.substring(NaN, 3));
+### 调用 substring() 时使用 length 属性
 
-// 输出 "lla"
-console.log(anyString.substring(4, 7));
-console.log(anyString.substring(7, 4));
+以下示例使用 `substring()` 方法和 {{jsxref("String/length", "length")}} 属性来提取特定字符串的最后字符。这种方法可能更容易记住，因为你不需要像上面的示例那样知道起始和结束索引。
 
-// 输出 ""
-console.log(anyString.substring(4, 4));
+```js
+const text = "Mozilla";
 
-// 输出 "Mozill"
-console.log(anyString.substring(0, 6));
+// 获取字符串的最后 4 个字符
+console.log(text.substring(text.length - 4)); // 打印“illa”
 
-// 输出 "Mozilla"
-console.log(anyString.substring(0, 7));
-console.log(anyString.substring(0, 10));
+// 获取字符串的最后 5 个字符
+console.log(text.substring(text.length - 5)); // 打印“zilla”
 ```
 
-### 运用 length 属性来使用 substring()
+### substring() 和 substr() 之间的区别
+
+`substring()` 和 {{jsxref("String/substr", "substr()")}} 方法之间存在细微差别，因此你应该小心不要混淆它们。
+
+- `substr()` 方法的两个参数是 `start` 和 `length`，而 `substring()` 方法的参数是 `start` 和 `end`。
+- 如果 `substr()` 的 `start` 索引为负数，它将循环到字符串的末尾，而 `substring()` 会将其限制为 `0`。
+- 在 `substr()` 中，如果长度为负数，将被视为零；而在 `substring()` 中，如果 `end` 小于 `start` ，则会交换这两个索引。
 
-下面一个例子运用了 String.length 属性去获取指定字符串的倒数元素。显然这个办法更容易记住，因为你不再像上面那个例子那样去记住起始位置和最终位置。
+此外，`substr()` 被认为是 ECMAScript 中的*遗留特性*，因此如果可能的话最好避免使用它。
 
 ```js
-// Displays 'illa' the last 4 characters
-var anyString = "Mozilla";
-var anyString4 = anyString.substring(anyString.length - 4);
-console.log(anyString4);
-
-// Displays 'zilla' the last 5 characters
-var anyString = "Mozilla";
-var anyString5 = anyString.substring(anyString.length - 5);
-console.log(anyString5);
+const text = "Mozilla";
+console.log(text.substring(2, 5)); // "zil"
+console.log(text.substr(2, 3)); // "zil"
 ```
 
-### 示例：替换一个字符串的子字符串
+### substring() 和 slice() 之间的区别
 
-下例替换了一个字符串中的子字符串。可以替换单个字符和子字符串。该例结尾调用的函数将 "`Brave New World`" 变成了 "`Brave New Web`"。
+`substring()` 和 {{jsxref("String/slice", "slice()")}} 方法几乎相同，但在处理负数参数时有一些细微差别。
+
+`substring()` 方法在 `indexStart` 大于 `indexEnd` 的情况下会交换它的两个参数，这意味着仍会返回一个字符串。而 {{jsxref("String/slice", "slice()")}} 方法在这种情况下返回一个空字符串。
 
 ```js
+const text = "Mozilla";
+console.log(text.substring(5, 2)); // "zil"
+console.log(text.slice(5, 2)); // ""
+```
+
+如果两个参数中的任何一个或两个都是负数或 `NaN`，`substring()` 方法将把它们视为 `0`。
+
+```js
+console.log(text.substring(-5, 2)); // "Mo"
+console.log(text.substring(-5, -2)); // ""
+```
+
+`slice()` 方法也将 `NaN` 参数视为 `0`，但当给定负值时，它会从字符串的末尾开始反向计数以找到索引。
+
+```js
+console.log(text.slice(-5, 2)); // ""
+console.log(text.slice(-5, -2)); // "zil"
+```
+
+请参阅 {{jsxref("String/slice", "slice()")}} 页面以获取更多关于负数的示例。
+
+### 替换字符串中的子字符串
+
+以下示例替换字符串中的子字符串。它可以替换单个字符和子字符串。示例的最后一个函数调用将字符串 `Brave New World` 更改为 `Brave New Web`。
+
+```js
+// 将字符串 fullS 中的 oldS 替换为 newS
 function replaceString(oldS, newS, fullS) {
-  // Replaces oldS with newS in the string fullS
-  for (var i = 0; i < fullS.length; i++) {
-    if (fullS.substring(i, i + oldS.length) == oldS) {
+  for (let i = 0; i < fullS.length; ++i) {
+    if (fullS.substring(i, i + oldS.length) === oldS) {
       fullS =
         fullS.substring(0, i) +
         newS +
@@ -103,15 +140,17 @@ function replaceString(oldS, newS, fullS) {
 replaceString("World", "Web", "Brave New World");
 ```
 
-需要注意的是，如果 `oldS` 是 `newS` 的子字符串将会导致死循环。例如，尝试把 "Web" 替换成 "OtherWorld"。一个更好的方法如下：
+请注意，如果 `oldS` 本身是 `newS` 的子字符串，这可能导致无限循环，例如，假如你尝试在此处用 `"OtherWorld"` 替换 `"World"`。
+
+替换字符串的更好方法如下：
 
 ```js
 function replaceString(oldS, newS, fullS) {
   return fullS.split(oldS).join(newS);
 }
 ```
 
-上面的代码只是子字符串操作的一个例子。如果你需要替换子字符串，更多时候会用到 {{jsxref("String.prototype.replace()")}}。
+上面的代码仅作为子字符串操作的示例。如果你需要替换子字符串，大多数情况下你会想要使用 {{jsxref("String.prototype.replace()")}} 函数。
 
 ## 规范