String.prototype.charCodeAt()

index

반환할 문자의 0 기반 인덱스. 정수로 변환되는 원칙에 따라 undefined은 0으로 변환됩니다.

명시된 index에 있는 문자의 UTF-16 코드 단위 값를 표현하는 0 부터 65535사이의 정수입니다. 만약 index가 0부터 str.length - 1 사이의 범위를 벗어난다면 charCodeAt()은 NaN을 반환합니다.

문자열의 문자는 왼쪽에서 오른쪽으로 색인됩니다. 첫 번째 문자의 인덱스는 0이고 str이라 불리는 문자열의 마지막 문자열의 인덱스는 str.length - 1입니다.

유니코드 코드 포인트 범위는 0에서 1114111(0x10FFFF)까지입니다. 더 높은 코드 포인트는 16비트 의사 문자의 서로게이트로 표현되기 때문에 charCodeAt()은 항상 65536보다 작은 값을 반환합니다. 따라서 65535보다 큰 값을 가진 전체 문자를 얻으려면 charCodeAt(i)뿐만 아니라 charCodeAt(i + 1)도 검색하거나(두 문자로 된 문자열을 조작하는 것처럼) codePointAt(i)를 대신 사용해야 합니다. 유니코드에 대해 정보를 더 알고 싶으시면 UTF-16 문자, 유니코드 코드 포인트 그리고 그래프 클러스터를 참고하시기 바랍니다.

다음 예제는 유니코드 값 A에 해당하는 65를 반환합니다.

"ABC".charCodeAt(0); // 65 반환

charCodeAt()은 유효한 유니코드 문자가 아닌 론 서로게이트(lone surrogates)를 반환할 수 있습니다.

const str = "𠮷𠮾";
console.log(str.charCodeAt(0)); // 유효한 유니코드 문자가 아닌 55362, 혹은 d842
console.log(str.charCodeAt(1)); // 유효한 유니코드 문자가 아닌 57271, 혹은 dfb7

주어진 인덱스의 온전한 유니코드 코드 포인트를 얻기 위해서는 String.prototype.codePointAt()를 사용하세요.

const str = "𠮷𠮾";
console.log(str.codePointAt(0)); // 134071

참고: charCodeAt()을 사용하여 codePointAt()을 다시 구현하지 마세요. UTF-16 서로게이트에서 유니코드 코드 포인트로의 변환은 복잡하며 codePointAt()은 문자열의 내부 표현을 직접 사용하므로 성능이 더 우수할 수 있습니다. 필요한 경우 codePointAt()에 대한 폴리필을 설치하시기 바랍니다.

아래는 유니코드 FAQ에서 발췌한 UTF-16 코드 단위 쌍을 유니코드 코드 포인트로 변환하는 가능한 알고리즘입니다.

// constants
const LEAD_OFFSET = 0xd800 - (0x10000 >> 10);
const SURROGATE_OFFSET = 0x10000 - (0xd800 << 10) - 0xdc00;

function utf16ToUnicode(lead, trail) {
  return (lead << 10) + trail + SURROGATE_OFFSET;
}
function unicodeToUTF16(codePoint) {
  const lead = LEAD_OFFSET + (codePoint >> 10);
  const trail = 0xdc00 + (codePoint & 0x3ff);
  return [lead, trail];
}

const str = "𠮷";
console.log(utf16ToUnicode(str.charCodeAt(0), str.charCodeAt(1))); // 134071
console.log(str.codePointAt(0)); // 134071

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