在线文档教程

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; } }() }

规格

SpecificationStatusComment
ECMAScript 2015 (6th Edition, ECMA-262)The definition of 'String.fromCodePoint' in that specification.StandardInitial definition.
ECMAScript Latest Draft (ECMA-262)The definition of 'String.fromCodePoint' in that specification.Living Standard

浏览器兼容性

FeatureChromeEdgeFirefoxInternet ExplorerOperaSafari
Basic Support41(Yes)29No2810

FeatureAndroidChrome for AndroidEdge mobileFirefox for AndroidIE mobileOpera AndroidiOS Safari
Basic Support(Yes)(Yes)(Yes)(Yes)No(Yes)10