String.prototype.isWellFormed()

Baseline2023

Since October 2023, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.

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

구문

isWellFormed()

반환 값

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

설명

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

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

예제

isWellFormed() 사용하기

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()를 사용하여 문자열을 테스트하면 이 문제를 피할 수 있습니다.

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.}