عرض مصدر JavaScript/String/fromCodePoint

<noinclude>{{DISPLAYTITLE:<code>String.fromCodePoint()‎</code>}}</noinclude>
الدالة <code>String.fromCodePoint()‎</code> الساكنة (static) تُعيد سلسلةً نصيةً مُنشَأةً باستخدام سلسلة من قيم المحارف (code points).
==البنية العامة==
<syntaxhighlight lang="javascript">
String.fromCodePoint(num1[, ...[, numN]])

</syntaxhighlight>
=== <code>num1, ..., num''N''</code> ===
سلسلة من الأرقام التي تُمثِّل قيم المحارف (code points).

=== القيمة المعادة ===
سلسلة نصية تحتوي على محارف ترتبط بقيم المحارف المُمرَّرة إلى الدالة.

=== الاستثناءات ===
سيرمى الاستثناء <code>[[JavaScript/RangeError|RangeError]]</code> إذا مُرِّرَ قيمة محرف يونيكود غير صالحة (مثلًا: "RangeError: NaN is not a valid code point").

== الوصف ==
هذه الدالة تُعيد سلسلةً نصيةً أوليّةً ولا تُعيد كائن <code>[[JavaScript/String|String]]</code>.

لمّا كانت الدالة <code>fromCodePoint</code> هي دالةٌ ساكنة (static method) تابعةٌ للكائن <code>[[JavaScript/String|String]]</code>، فيجب عليك استخدامها دومًا بالشكل <code>String.fromCodePoint()‎</code>، إذ لا تستطيع استخدامها كجزء من كائن <code>[[JavaScript/String|String]]</code> خاص بك.

== أمثلة ==
الأمثلة الآتية تُبيّن استخدام الدالة <code>fromCodePoint()‎</code>:<syntaxhighlight lang="javascript">
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
</syntaxhighlight>الدالة <code>[[JavaScript/String/fromCharCode|String.fromCharCode()‎]]</code> لا يمكنها الحصول على المحارف التي تكون قيمها أكبر من الحد الأقصى، أما المثال الآتية فسيُعيد محرفًا بطول 4-بايت، إضافةً إلى محرفين بطول 2-بايت (أي أنها ستُعيد محرفًا واحدًا الذي يُمثِّل سلسلةً نصيةً طولها 2 بدلًا من 1):<syntaxhighlight lang="javascript">
console.log(String.fromCodePoint(0x2F804));

</syntaxhighlight>

== تعويض نقص دعم المتصفحات ==
الدالة <code>String.fromCodePoint</code> أُضيفَت في معيار ECMAScript 2015 (أي ES6)، وليست مدعومةً في جميع المتصفحات بعد، لذا يمكن استخدام الشيفرة الآتية لتعريفها:<syntaxhighlight lang="javascript">
/*! 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;
    }
  }());
}
</syntaxhighlight>

== دعم المتصفحات ==
{| class="wikitable"
!الميزة
!|Chrome
!Firefox
!Internet Explorer
!Opera
!Safari
|-
! الدعم الأساسي
|41
|29
|غير مدعومة
|28
|10
|}
على النقيض من متصفح IE، يدعم متصفح Edge هذه الميزة.

== مصادر ومواصفات ==
* مسودة المعيار [https://tc39.github.io/ecma262/#sec-string.fromcodepoint ECMAScript Latest Draft].
* معيار [http://www.ecma-international.org/ecma-262/6.0/#sec-string.fromcodepoint ECMAScript 2015 (6th Edition)]‎. 
[[تصنيف:JavaScript]]
[[تصنيف:JavaScript Global Objects]]
[[تصنيف:JavaScript String]]