ECMAScript 2016 中的 String.prototype.codePointAt() 方法的使用及常见错误-JavaScript中文网-JavaScript教程资源分享门户

在 ECMAScript 2016 中，新增了 String.prototype.codePointAt() 方法，用于返回给定位置的字符的 Unicode 编码点。这个方法在处理 Unicode 字符串时非常有用，但是在使用时也有一些需要注意的地方。

方法的语法和参数

String.prototype.codePointAt() 方法的语法如下：

str.codePointAt(pos)

其中，str 表示要处理的字符串，pos 表示要返回 Unicode 编码点的位置。如果 pos 是负数或大于等于字符串长度，则返回 undefined。

方法的返回值

String.prototype.codePointAt() 方法返回给定位置字符的 Unicode 编码点。如果该位置上的字符是代理对的一部分，则返回代理对的第一个字符的编码点。

方法的示例

下面是 String.prototype.codePointAt() 方法的一些示例：

// 返回 "A" 的编码点
"A".codePointAt(0); // 65

// 返回 "𠮷" 的编码点
"𠮷".codePointAt(0); // 134071

// 返回代理对的第一个字符的编码点
"\uD834\uDF06".codePointAt(0); // 119070

常见错误

在使用 String.prototype.codePointAt() 方法时，有一些常见的错误需要注意。

错误 1：没有检查返回值是否为 `undefined`

当给定的位置超出字符串长度时，String.prototype.codePointAt() 方法会返回 undefined。如果没有检查返回值是否为 undefined，则可能会导致代码出错。

// 错误示例
const str = "hello";
const codePoint = str.codePointAt(10); // 返回 undefined
const char = String.fromCodePoint(codePoint); // 报错：Invalid code point 0

在上面的示例中，由于 pos 超出了字符串的长度，codePoint 的值为 undefined。当我们使用 String.fromCodePoint() 方法将其转换为字符时，就会抛出错误。为了避免这种错误，我们应该检查 codePoint 是否为 undefined。

// 正确示例
const str = "hello";
const codePoint = str.codePointAt(10);
if (codePoint !== undefined) {
  const char = String.fromCodePoint(codePoint);
}

错误 2：没有处理代理对

在 Unicode 中，有一些字符是由两个代码单元（即两个 16 位的数字）组成的，这种字符称为代理对。当我们使用 String.prototype.codePointAt() 方法获取代理对的编码点时，会返回代理对的第一个字符的编码点。如果我们没有处理代理对，可能会导致代码出错。

// 错误示例
const str = "\uD834\uDF06"; // 代理对
const codePoint = str.codePointAt(0); // 返回第一个字符的编码点
const char = String.fromCodePoint(codePoint); // 返回一个不完整的字符

// 输出结果为：�
console.log(char);

在上面的示例中，由于没有处理代理对，String.fromCodePoint() 方法返回了一个不完整的字符。为了避免这种错误，我们应该使用 String.fromCodePoint() 方法来处理代理对。

// 正确示例
const str = "\uD834\uDF06"; // 代理对
const codePoint = str.codePointAt(0); // 返回第一个字符的编码点
const char = String.fromCodePoint(codePoint, str.codePointAt(1)); // 处理代理对

// 输出结果为：𠮷
console.log(char);

总结

String.prototype.codePointAt() 方法是处理 Unicode 字符串时非常有用的方法。在使用时，我们需要注意检查返回值是否为 undefined，以及处理代理对。如果我们能够正确使用 String.prototype.codePointAt() 方法，就可以更轻松地处理 Unicode 字符串。

来源：JavaScript中文网，转载请注明来源 https://www.javascriptcn.com/post/65097f7c95b1f8cacd43655e

ECMAScript 2016 中的 String.prototype.codePointAt() 方法的使用及常见错误