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

<noinclude>{{DISPLAYTITLE:<code>String.prototype.normalize()‎</code>}}</noinclude>
الدالة <code>String.prototype.normalize()‎</code> تُعيد صيغة Unicode Normalization Form للسلسلة النصية المعطاة.
==البنية العامة==
<syntaxhighlight lang="javascript">
str.normalize([form])

</syntaxhighlight>
=== <code>form</code> ===
إحدى القيم <code>"NFC"</code> أو <code>"NFD"</code> أو <code>"NFKC"</code> أو <code>"NFKD"</code>، التي تُحدِّد صيغة Unicode Normalization Form، وإذا لم تُحدَّد أو كانت <code>[[JavaScript/undefined|undefined]]</code> فستُستخدَم القيمة <code>"NFC"</code>:
* <code>NFC‏</code> — Normalization Form Canonical Composition.
* <code>NFD</code> ‏— Normalization Form Canonical Decomposition.
* <code>NFKC</code> ‏— Normalization Form Compatibility Composition.
* <code>NFKD</code> ‏— Normalization Form Compatibility Decomposition.

=== القيمة المعادة ===
سلسلة نصية تحتوي على صيغة Unicode Normalization Form من السلسلة النصية المعطاة.

=== الاستثناءات ===
سيُرمى الاستثناء <code>[[JavaScript/RangeError|RangeError]]</code> إذا لم تكن قيمة الوسيط <code>form</code> من بين القيم المذكورة أعلاه.

== أمثلة ==

=== استخدام <code>normalize()‎</code> ===
<syntaxhighlight lang="javascript">
// Initial string

// U+1E9B: LATIN SMALL LETTER LONG S WITH DOT ABOVE
// U+0323: COMBINING DOT BELOW
var str = '\u1E9B\u0323';


// Canonically-composed form (NFC)

// U+1E9B: LATIN SMALL LETTER LONG S WITH DOT ABOVE
// U+0323: COMBINING DOT BELOW
str.normalize('NFC'); // '\u1E9B\u0323'
str.normalize();      // same as above


// Canonically-decomposed form (NFD)

// U+017F: LATIN SMALL LETTER LONG S
// U+0323: COMBINING DOT BELOW
// U+0307: COMBINING DOT ABOVE
str.normalize('NFD'); // '\u017F\u0323\u0307'


// Compatibly-composed (NFKC)

// U+1E69: LATIN SMALL LETTER S WITH DOT BELOW AND DOT ABOVE
str.normalize('NFKC'); // '\u1E69'


// Compatibly-decomposed (NFKD)

// U+0073: LATIN SMALL LETTER S
// U+0323: COMBINING DOT BELOW
// U+0307: COMBINING DOT ABOVE
str.normalize('NFKD'); // '\u0073\u0323\u0307'
</syntaxhighlight>

== دعم المتصفحات ==
{| class="wikitable"
!الميزة
!|Chrome
!Firefox
!Internet Explorer
!Opera
!Safari
|-
! الدعم الأساسي
|نعم
|نعم
|نعم
|نعم
|نعم
|}
== مصادر ومواصفات ==
* مسودة المعيار [https://tc39.github.io/ecma262/#sec-string.prototype.normalize ECMAScript Latest Draft].
* معيار [http://www.ecma-international.org/ecma-262/6.0/#sec-string.prototype.normalize ECMAScript 2015 (6th Edition)]‎. 
[[تصنيف:JavaScript|{{SUBPAGENAME}}]]
[[تصنيف:JavaScript Global Objects|{{SUBPAGENAME}}]]
[[تصنيف:JavaScript String|{{SUBPAGENAME}}]]