String.prototype.isWellFormed()
语法
isWellFormed()
返回值
如果字符串不包含单独的代理项,返回 true
,否则返回 false
。
描述
JavaScript 中的字符串是 UTF-16 编码的。UTF-16 编码中有代理对的概念,这一概念在 UTF-16 字符、Unicode 码位和字素簇(grapheme clusters)部分有详细介绍。
isWellFormed()
让你能够测试一个字符串是否是格式正确的(即不包含单独的代理项)。由于引擎能够直接访问字符串的内部表示,与自定义实现相比 isWellFormed()
更高效。如果你需要将字符串转换为格式正确的字符串,可以使用 toWellFormed()
方法。isWellFormed()
让你可以对格式正确和格式错误的字符串进行不同的处理,比如抛出一个错误或将其标记为无效。
示例
使用 isWellFormed()
const strings = [
// 单独的高位代理
"ab\uD800",
"ab\uD800c",
// 单独的低位代理
"\uDFFFab",
"c\uDFFFab",
// 格式正确
"abc",
"ab\uD83D\uDE04c",
];
for (const str of strings) {
console.log(str.isWellFormed());
}
// 输出:
// false
// false
// false
// false
// true
// true
避免 encodeURI() 错误
如果传递的字符串格式不正确, encodeURI
会抛出错误。可以通过使用 isWellFormed()
在将字符串传递给 encodeURI()
之前测试字符串来避免这种情况。
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 |
---|
Well-Formed Unicode Strings # sec-string.prototype.iswellformed |
浏览器兼容性
BCD tables only load in the browser