在此页

• 句法
• 描述
• 范例
• 规范
• 浏览器兼容性
• 另请参阅
• 相关话题

charCodeAt() method returns an integer between 0 and 65535 representing the UTF-16 code unit at the given index.

The source for this interactive example is stored in a GitHub repository. If you'd like to contribute to the interactive examples project, please clone https://github.com/mdn/interactive-examples and send us a pull request.

The UTF-16 code unit matches the Unicode code point for code points which can be represented in a single UTF-16 code unit. If the Unicode code point cannot be represented in a single UTF-16 code unit (because its value is greater than 0xFFFF ) then the code unit returned will be the first part of a surrogate pair for the code point. If you want the entire code point value, use codePointAt() .

句法

str.charCodeAt(index)
					

参数

index

An integer greater than or equal to 0 and less than the length of the string. If index is not a number, it defaults to 0 .

返回值

A number representing the UTF-16 code unit value of the character at the given index 。若 index is out of range, charCodeAt() 返回 NaN .

描述

Unicode code points range from 0 to 1114111 (0x10FFFF ). The first 128 Unicode code points are a direct match of the ASCII character encoding. (For information on Unicode, see the JavaScript 指南 .)

注意： charCodeAt() will always return a value that is less than 65536 . This is because the higher code points are represented by a pair of (lower valued) "surrogate" pseudo-characters which are used to comprise the real character.

Because of this, in order to examine (or reproduce) the full character for individual character values of 65536 or greater, for such characters, it is necessary to retrieve not only charCodeAt( i ) , but also charCodeAt( i +1) (as if manipulating a string with two letters), or to use codePointAt( i ) instead. See examples 2 and 3 (below).

charCodeAt() 返回 NaN if the given index is less than 0 , or if it is equal to or greater than the length of the string.

Backward compatibility: In historic versions (like JavaScript 1.2) the charCodeAt() method returns a number indicating the ISO-Latin-1 codeset value of the character at the given index. The ISO-Latin-1 codeset ranges from 0 to 255 . The first 0 to 127 are a direct match of the ASCII character set.

范例

使用 charCodeAt()

The following example returns 65 , the Unicode value for A.

'ABC'.charCodeAt(0)  // returns 65
					

Fixing charCodeAt() to handle non-Basic-Multilingual-Plane characters if their presence earlier in the string is unknown

This version might be used in for loops and the like when it is unknown whether non-BMP characters exist before the specified index position.

function fixedCharCodeAt(str, idx) {
  // ex. fixedCharCodeAt('\uD800\uDC00', 0); // 65536
  // ex. fixedCharCodeAt('\uD800\uDC00', 1); // false
  idx = idx || 0;
  var code = str.charCodeAt(idx);
  var hi, low;
  // High surrogate (could change last hex to 0xDB7F
  // to treat high private surrogates
  // as single characters)
  if (0xD800 <= code && code <= 0xDBFF) {
    hi = code;
    low = str.charCodeAt(idx + 1);
    if (isNaN(low)) {
      throw 'High surrogate not followed by ' +
        'low surrogate in fixedCharCodeAt()';
    }
    return (
      (hi - 0xD800) * 0x400) +
      (low - 0xDC00) + 0x10000;
  }
  if (0xDC00 <= code && code <= 0xDFFF) { // Low surrogate
    // We return false to allow loops to skip
    // this iteration since should have already handled
    // high surrogate above in the previous iteration
    return false;
    // hi = str.charCodeAt(idx - 1);
    // low = code;
    // return ((hi - 0xD800) * 0x400) +
    //   (low - 0xDC00) + 0x10000;
  }
  return code;
}
					

Fixing charCodeAt() to handle non-Basic-Multilingual-Plane characters if their presence earlier in the string is known

function knownCharCodeAt(str, idx) {
  str += '';
  var code,
      end = str.length;
  var surrogatePairs = /[\uD800-\uDBFF][\uDC00-\uDFFF]/g;
  while ((surrogatePairs.exec(str)) != null) {
    var li = surrogatePairs.lastIndex;
    if (li - 2 < idx) {
      idx++;
    }
    else {
      break;
    }
  }
  if (idx >= end || idx < 0) {
    return NaN;
  }
  code = str.charCodeAt(idx);
  var hi, low;
  if (0xD800 <= code && code <= 0xDBFF) {
    hi = code;
    low = str.charCodeAt(idx + 1);
    // Go one further, since one of the "characters"
    // is part of a surrogate pair
    return ((hi - 0xD800) * 0x400) +
      (low - 0xDC00) + 0x10000;
  }
  return code;
}
					

规范

规范
ECMAScript (ECMA-262) The definition of 'String.prototype.charCodeAt' in that specification.

浏览器兼容性

The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.

更新 GitHub 上的兼容性数据

	Desktop						Mobile						Server
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet	Node.js
charCodeAt	Chrome 1	Edge 12	Firefox 1	IE 4	Opera 4	Safari 1	WebView Android 1	Chrome Android 18	Firefox Android 4	Opera Android 10.1	Safari iOS 1	Samsung Internet Android 1.0	nodejs 0.1.100

图例

完整支持

完整支持

另请参阅

• String.fromCharCode()
• String.prototype.charAt()
• String.fromCodePoint()
• String.prototype.codePointAt()

元数据

• 最后修改： Mar 4, 2020

相关话题

1. 标准内置对象
2. String
3. 特性
   1. String 长度
4. 方法
   1. String.fromCharCode()
   2. String.fromCodePoint()
   3. String.prototype.anchor()
   4. String.prototype.big()
   5. String.prototype.blink()
   6. String.prototype.bold()
   7. String.prototype.charAt()
   8. String.prototype.charCodeAt()
   9. String.prototype.codePointAt()
   10. String.prototype.concat()
   11. String.prototype.endsWith()
   12. String.prototype.fixed()
   13. String.prototype.fontcolor()
   14. String.prototype.fontsize()
   15. String.prototype.includes()
   16. String.prototype.indexOf()
   17. String.prototype.italics()
   18. String.prototype.lastIndexOf()
   19. String.prototype.link()
   20. String.prototype.localeCompare()
   21. String.prototype.match()
   22. String.prototype.matchAll()
   23. String.prototype.normalize()
   24. String.prototype.padEnd()
   25. String.prototype.padStart()
   26. String.prototype.repeat()
   27. String.prototype.replace()
   28. String.prototype.replaceAll()
   29. String.prototype.search()
   30. String.prototype.slice()
   31. String.prototype.small()
   32. String.prototype.split()
   33. String.prototype.startsWith()
   34. String.prototype.strike()
   35. String.prototype.sub()
   36. String.prototype.substr()
   37. String.prototype.substring()
   38. String.prototype.sup()
   39. String.prototype.toLocaleLowerCase()
   40. String.prototype.toLocaleUpperCase()
   41. String.prototype.toLowerCase()
   42. String.prototype.toSource()
   43. String.prototype.toString()
   44. String.prototype.toUpperCase()
   45. String.prototype.trim()
   46. String.prototype.trimEnd()
   47. String.prototype.trimStart()
   48. String.prototype.valueOf()
   49. String.prototype[@@iterator]()
   50. String.raw()
5. 继承：
6. Function
7. 特性
   1. Function.arguments
   2. Function.caller
   3. Function.displayName
   4. Function.length
   5. Function.name
8. 方法
   1. Function.prototype.apply()
   2. Function.prototype.bind()
   3. Function.prototype.call()
   4. Function.prototype.toSource()
   5. Function.prototype.toString()
9. Object
10. 特性
    1. Object.prototype.__proto__
    2. Object.prototype.constructor
11. 方法
    1. Object.prototype.__defineGetter__()
    2. Object.prototype.__defineSetter__()
    3. Object.prototype.__lookupGetter__()
    4. Object.prototype.__lookupSetter__()
    5. Object.prototype.hasOwnProperty()
    6. Object.prototype.isPrototypeOf()
    7. Object.prototype.propertyIsEnumerable()
    8. Object.prototype.toLocaleString()
    9. Object.prototype.toSource()
    10. Object.prototype.toString()
    11. Object.prototype.valueOf()
    12. Object.setPrototypeOf()