From f3566feea07519362d1437b52493e9ebd77401fc Mon Sep 17 00:00:00 2001 From: JasonLamv-t Date: Thu, 17 Aug 2023 15:54:20 +0800 Subject: [PATCH 1/2] [zh-cn]: Update translation of String.WellFormed() --- .../global_objects/string/iswellformed/index.md | 12 ++++++------ .../global_objects/string/towellformed/index.md | 14 +++++++------- 2 files changed, 13 insertions(+), 13 deletions(-) diff --git a/files/zh-cn/web/javascript/reference/global_objects/string/iswellformed/index.md b/files/zh-cn/web/javascript/reference/global_objects/string/iswellformed/index.md index 1303d3eddbb801..4a3128c95a8216 100644 --- a/files/zh-cn/web/javascript/reference/global_objects/string/iswellformed/index.md +++ b/files/zh-cn/web/javascript/reference/global_objects/string/iswellformed/index.md @@ -5,7 +5,7 @@ slug: Web/JavaScript/Reference/Global_Objects/String/isWellFormed {{JSRef}} -{{jsxref("String")}} 值的 **`isWellFormed()`** 方法返回一个表示该字符串是否包含[单独的代理项](/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/String#utf-16_字符、unicode_码位和字素簇（grapheme_clusters）)的布尔值。 +{{jsxref("String")}} 值的 **`isWellFormed()`** 方法返回一个表示该字符串是否包含[单独代理项](/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/String#utf-16_字符、unicode_码位和字素簇)的布尔值。 ## 语法 @@ -15,13 +15,13 @@ isWellFormed() ### 返回值 -如果字符串不包含单独的代理项，返回 `true`，否则返回 `false`。 +如果字符串不包含单独代理项，返回 `true`，否则返回 `false`。 ## 描述 -JavaScript 中的字符串是 UTF-16 编码的。UTF-16 编码中有*代理对*的概念，这一概念在 [UTF-16 字符、Unicode 码位和字素簇（grapheme clusters）](/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/String#utf-16_字符、unicode_码位和字素簇（grapheme_clusters）)部分有详细介绍。 +JavaScript 中的字符串是 UTF-16 编码的。UTF-16 编码中有*代理对*的概念，这一概念在 [UTF-16 字符、Unicode 码位和字素簇（grapheme clusters）](/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/String#utf-16_字符、unicode_码位和字素簇)部分有详细介绍。 -`isWellFormed()` 让你能够测试一个字符串是否是格式正确的（即不包含单独的代理项）。由于引擎能够直接访问字符串的内部表示，与自定义实现相比 `isWellFormed()` 更高效。如果你需要将字符串转换为格式正确的字符串，可以使用 {{jsxref("String/toWellFormed", "toWellFormed()")}} 方法。`isWellFormed()` 让你可以对格式正确和格式错误的字符串进行不同的处理，比如抛出一个错误或将其标记为无效。 +`isWellFormed()` 让你能够测试一个字符串是否是格式正确的（即不包含单独代理项）。由于引擎能够直接访问字符串的内部表示，与自定义实现相比 `isWellFormed()` 更高效。如果你需要将字符串转换为格式正确的字符串，可以使用 {{jsxref("String/toWellFormed", "toWellFormed()")}} 方法。`isWellFormed()` 让你可以对格式正确和格式错误的字符串进行不同的处理，比如抛出一个错误或将其标记为无效。 ## 示例 @@ -29,10 +29,10 @@ JavaScript 中的字符串是 UTF-16 编码的。UTF-16 编码中有*代理对* ```js const strings = [ - // 单独的高位代理 + // 单独的前导代理 "ab\uD800", "ab\uD800c", - // 单独的低位代理 + // 单独的后尾代理 "\uDFFFab", "c\uDFFFab", // 格式正确 diff --git a/files/zh-cn/web/javascript/reference/global_objects/string/towellformed/index.md b/files/zh-cn/web/javascript/reference/global_objects/string/towellformed/index.md index 4a4165eff7e807..f585e35351b930 100644 --- a/files/zh-cn/web/javascript/reference/global_objects/string/towellformed/index.md +++ b/files/zh-cn/web/javascript/reference/global_objects/string/towellformed/index.md @@ -5,7 +5,7 @@ slug: Web/JavaScript/Reference/Global_Objects/String/toWellFormed {{JSRef}} -{{jsxref("String")}} 值的 **`toWellFormed()`** 方法返回一个新字符串，原字符串中所有[单独的代理项](/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/String#utf-16_字符、unicode_码位和字素簇（grapheme_clusters）)在新字符串中会被替换为 Unicode 替换字符 U+FFFD。 +{{jsxref("String")}} 的 **`toWellFormed()`** 方法返回一个字符串，其中该字符串的所有[单独代理项](/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/String#utf-16_字符、unicode_码位和字素簇)都被替换为 Unicode 替换字符 U+FFFD。 ## 语法 @@ -15,15 +15,15 @@ toWellFormed() ### 返回值 -新的字符串是原字符串的一个拷贝，其中所有的单独的代理项被替换为 Unicode 替换字符 U+FFFD。如果 `str` [是格式正确的](/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/String/isWellFormed)，仍然会返回一个新字符串（本质上是 `str` 的一个拷贝）。 +新的字符串是原字符串的一个拷贝，其中所有的单独代理项被替换为 Unicode 替换字符 U+FFFD。如果 `str` [是格式正确的](/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/String/isWellFormed)，仍然会返回一个新字符串（本质上是 `str` 的一个拷贝）。 ## 描述 -JavaScript 中的字符串是 UTF-16 编码的。UTF-16 编码中有*代理对*的概念，这一概念在 [UTF-16 字符、Unicode 码位和字素簇（grapheme clusters）](/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/String#utf-16_字符、unicode_码位和字素簇（grapheme_clusters）)部分有详细介绍。 +JavaScript 中的字符串是 UTF-16 编码的。UTF-16 编码中有*代理对*的概念，这一概念在 [UTF-16 字符、Unicode 码位和字素簇](/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/String#utf-16_字符、unicode_码位和字素簇)部分有详细介绍。 -`toWellFormed()` 迭代字符串的码元，并将任何单独的代理项替换为 [Unicode 替换字符]() U+FFFD `�`。这确保了返回的字符串格式正确并可用于期望正确格式字符串的函数，比如 {{jsxref("encodeURI")}}。由于引擎能够直接访问字符串的内部表示，与自定义实现相比 `toWellFormed()` 更高效。 +`toWellFormed()` 迭代字符串的码元，并将任何单独代理项替换为 [Unicode 替换字符]() U+FFFD `�`。这确保了返回的字符串格式正确并可用于期望正确格式字符串的函数，比如 {{jsxref("encodeURI")}}。由于引擎能够直接访问字符串的内部表示，与自定义实现相比 `toWellFormed()` 更高效。 -当在某些上下文中使用格式不正确的字符串时，例如 {{domxref("TextEncoder")}}，它们会自动转换为使用相同替换字符的格式正确的字符串。当单独的代理项被呈现时，它们也会呈现为替换字符（一个带有问号的钻石形状）。 +当在某些上下文中使用格式不正确的字符串时，例如 {{domxref("TextEncoder")}}，它们会自动转换为使用相同替换字符的格式正确的字符串。当单独代理项被呈现时，它们也会呈现为替换字符（一个带有问号的钻石形状）。 ## 示例 @@ -31,10 +31,10 @@ JavaScript 中的字符串是 UTF-16 编码的。UTF-16 编码中有*代理对* ```js const strings = [ - // 单独的高位代理 + // 单独的前导代理 "ab\uD800", "ab\uD800c", - // 单独的低位代理 + // 单独的后尾代理 "\uDFFFab", "c\uDFFFab", // 格式正确 From 49a2b7e3ffcb6098b5110bd3fda48c9ba72954a1 Mon Sep 17 00:00:00 2001 From: Allo Date: Thu, 17 Aug 2023 19:15:10 +0800 Subject: [PATCH 2/2] align the content --- .../reference/global_objects/string/iswellformed/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/files/zh-cn/web/javascript/reference/global_objects/string/iswellformed/index.md b/files/zh-cn/web/javascript/reference/global_objects/string/iswellformed/index.md index 4a3128c95a8216..e5136b79007dfb 100644 --- a/files/zh-cn/web/javascript/reference/global_objects/string/iswellformed/index.md +++ b/files/zh-cn/web/javascript/reference/global_objects/string/iswellformed/index.md @@ -19,7 +19,7 @@ isWellFormed() ## 描述 -JavaScript 中的字符串是 UTF-16 编码的。UTF-16 编码中有*代理对*的概念，这一概念在 [UTF-16 字符、Unicode 码位和字素簇（grapheme clusters）](/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/String#utf-16_字符、unicode_码位和字素簇)部分有详细介绍。 +JavaScript 中的字符串是 UTF-16 编码的。UTF-16 编码中有*代理对*的概念，这一概念在 [UTF-16 字符、Unicode 码位和字素簇](/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/String#utf-16_字符、unicode_码位和字素簇)部分有详细介绍。 `isWellFormed()` 让你能够测试一个字符串是否是格式正确的（即不包含单独代理项）。由于引擎能够直接访问字符串的内部表示，与自定义实现相比 `isWellFormed()` 更高效。如果你需要将字符串转换为格式正确的字符串，可以使用 {{jsxref("String/toWellFormed", "toWellFormed()")}} 方法。`isWellFormed()` 让你可以对格式正确和格式错误的字符串进行不同的处理，比如抛出一个错误或将其标记为无效。