String.fromCodePoint
String.fromCodePoint
静态String.fromCodePoint()
方法返回使用指定序列的代码点创建的字符串。
语法
String.fromCodePoint(num1[, ...[, numN]])
参数
num1, ..., num
_N
_A sequence of code points.
返回值
通过使用指定的代码点序列创建的字符串。
例外
RangeError
如果给出了无效的Unicode代码点(例如“RangeError
:NaN不是有效的代码点”),则会抛出A。
描述
此方法返回一个字符串,而不是一个String
对象。
由于fromCodePoint()
是静态String
方法,因此您始终将其用作String.fromCodePoint()
,而不是String
您创建的对象的方法。
例子
运用 fromCodePoint()
String.fromCodePoint(42 // "*"
String.fromCodePoint(65, 90 // "AZ"
String.fromCodePoint(0x404 // "\u0404"
String.fromCodePoint(0x2F804 // "\uD87E\uDC04"
String.fromCodePoint(194564 // "\uD87E\uDC04"
String.fromCodePoint(0x1D306, 0x61, 0x1D307) // "\uD834\uDF06a\uD834\uDF07"
String.fromCodePoint('_' // RangeError
String.fromCodePoint(Infinity // RangeError
String.fromCodePoint(-1 // RangeError
String.fromCodePoint(3.14 // RangeError
String.fromCodePoint(3e-2 // RangeError
String.fromCodePoint(NaN // RangeError
// String.fromCharCode() alone cannot get the character at such a high code point
// The following, on the other hand, can return a 4-byte character as well as the
// usual 2-byte ones (i.e., it can return a single character which actually has
// a string length of 2 instead of 1!)
console.log(String.fromCodePoint(0x2F804) // or 194564 in decimal
填充
String.fromCodePoint
方法已添加到ECMAScript 2015中,可能尚未在所有Web浏览器或环境中受支持。使用下面的代码进行polyfill:
/*! http://mths.be/fromcodepoint v0.1.0 by @mathias */
if (!String.fromCodePoint) {
(function() {
var defineProperty = (function() {
// IE 8 only supports `Object.defineProperty` on DOM elements
try {
var object = {};
var $defineProperty = Object.defineProperty;
var result = $defineProperty(object, object, object) && $defineProperty;
} catch(error) {}
return result;
}()
var stringFromCharCode = String.fromCharCode;
var floor = Math.floor;
var fromCodePoint = function() {
var MAX_SIZE = 0x4000;
var codeUnits = [];
var highSurrogate;
var lowSurrogate;
var index = -1;
var length = arguments.length;
if (!length) {
return '';
}
var result = '';
while (++index < length) {
var codePoint = Number(arguments[index]
if (
!isFinite(codePoint) || // `NaN`, `+Infinity`, or `-Infinity`
codePoint < 0 || // not a valid Unicode code point
codePoint > 0x10FFFF || // not a valid Unicode code point
floor(codePoint) != codePoint // not an integer
) {
throw RangeError('Invalid code point: ' + codePoint
}
if (codePoint <= 0xFFFF) { // BMP code point
codeUnits.push(codePoint
} else { // Astral code point; split in surrogate halves
// http://mathiasbynens.be/notes/javascript-encoding#surrogate-formulae
codePoint -= 0x10000;
highSurrogate = (codePoint >> 10) + 0xD800;
lowSurrogate = (codePoint % 0x400) + 0xDC00;
codeUnits.push(highSurrogate, lowSurrogate
}
if (index + 1 == length || codeUnits.length > MAX_SIZE) {
result += stringFromCharCode.apply(null, codeUnits
codeUnits.length = 0;
}
}
return result;
};
if (defineProperty) {
defineProperty(String, 'fromCodePoint', {
'value': fromCodePoint,
'configurable': true,
'writable': true
}
} else {
String.fromCodePoint = fromCodePoint;
}
}()
}
规格
Specification | Status | Comment |
---|---|---|
ECMAScript 2015 (6th Edition, ECMA-262)The definition of 'String.fromCodePoint' in that specification. | Standard | Initial definition. |
ECMAScript Latest Draft (ECMA-262)The definition of 'String.fromCodePoint' in that specification. | Living Standard | |
浏览器兼容性
Feature | Chrome | Edge | Firefox | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|---|
Basic Support | 41 | (Yes) | 29 | No | 28 | 10 |
Feature | Android | Chrome for Android | Edge mobile | Firefox for Android | IE mobile | Opera Android | iOS Safari |
---|---|---|---|---|---|---|---|
Basic Support | (Yes) | (Yes) | (Yes) | (Yes) | No | (Yes) | 10 |