HTML: Markup language
CSS: Styling language
JavaScript: Scripting language
Web APIs: Programming interfaces
All web technology
Learn web development
Discover our tools
Get to know MDN better
此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。
View in English Always switch to English
This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2015年9月.
String 的 codePointAt() 方法返回一个非负整数，该整数是从给定索引开始的字符的 Unicode 码位值。请注意，索引仍然基于 UTF-16 码元，而不是 Unicode 码位。
String
codePointAt()
const icons = "☃★♲"; console.log(icons.codePointAt(1)); // Expected output: "9733"
codePointAt(index)
index
需要返回的字符的（从零开始的）索引。会被转换为整数——undefined 会转换为 0。
undefined
一个非负整数，表示给定 index 处字符的码位值。
0
str.length - 1
字符串中的字符从左到右进行索引。第一个字符的索引为 0，而字符串 str 中最后一个字符的索引为 str.length - 1。
str
Unicode 码位范围从 0 到 1114111（0x10FFFF）。在 UTF-16 中，每个字符串索引是一个取值范围为 0 – 65535 的码元。较高的码位由一个由一对 16 位代理伪字符表示。因此，codePointAt() 返回的码位可能跨越两个字符串索引。有关 Unicode 的信息，请参阅 UTF-16 字符、Unicode 码位和字素簇。
1114111
0x10FFFF
65535
"ABC".codePointAt(0); // 65 "ABC".codePointAt(0).toString(16); // 41 "😍".codePointAt(0); // 128525 "\ud83d\ude0d".codePointAt(0); // 128525 "\ud83d\ude0d".codePointAt(0).toString(16); // 1f60d "😍".codePointAt(1); // 56845 "\ud83d\ude0d".codePointAt(1); // 56845 "\ud83d\ude0d".codePointAt(1).toString(16); // de0d "ABC".codePointAt(42); // undefined
因为使用字符串索引进行循环会导致同一码位被访问两次（一次是前导代理，一次是后尾代理），而第二次调用 codePointAt() 时只返回后尾代理项，所以最好避免使用索引进行循环。
const str = "\ud83d\udc0e\ud83d\udc71\u2764"; for (let i = 0; i < str.length; i++) { console.log(str.codePointAt(i).toString(16)); } // '1f40e'、'dc0e'、'1f471'、'dc71'、'2764'
相反，可以使用 for...of 语句或字符串展开语法，这两种方法都会调用字符串的 [Symbol.iterator]()，从而按照码位进行迭代。然后，可以使用 codePointAt(0) 获取每个元素的码位值。
for...of
[Symbol.iterator]()
codePointAt(0)
for (const codePoint of str) { console.log(codePoint.codePointAt(0).toString(16)); } // '1f40e'、'1f471'、'2764' [...str].map((cp) => cp.codePointAt(0).toString(16)); // ['1f40e', '1f471', '2764']
Enable JavaScript to view this browser compatibility table.
core-js
String.prototype.codePointAt
String.fromCodePoint()
String.fromCharCode()
String.prototype.charCodeAt()
String.prototype.charAt()