String.prototype.toLocaleUpperCase()
الدالة String.prototype.toLocaleUpperCase() تُعيد السلسلة النصية الأصلية لكن مع تحويل محارفها إلى الحالة الكبيرة، وذلك اعتمادًا على إعدادات المحليّة (locale).
البنية العامة
str.toLocaleUpperCase()
str.toLocaleUpperCase(locale)
str.toLocaleUpperCase([locale, locale, ...])
locale
الوسيط locale يُشير إلى المحليّة (locale) التي يجب أن تُستخدَم لتحويل السلسلة النصية إلى الحالة الكبيرة. إذا أعطيت عدّة محليّات عبر مصفوفة Array فستُستخدَم أفضل محليّة متوافرة (best available locale)، والمحليّة الافتراضية هي المحليّة الحالية في نظام التشغيل.
القيمة المعادة
سلسلة نصية جديدة تُمثِّل السلسلة النصية الأصلية لكن مع تحويل محارفها إلى الحالة الكبيرة، وذلك اعتمادًا على إعدادات وضبط المحليّة.
الاستثناءات
- سيرمى الخطأ
RangeError(مع "invalid language tag: xx_yy") إذا كانت قيمة الوسيطlocaleغير صالحة. - سيرمى الخطأ
TypeError(مع "invalid element in locales argument") إذا كان أحد عناصر المصفوفة ليس نصيًا.
الوصف
تُعيد هذه الدالة قيمة السلسلة النصية بعد تحويلها إلى الحالة الكبيرة بالاعتماد على المحلية. لاحظ أنَّ هذه الدالة لا تؤثر على السلسلة النصية نفسها، وفي معظم الحالات ستُنتِج نفس ناتج الدالة toUpperCase()، لكن بعض المحليات (مثل التركية) لها ارتباطات بين المحارف الكبيرة والصغيرة بما يختلف عن الارتباطات المُعرَّفة في يونيكود، وقد تختلف النتيجة فيها.
أمثلة
استخدام toLocaleUpperCase()
'alphabet'.toLocaleUpperCase(); // 'ALPHABET'
'Gesäß'.toLocaleUpperCase(); // 'GESÄSS'
'i\u0307'.toLocaleUpperCase('lt-LT'); // 'I'
let locales = ['lt', 'LT', 'lt-LT', 'lt-u-co-phonebk', 'lt-x-lietuva'];
'i\u0307'.toLocaleUpperCase(locales); // 'I'
دعم المتصفحات
| الميزة | Chrome | Firefox | Internet Explorer | Opera | Safari |
|---|---|---|---|---|---|
| الدعم الأساسي | نعم | نعم | نعم | نعم | نعم |
مصادر ومواصفات
- مسودة المعيار ECMAScript Internationalization API 4.0.
- مسودة المعيار ECMAScript Latest Draft.
- معيار ECMAScript 2015 (6th Edition).
- معيار ECMAScript 5.1.
- معيار ECMAScript 3rd Edition .