String.prototype.isWellFormed()

String 값의 isWellFormed() 메서드는 이 문자열에 론 서로게이트 포함 여부를 나타내는 불리언을 반환합니다.

구문

js
isWellFormed()

매개변수

없음.

반환 값

문자열이 론 서로게이트를 포함하고 있지 않으면 true를 반환하고 그렇지 않다면 false를 반환합니다.

설명

JavaScript의 문자열은 UTF-16으로 인코딩됩니다. UTF-16 인코딩에는 서로게이트 쌍이라는 개념이 있으며, 이는 UTF-16 문자, 유니코드 코드 포인트 및 문자소 클러스터 섹션에 자세히 소개되어 있습니다.

isWellFormed()를 사용하면 문자열이 잘 형성되었는지(즉, 론 서로게이트를 포함하지 않는지) 테스트할 수 있습니다. 사용자 정의 구현과 비교할 때 isWellFormed()는 엔진이 문자열의 내부 표현에 직접 접근할 수 있으므로 더 효율적입니다. 문자열을 잘 형성된 문자열로 변환해야 하는 경우 toWellFormed() 메서드를 사용하세요. isWellFormed()를 사용하면 오류를 발생시키거나 유효하지 않은 것으로 표시하는 등 잘못된 형식의 문자열을 올바른 형식의 문자열과 다르게 처리할 수 있습니다.

예제

isWellFormed() 사용하기

js
const strings = [
  // Lone leading surrogate
  "ab\uD800",
  "ab\uD800c",
  // Lone trailing surrogate
  "\uDFFFab",
  "c\uDFFFab",
  // Well-formed
  "abc",
  "ab\uD83D\uDE04c",
];

for (const str of strings) {
  console.log(str.isWellFormed());
}
// Logs:
// false
// false
// false
// false
// true
// true

encodeURI()에서 오류 피하기

전달된 문자열이 제대로 형태를 갖추지 못한 경우 encodeURI는 오류가 발생합니다. 문자열을 encodeURI()로 전달하기 전에 isWellFormed()를 사용하여 문자열을 테스트하면 이 문제를 피할 수 있습니다.

js
const illFormed = "https://example.com/search?q=\uD800";

try {
  encodeURI(illFormed);
} catch (e) {
  console.log(e); // URIError: URI malformed
}

if (illFormed.isWellFormed()) {
  console.log(encodeURI(illFormed));
} else {
  console.warn("Ill-formed strings encountered."); // Ill-formed strings encountered.
}

명세서

Specification
ECMAScript Language Specification
# sec-string.prototype.iswellformed

브라우저 호환성

BCD tables only load in the browser

같이 보기