نتائج البحث

الدالة Array.prototype.includes()‎ تُحدِّد إن كانت المصفوفة تحتوي على عنصر معيّن، وتُعيد true أو false. var array1 = [1, 2, 3]; console.log(array1.includes(2)); // true var pets = ['cat', 'dog', 'bat']; console.log(pets.includes('cat')); // true console.log(pets.includes('at')); // false البنية العامة arr.includes(searchElement[, fromIndex]) searchElement العنصر الذي نريد البحث عنه. fromIndex الفهرس الذي نريد البدء منه في البحث عن searchElement، والقيم السالبة ستؤدي إلى بدء البحث من الفهرس array.length + fromIndex تصاعديًا. القيمة الافتراضية هي 0. القيمة المعادة قيمة منطقية (Boolean). أمثلة أمثلة بسيطة عن الدالة includes [1, 2, ...

الدالة Number.prototype.toPrecision()‎ تُعيد سلسلةً نصيةً تُمثِّل العدد بدقة معيّنة. البنية العامة numObj.toPrecision([precision]) precision وسيطٌ اختياريٌ يُمثِّل عدد الأرقام المهمة. القيمة المعادة سلسلة نصيّة تُمثِّل الكائن Number بالشكل العلمي (exponential) أو مع استخدام فاصلة عشرية (fixed-point) مُقرّبًا إلى قيمة الوسيط precision. راجع صفحة الدالة Number.prototype.toFixed()‎ لشرحٍ وأمثلةٍ عن طريقة التقريب. إذا لم تُحدَّد قيمة للوسيط precision فستسلك هذه الدالة سلوك الدالة Number.prototype.toString()‎، وإذا لم تكن قيمة الوسيط precision عددًا صحيحًا فستُقرّب القيمة إلى أقرب عدد صحيح. الاستثناءات RangeError سيرمى هذا الاستثناء ...

الدالة Array.prototype.every()‎ تختبر إذا كانت جميع عناصر المصفوفة تحقق الاختبار المُحدَّد من قِبل الدالة المعنية. function isBelowThreshold(currentValue) { return currentValue < 40; } var array1 = [1, 30, 39, 29, 10, 13]; console.log(array1.every(isBelowThreshold)); // true البنية العامة arr.every(callback[, thisArg]) callback الدالة التي ستختبر كل عنصر من عناصر المصفوفة، وتقبل ثلاثة وسائط. currentValue العنصر الحالي الذي يُعالِج في المصفوفة، وهذه القيمة مطلوبة. index فهرس العنصر الحالي في المصفوفة، وهذه القيمة اختيارية. array المصفوفة التي استدعيت الدالة every عليها، وهذه القيمة اختيارية. thisArg القيمة ...

الدالة String.prototype.charAt()‎ تُعيد سلسلةً نصيةً جديدةً التي تساوي قيمتها قيمة محرف يونيكود الموجود في الفهرس المُحدَّد في السلسلة النصية. البنية العامة character = str.charAt(index) index عدد صحيح بين 0 و length -1. وإذا لم توفَّر قيمة لهذا الوسيط، فالقيمة الافتراضية هي 0، لذا سيُعاد أوّل محرف في السلسلة النصية. القيمة المعادة سلسلة نصية تُمثِّل المحرف الموجود عند الفهرس المُحدَّد، وإذا كانت قيمة الوسيط index خارج المجال المتاح فستُعاد سلسلة نصية فارغة. الوصف تُرقَّم المحارف في السلاسل النصية حسب اتجاه النص ...

الدالة String.prototype.toLocaleUpperCase()‎ تُعيد السلسلة النصية الأصلية لكن مع تحويل محارفها إلى الحالة الكبيرة، وذلك اعتمادًا على إعدادات المحليّة (locale). البنية العامة str.toLocaleUpperCase() str.toLocaleUpperCase(locale) str.toLocaleUpperCase([locale, locale, ...]) locale الوسيط locale يُشير إلى المحليّة (locale) التي يجب أن تُستخدَم لتحويل السلسلة النصية إلى الحالة الكبيرة. إذا أعطيت عدّة محليّات عبر مصفوفة Array فستُستخدَم أفضل محليّة متوافرة (best available locale)، والمحليّة الافتراضية هي المحليّة الحالية في نظام التشغيل. القيمة المعادة سلسلة نصية جديدة تُمثِّل السلسلة النصية الأصلية لكن مع تحويل محارفها إلى الحالة الكبيرة، ...

الرمز المعروف Symbol.match يُحدِّد إذا كان تعبيرٌ نمطيٌ (regular expression) يُطابِق سلسلةً نصيةً؛ وهذه الدالة تُستخدَم من الدالة String.prototype.match()‎. سمات الخاصية Symbol.match قابلة للكتابة لا قابلة للإحصاء لا قابلة للضبط لا الوصف تُستخدَم هذه الدالة أيضًا لمعرفة إن كان بالإمكان أن تسلك الكائنات سلوك التعابير النمطية؛ فمثلًا الدوال String.prototype.startsWith()‎ و String.prototype.endsWith()‎ و String.prototype.includes()‎ تتحقق إن كان أوّل وسيط هو تعبيرٌ نمطي وسترمي الاستثناء TypeError إذا لم يكن كذلك. إذا ضبطنا الرمز match إلى false فذلك سيُشير إلى أنَّه من غير ...

الرمز المعروف Symbol.iterator يُحدِّد ما هو iterator التابع للكائن، وهو يستخدم من حلقة for...of. سمات الخاصية Symbol.iterator قابلة للكتابة لا قابلة للإحصاء لا قابلة للضبط لا الوصف عند الحاجة إلى المرور (iterate) على كائن (مثل في بداية حلقة التكرار for...of)، فستستدعى الدالة ‎@@iterator دون وسائط، وسيستخدم iterator المُعاد للحصول على القيم التي سنمرّ عليها في حلقة التكرار. بعض أنواع الكائنات المُضمَّنة في اللغة تحتوي على iterator افتراضي، بينما لا يملكه غيرها (الكائن Object مثلًا)؛ الدالة ‎@@iterator الموجودة في الكائنات المُضمَّنة ...

الدالة String.prototype.substring()‎ تُعيد سلسلةً نصيةً فرعيةً من سلسلةٍ نصيةٍ أخرى والتي تقع بين فهرسين. البنية العامة str.substring(indexStart[, indexEnd]) indexStart عدد صحيح بين 0 وطول السلسلة النصية يُحدِّد فهرس بداية السلسلة المستخرجة، وسيُضمَّن المحرف الموجود عند هذا الفهرس في السلسلة النصية المُستخرَجة. indexEnd قيمةٌ اختياريةٌ، وهي عددٌ صحيحٌ بين 0 طول السلسلة النصية يُحدِّد فهرس نهاية السلسلة المُستخرَجة. لاحظ أنَّ الحرف الموجود عند هذا الفهرس لن يُضمَّن في السلسلة النصية المُستخرَجة. القيمة المعادة سلسلة نصية جديدة تحتوي على القسم المستخرج من ...

الدالة Date.prototype.getHours()‎ تعيد الساعة (0-23) للتاريخ المُحدَّد وفقًا للتوقيت المحلي. البنية العامة dateObj.getHours() القيمة المعادة عددٌ صحيحٌ يُمثِّل الساعة (من 0 إلى 23) للتاريخ المعطي وفقًا للتوقيت المحلي. أمثلة الشيفرة الآتية تُسنِد القيمة 23 إلى المتغير hours وذلك اعتمادًا على قيمة الكائن BD95 من النوع Date: var BD95 = new Date('May 21, 1995 23:15:30'); var hours = BD95.getHours(); console.log(hours); // 23 دعم المتصفحات الميزة Chrome Firefox Internet Explorer Opera Safari الدعم الأساسي نعم نعم نعم نعم نعم مصادر ومواصفات مسودة المعيار ECMAScript Latest Draft. معيار ECMAScript 2015 ...

الدالة String.prototype.localeCompare()‎ تُعيد رقمًا يُشير إذا ما كانت السلسلة النصية المُشار إليها تأتي قبل أو بعد أو بنفس ترتيب السلسلة النصية المُعطاة في ترتيبٍ معيّن. الوسيطان الجديدان locales و options يسمحان للتطبيقات بتحديد اللغة التي سيُستخدَم الترتيب الخاص بها وتخصيص سلوك هذه الدالة؛ أما الإصدارات القيمة من هذه الدالة فستتجاهل الوسيطين locales و options وسيكون المحليّة (locale) والترتيب (sort) معتمدين تمامًا على المتصفح ونظام التشغيل. البنية العامة referenceStr.localeCompare(compareString[, locales[, options]]) انظر إلى قسم دعم المتصفحات لتعرف ما هي المتصفحات التي تدعم ...

الدالة Object.prototype.__lookupSetter__()‎‎ تُعيد الدالة المرتبطة بالخاصية المعنية كدالة setter. تحذير: هذه الدالة مهملة، وعلى الرغم من أنَّ هذه الدالة موجودة في أغلبية المتصفحات، لكنها لم تُعرَّف إلا في آخر مسودة من معيار ECMAScript لأغراض التوافقية، ولا يجب أن تُستخدَم لوجود بدائل أفضل منها. البنية العامة obj.__lookupSetter__(sprop) sprop سلسلة نصية تحتوي على اسم الخاصية التي نريد إعادة دالة setter المرتبطة بها. القيمة المعادة دالة setter المرتبطة بالخاصية المُحدَّدة. الوصف إذا عُرِّفَت دالة setter على إحدى خاصيات الكائن، فمن غير الممكن الإشارة ...

الرمز المعروف Symbol.isConcatSpreadable يُستخدَم لضبط إمكانية تسطيح (flatten) أحد الكائنات إلى عناصر مصفوفة باستخدام الدالة Array.prototype.concat()‎. سمات الخاصية Symbol.isConcatSpreadable قابلة للكتابة لا قابلة للإحصاء لا قابلة للضبط لا الوصف الرمز ‎@@isConcatSpreadable (أي Symbol.isConcatSpreadable) يمكن تعريفه كخاصية تابعة مباشرةً للكائن أو كخاصية موروثة، ويحمل قيمةً منطقيةً؛ ويمكنه التحكم بسلوك المصفوفات أو الكائنات الشبيهة بالمصفوفات: لكائنات المصفوفات، السلوك الافتراضي هو نشر (spread، أو تسطيح flatten) العناصر؛ ويمكن أن يُستخدَم الرمز Symbol.isConcatSpreadable لتفادي تسطيح المصفوفة. للكائنات الشبيهة بالمصفوفات، السلوك الافتراضي هو عدم نشر ...

الدالة Array.prototype.filter()‎ تُنشِئ مصفوفةً جديدةً فيها جميع العناصر التي حققت دالة الاختبار المُمرَّرة إلى هذه الدالة. var words = ['spray', 'limit', 'elite', 'exuberant', 'destruction', 'present']; const result = words.filter(word => word.length > 6); console.log(result); // ["exuberant", "destruction", "present"] استخدام الدوال السهمية (ES6): const words = ["spray", "limit", "elite", "exuberant", "destruction", "present", "happy"]; let longWords = words.filter(word => word.length > 6); // ["exuberant", "destruction", "present"] البنية العامة var newArray = arr.filter(callback[, thisArg]) callback الدالة التي ستختبر كل عنصر من عناصر المصفوفة وستُعيد true إن أردنا الإبقاء ...

الدالة Object.defineProperty()‎ تُعرِّف خاصيةً جديدةً على كائنٍ مباشرةً، أو تُعدِّل خاصية موجودةً مسبقًا في كائنٍ ثم تُعيد هذا الكائن. البنية العامة Object.defineProperty(obj, prop, descriptor) obj الكائن الذي نريد تعريف الخاصية فيه. prop اسم الخاصية التي نريد تعريفها أو تعديلها. descriptor واصف الخاصية (property descriptor) التي ستُضاف أو تُعدَّل. القيمة المعادة الكائن الذي مُرِّرَ إلى الدالة. الوصف هذه الدالة تسمح بإضافة أو تعديل خاصية من خاصيات كائنٍ ما بدقة، إذ إنَّ إضافة الخاصيات عبر معامل الإسناد سيُنشِئ خاصياتٍ تظهر عند إحصاء ...

الدالة String.prototype.slice()‎ تستخرج قسمًا من السلسلة النصية وتُعيده كسلسلة نصية جديدة. البنية العامة str.slice(beginIndex[, endIndex]) beginIndex فهرس مكان بدء الاستخراج (يبدأ العد من الصفر)، وإذا كان سالبًا فسيعامل على أنَّه strLength + beginIndex، إذ إنَّ strLength هو طول السلسلة النصية (على سبيل المثال، إذا كان beginIndex يساوي -3 فسيعامل على أنه strLength - 3). إذا كانت قيمة المعامل beginIndex أكبر أو تساوي طول السلسلة النصية، فستُعيد هذه الدالة سلسلةً نصيةً فارغةً. endIndex وسيطٌ اختياري، وهو الفهرس الذي يلي مكان نهاية ...

الدالة Date.prototype.setUTCMinutes()‎ تضبط الدقائق (0-59) للتاريخ المُحدَّد وفقًا للتوقيت العالمي. البنية العامة dateObj.setUTCMinutes(minutesValue[, secondsValue[, msValue]]) minutesValue عددٌ صحيحٌ يُمثِّل عدد الدقائق من الوقت بين 0 و 59. secondsValue قيمةٌ اختياريةٌ، وهي عددٌ صحيحٌ يُمثِّل عدد الثواني من الوقت بين 0 و 59. msValue قيمةٌ اختياريةٌ، وهي عددٌ صحيحٌ يُمثِّل عدد الملي ثانية من الوقت بين 0 و 999. إذا حدّدت قيمةً للمعامل msValue فيجب أن تضبط قيمة secondsValue أيضًا. القيمة المعادة كم ملي ثانية قد مضت بدءًا من ‎1 January ...

الدالة Date.prototype.getMilliseconds()‎ تعيد أجزاء الثواني (0-999) للتاريخ المُحدَّد وفقًا للتوقيت المحلي. البنية العامة dateObj.getMilliseconds() القيمة المعادة عددٌ صحيحٌ يُمثِّل أجزاء الثانية (بواحدة الملي ثانية، من 0 إلى 999) للتاريخ المعطي وفقًا للتوقيت المحلي. أمثلة الشيفرة الآتية تُسنِد قيمة أجزاء الثانية بواحدة الملي ثانية للوقت الحالي إلى المتغير milliseconds: var today = new Date(); var milliseconds = today.getMilliseconds(); دعم المتصفحات الميزة Chrome Firefox Internet Explorer Opera Safari الدعم الأساسي نعم نعم نعم نعم نعم مصادر ومواصفات مسودة المعيار ECMAScript Latest Draft. معيار ...

الدالة Math.log10()‎ تعيد اللوغاريتم العشري (ذو الأساس 10) للعدد المعطي، أي لو أعادت هذه الدالة القيمة y فسيكون التعبير الرياضي 10y = x محققًا. البنية العامة Math.log10(x) x العدد التي ستُجرى عليه العملية. القيمة المعادة اللوغاريتم العشري (ذو الأساس 10) للعدد المعطي، وإذا كان العدد سالبًا فستُعاد القيمة NaN. الوصف إذا كانت قيمة الوسيط x سالبةً، فستُعيد هذه الدالة القيمة NaN دومًا. لمّا كانت الدالة log10 هي دالةٌ ساكنة (static method) تابعةٌ للكائن Math، فيجب عليك استخدامها دومًا بالشكل Math.log10(x)‎، ...

الدالة Array.prototype.reverse()‎ تعكس ترتيب المصفوفة، وأوّل عنصر في المصفوفة سيصبح آخر عنصر فيها، وآخر عنصر فيها سيصبح الأول. var a = ['one', 'two', 'three']; a.reverse(); console.log(a); // ['three', 'two', 'one'] البنية العامة a.reverse() القيمة المعادة المصفوفة المعكوسة. الوصف الدالة reverse تعكس ترتيب العناصر في المصفوفة، وتعدِّل المصفوفة نفسها وتُعيد مرجعيةً إليها. أمثلة عكس ترتيب العناصر في المصفوفة المثال الآتي يُنشِئ مصفوفةً باسم a، والتي تحتوي على ثلاثة عناصر، ثم تعكس المصفوفة؛ لاحظ أنَّ المتغير reversed (الذي أسندنا القيمة التي أعادتها الدالة ...

الدالة Array.prototype.indexOf()‎ تعيد أوّل فهرس للعنصر الموجود في الدالة والذي يساوي القيمة المُحدَّدة، أو القيمة -1 إن لم يُعثَر على مُطابَقة. var a = [2, 9, 9]; a.indexOf(2); // 0 a.indexOf(7); // -1 if (a.indexOf(7) === -1) { // العنصر غير موجود في المصفوفة } البنية العامة arr.indexOf(searchElement[, fromIndex]) searchElement العنصر الذي نريد البحث عنه. fromIndex الفهرس الذي نريد البدء منه في البحث عن searchElement، والقيم السالبة ستؤدي إلى بدء البحث من الفهرس array.length + fromIndex تصاعديًا. القيمة الافتراضية هي 0. ...

الدالة Array.prototype.keys()‎ تُعيد كائن Array Iterator جديد الذي يحتوي على كل فهرس في المصفوفة. var arr = ['a', 'b', 'c']; var iterator = arr.keys(); console.log(iterator.next()); // { value: 0, done: false } console.log(iterator.next()); // { value: 1, done: false } console.log(iterator.next()); // { value: 2, done: false } console.log(iterator.next()); // { value: undefined, done: true } البنية العامة arr.keys() القيمة المعادة كائن Array Iterator جديد. أمثلة الدالة keys لا تتجاهل الفجوات بين الفهارس var arr = ['a', , 'c']; var sparseKeys = Object.keys(arr); var denseKeys = [...arr.keys()]; console.log(sparseKeys); ...

الخاصية Error.prototype.message تُمثِّل رسالةً نصيّةً تشرح الخطأ، وهي قابلةٌ للقراءة من البشر. الوصف هذه الخاصية تحتوي على وصفٍ قصيرٍ للخطأ إن كان متوافرًا. تُستخدَم الخاصية message مع الخاصية name من الدالة Error.prototype.toString()‎ لإنشاء تمثيل نصي للخطأ. افتراضيًا، تكون قيمة الخاصية message هي سلسلةٌ نصيّةٌ فارغة، لكن يمكن تغيير قيمتها عند إنشاء الكائن Error بتمرير سلسلة نصية كأوّل معامل إلى الدالة البانية Error. أمثلة المثال الآتي يرمي خطأً خاصًا أنشأه المستخدم: var e = new Error('Could not parse input'); // e.message: ...

الدالة Math.log2()‎ تعيد اللوغاريتم الثنائي (ذو الأساس 2) للعدد المعطي، أي لو أعادت هذه الدالة القيمة y فسيكون التعبير الرياضي 2y = x محققًا. البنية العامة Math.log2(x) x العدد التي ستُجرى عليه العملية. القيمة المعادة اللوغاريتم الثنائي (ذو الأساس 2) للعدد المعطي، وإذا كان العدد سالبًا فستُعاد القيمة NaN. الوصف إذا كانت قيمة الوسيط x سالبةً، فستُعيد هذه الدالة القيمة NaN دومًا. لمّا كانت الدالة log2 هي دالةٌ ساكنة (static method) تابعةٌ للكائن Math، فيجب عليك استخدامها دومًا بالشكل Math.log2(x)‎، ...

الدالة String.prototype.toLocaleLowerCase()‎ تُعيد السلسلة النصية الأصلية لكن مع تحويل محارفها إلى الحالة الصغيرة، وذلك اعتمادًا على إعدادات المحليّة (locale). البنية العامة str.toLocaleLowerCase() str.toLocaleLowerCase(locale) str.toLocaleLowerCase([locale, locale, ...]) locale الوسيط locale يُشير إلى المحليّة (locale) التي يجب أن تُستخدَم لتحويل السلسلة النصية إلى الحالة الصغيرة. إذا أعطيت عدّة محليّات عبر مصفوفة Array فستُستخدَم أفضل محليّة متوافرة (best available locale)، والمحليّة الافتراضية هي المحليّة الحالية في نظام التشغيل. القيمة المعادة سلسلة نصية جديدة تُمثِّل السلسلة النصية الأصلية لكن مع تحويل محارفها إلى الحالة الصغيرة، ...

الدالة Date.prototype.setUTCSeconds()‎ تضبط الثواني للتاريخ المُحدَّد وفقًا للتوقيت العالمي. البنية العامة dateObj.setUTCSeconds(secondsValue[, msValue]) secondsValue عددٌ صحيحٌ يُمثِّل عدد الثواني من الوقت بين 0 و 59. msValue قيمةٌ اختياريةٌ، وهي عددٌ صحيحٌ يُمثِّل عدد الملي ثانية من الوقت بين 0 و 999. القيمة المعادة كم ملي ثانية قد مضت بدءًا من ‎1 January 1970 00:00:00 UTC للتاريخ المعطى (وستُغيّر قيمة الكائن Date أيضًا). الوصف إذا لم تُحدَّد قيمة للمعامل msValue فستُستخدَم القيمة المُعادة من الدالة  getUTCMilliseconds()‎. إذا كانت قيمة الوسيط خارج المجال المسموح، فستُحدِّث ...

الدالة Array.prototype.shift()‎ تحذف أوّل عنصر من المصفوفة وتُعيد قيمته، وهذه الدالة تُغيّر عدد عناصر (length) المصفوفة. var a = [1, 2, 3]; var b = a.shift(); console.log(a); // [2, 3] console.log(b); // 1 البنية العامة arr.shift() القيمة المعادة القيمة المحذوفة من المصفوفة، أو القيمة undefined إذا كانت المصفوفة فارغة. الوصف الدالة shift تحذف آخر عنصر من المصفوفة وتُعيد تلك القيمة إلى التعبير البرمجي الذي استدعاها؛ وإذا اُستدعيت الدالة shift على مصفوفة فارغة فستُعيد القيمة undefined. أمثلة المثال الآتي يُنشِئ مصفوفةً باسم myFish تحتوي ...

الدالة String.prototype.toUpperCase()‎ تُعيد السلسلة النصية الأصلية لكن مع تحويل محارفها إلى الحالة الكبيرة. البنية العامة str.toUpperCase() القيمة المعادة سلسلة نصية جديدة تُمثِّل السلسلة النصية الأصلية لكن مع تحويل محارفها إلى الحالة الكبيرة. الوصف تُعيد هذه الدالة قيمة السلسلة النصية بعد تحويلها إلى الحالة الكبيرة. لاحظ أنَّ هذه الدالة لا تؤثر على السلسلة النصية نفسه. أمثلة استخدام toUpperCase()‎ console.log('alphabet'.toUpperCase()); // 'ALPHABET' دعم المتصفحات الميزة Chrome Firefox Internet Explorer Opera Safari الدعم الأساسي نعم نعم نعم نعم نعم مصادر ومواصفات مسودة المعيار ...

الخاصية RegExp.prototype.sticky تُشير إذا كانت الراية "y" مضبوطةً في التعبير النمطي أم لا (أي أنَّ البحث سيبدأ من الفهرس المُشار إليه بالخاصية lastIndex التابعة للتعبير النمطي). لاحظ أنَّ الخاصية sticky تختلف من كائن RegExp إلى آخر وهي قابلة للقراءة فقط. سمات الخاصية RegExp.prototype.sticky قابلة للكتابة لا قابلة للإحصاء لا قابلة للضبط نعم الوصف قيمة الخاصية sticky هي قيمةٌ منطقيةٌ (Boolean)، إذ ستُعيد true إذا كانت الراية "y" مستخدمةً، وإلا فستُعيد false. لا يمكن تعديل قيمة هذه الخاصية مباشرةً. الراية "y" ...

الخاصية RegExp.prototype.flags تُعيد سلسلةً نصيةً تحتوي على الرايات المستخدمة في كائن التعابير النمطية سمات الخاصية RegExp.prototype.flags قابلة للكتابة لا قابلة للإحصاء لا قابلة للضبط نعم الوصف ستُرتَّب الرايات المعادة من الخاصية flags ترتيبًا هجائيًا (من اليسار إلى اليمين). مثلًا: "gimuy". أمثلة مثال عن استخدام الخاصية flags للحصول على الرايات المستخدمة في التعبير النمطي: /foo/ig.flags; // "gi" /bar/myu.flags; // "muy" تعويض دعم المتصفحات أُضيفَت هذه الخاصية في مواصفة ECMAScript 2015 (أي ES6)، وما زالت غير مدعومةٍ في جميع المتصفحات. ...

الدالة Date.prototype.toJSON()‎ تعيد تمثيلًا نصيًا للكائن Date. البنية العامة dateObj.toJSON() القيمة المعادة سلسلة نصية تُمثِّل التاريخ المعطي. الوصف استدعاء الدالة toJSON()‎ سيُعيد سلسلةً نصيةً (باستخدام الدالة toISOString()‎) تُمثِّل قيمة الكائن Date. الغرض العام من هذه الدالة هو تحويل كائنات Date لاستخدامها في صيغة JSON. أمثلة مثال استخدام الدالة toJSON()‎: var jsonDate = (new Date()).toJSON(); var backToDate = new Date(jsonDate); console.log(jsonDate); // 2017-12-10T09:00:11.999Z دعم المتصفحات الميزة Chrome Firefox Internet Explorer Opera Safari الدعم الأساسي نعم نعم 9 نعم نعم مصادر ومواصفات مسودة المعيار ...

الدالة Object.values()‎ تُعيد مصفوفةً للخاصيات القابلة للإحصاء والتابعة لأحد الكائنات مباشرةً، وبنفس الترتيب الذي توفِّره حلقة التكرار for...in (والفرق بين هذه الدالة وحلقة التكرار هو أنَّ حلقة التكرار for...in ستمرّ على الخاصيات القابلة للإحصاء والموجودة في سلسلة prototype، ولن تقتصر على الخاصيات التابعة للكائن مباشرةً). البنية العامة Object.values(obj) obj الكائن الذي نريد الحصول على قيم خاصياته القابلة للإحصاء. القيمة المعادة مصفوفة تُمثِّل قيم جميع الخاصيات القابلة للإحصاء والتابعة مباشرةً للكائن المعطي. الوصف لاحظ أنَّه في معيار ECMAScript 5 كان استعمال ...

الخاصية Math.SQRT2 تُمثِّل الجذر التربيعي للعدد 2، ويساوي تقريبًا 1.414. Math.SQRT2 = sqrt(2) ≈ 1.414 سمات الخاصية Math.SQRT2 قابلة للكتابة لا قابلة للإحصاء لا قابلة للضبط لا الوصف لمّا كانت الخاصية SQRT2 هي خاصيةٌ ساكنة (static property) تابعةٌ للكائن Math، فيجب عليك استخدامها دومًا بالشكل Math.SQRT2، إذ لا تستطيع استخدامها كجزء من كائن Math خاص بك (تذكر أنَّ الكائن Math ليس له دالةٌ بانية). أمثلة الدالة الآتية تستخدم الثابت Math.SQRT2 لإعادة الجذر التربيعي للعدد 2: function getRoot2() { return ...

الدالة Math.acos()‎ معكوس التجيب (arccosine) للعدد بواحدة الراديان. أي لو أعادت هذه الدالة العدد y الذي ينتمي إلى المجال [0 ; π] فسيكون التعبير الرياضي cos(y) = x محققًا. البنية العامة Math.acos(x) x العدد التي ستُجرى عليه العملية. القيمة المعادة معكوس التجيب (arccosine) للعدد بواحدة الراديان إذا كان بين -1 و 1، وإلا فستُعاد القيمة NaN. الوصف الدالة Math.acos(x)‎ تُعيد قيمةً عدديةً بين 0 و π إذا كانت قيمة x بين -1 و 1؛ وإذا كانت قيمة x خارج ذاك المجال، ...

الدالة Array.of()‎ تُنشِئ مصفوفةً جديدةً تحتوي على القيم المُمرَّرة إليها، بغض النظر عن عدد أو نوع تلك الوسائط. الفرق بين الدالة Array.of()‎ والدالة البانية Array هو طريقة التعامل مع الوسائط الرقمية، فالدالة Array.of(7)‎ ستُنشِئ مصفوفةً لها عنصرٌ وحيدٌ وهو 7، بينما الدالة البانية Array(7)‎ ستُنشِئ مصفوفةً فارغةً طولها (length) هو 7 (لاحظ أنَّ هذا يعني أنَّ للمصفوفة سبع خانات فارغة، لكنها لا تحتوي على القيمة undefined). Array.of(7); // [7] Array.of(1, 2, 3); // [1, ...

الدالة Date.prototype.getUTCMinutes()‎ تعيد الدقائق (0-59) للتاريخ المُحدَّد وفقًا للتوقيت العالمي. البنية العامة dateObj.getUTCMinutes() القيمة المعادة عددٌ صحيحٌ يُمثِّل الدقائق (بين 0 و 59) للتاريخ المعطي وفقًا للتوقيت العالمي. أمثلة المثال الآتي يُسنِد قسم الدقائق في التاريخ والوقت الحالي إلى المتغير minutes: var today = new Date(); var minutes = today.getUTCMinutes(); دعم المتصفحات الميزة Chrome Firefox Internet Explorer Opera Safari الدعم الأساسي نعم نعم نعم نعم نعم مصادر ومواصفات مسودة المعيار ECMAScript Latest Draft. معيار ECMAScript 2015 (6th Edition)‎. معيار ECMAScript 5.1. معيار ...

الدالة Math.pow()‎ تعيد ناتج رفع الأساس إلى قوة الأس، أي baseexponent. البنية العامة Math.pow(base, exponent) base العدد الذي يُمثِّل الأساس. exponent الأساس الذي سيُرفَع إليه العدد base. القيمة المعادة ناتج رفع الأساس إلى قوة الأس. الوصف لمّا كانت الدالة pow هي دالةٌ ساكنة (static method) تابعةٌ للكائن Math، فيجب عليك استخدامها دومًا بالشكل Math.pow(x)‎، إذ لا تستطيع استخدامها كجزء من كائن Math خاص بك (تذكر أنَّ الكائن Math ليس له دالةٌ بانية). أمثلة أمثلة عن استخدام الدالة Math.pow(x)‎ أمثلة بسيطة: ...

الدالة RegExp.prototype.toString()‎ تُعيد سلسلةً نصيةً تُمثِّل الكائن التعابير النمطية المُحدَّد. البنية العامة regexObj.toString(); القيمة المعادة سلسلة نصيّة تُمثِّل الكائن RegExp. الوصف الكائن RegExp يُعيد تعريف الدالة toString الموجودة في الكائنObject؛ فهو لا يرث الدالة Object.prototype.toString()‎. فلكائنات RegExp ستُعيد الدالة toString تمثيلًا نصيًا لكائن التعبير النمطي. أمثلة استخدام الدالة toString()‎ المثال الآتي يعرض القيمة النصية لكائن RegExp: var myExp = new RegExp('a+b+c'); console.log(myExp.toString()); // '/a+b+c/' var foo = new RegExp('bar', 'g'); console.log(foo.toString()); // '/bar/g' التعابير النمطية الفارغة وتهريب المحارف بدءًا من ECMAScript 5، لم تعد هذه الدالة تُعيد سلسلةً ...

الدالة String.prototype.toString()‎ تُعيد سلسلةً نصيةً تُمثِّل الكائن. البنية العامة str.toString() القيمة المعادة سلسلة نصية تُمثِّل الكائن. الوصف الكائن String يُعيد تعريف الدالة toString()‎ التابعة للكائن Object؛ أي أنَّه لا يرث الدالة Object.prototype.toString()‎. تُعيد الدالة toString()‎ في كائنات String تمثيلًا نصيًا للكائن، وهي نفس القيمة المُعادة من الدالة String.prototype.valueOf()‎. أمثلة استخدام toString()‎ المثال الآتي يعرض القيمة النصية لأحد كائنات String: var x = new String('Hello world'); console.log(x.toString()); // 'Hello world' دعم المتصفحات الميزة Chrome Firefox Internet Explorer Opera Safari الدعم الأساسي نعم ...

الدالة Array.isArray()‎ تُحدِّد إذا كانت القيمة المُمرَّرة إليها هي مصفوفة أم لا. Array.isArray([1, 2, 3]); // true Array.isArray({foo: 123}); // false Array.isArray('foobar'); // false Array.isArray(undefined); // false البنية العامة Array.isArray(obj) obj الكائن الذي سنختبره. القيمة المعادة true إذا كان obj مصفوفةً، وإلا فستُعاد القيمة false. أمثلة اختبار مختلف أنواع القيم // جميع القيم الآتية هي مصفوفات Array.isArray([]); Array.isArray([1]); Array.isArray(new Array()); Array.isArray(new Array('a', 'b', 'c', 'd')); Array.isArray(new Array(3)); // Array.prototype هو مصفوفة Array.isArray(Array.prototype); // جميع القيم الآتية ليست مصفوفة Array.isArray(); Array.isArray({}); Array.isArray(null); Array.isArray(undefined); Array.isArray(17); Array.isArray('Array'); Array.isArray(true); Array.isArray(false); Array.isArray({ __proto__: Array.prototype }); المعامل instanceof والدالة isArray عند ...

الخاصية Object.prototype.constructor تُعيد مرجعيةً إلى الدالة البانية Object التي تُنشِئ نسخةً (instance) من الكائن؛ لاحظ أنَّ قيمة هذه الخاصية تُشير إلى الدالة نفسها وليست سلسلةً نصيةً تحتوي على اسم الدالة؛ وتكون هذه القيمة للقراءة فقط في القيم الأوليّة مثل 1 و true و "test". الوصف جميع الكائنات تملك الخاصية constructor، والكائنات المُنشأة دون استخدام الدالة البانية مباشرةً (أي الشكل المختصرة لإنشاء الكائنات والمصفوفات) ستملك الخاصية constructor التي تُشير إلى الدالة البانية الأساسية لنوع الكائنات التي تتبع له. var o = ...

الدالة Symbol.prototype.toString()‎ تعيد سلسلةً نصيّةً تُمثِّل الكائن Symbol. البنية العامة Symbol().toString(); القيمة المعادة سلسلة نصية تمثل الكائن Symbol. الوصف يُعيد الكائن Symbol تعريف الدالة toString الموجود في الكائن Object، فهو لا يرث الدالة Object.prototype.toString()‎؛ وستُعيد الدالة toString تمثيلًا نصيًا للرمز. لا يسمح بإضافة الرموز إلى سلاسل نصية صحيحٌ أنَّ بإمكاننا استدعاء الدالة toString على الرموز، لكن لا يُسمَح بإضافة سلسلة نصية إلى رمز، وسيرمى الخطأ TypeError كما في المثال الآتي: Symbol('foo') + 'bar'; // TypeError: Can't convert symbol to string ...

الدالة Array.prototype.join()‎ تضيف جميع عناصر المصفوفة إلى بعضها بعضًا لتُشكِّل سلسلةً نصيةً، وتُعيد هذه السلسلة النصية. إذا كان عنصر المصفوفة هو null أو undefined، فسيحوّل إلى سلسلة نصية فارغة. var elements = ['Fire', 'Wind', 'Rain']; console.log(elements.join()); // Fire,Wind,Rain console.log(elements.join('')); // FireWindRain console.log(elements.join('-')); // Fire-Wind-Rain البنية العامة arr.join([separator]) separator تحديد سلسلة نصية لتفصل بين عناصر المصفوفة، وسيحوّل الفاصل إلى سلسلة نصية إن كان ذلك ضروريًا. إذا لم تُحدَّد قيمة هذا الوسيط، فسيُفصَل بين السلاسل النصية بفاصلة عادية ,، وإذا كان ...

الدالة Math.expm1()‎ تعيد القيمة ex-1، حيث x هو الوسيط المُمرَّر إلى الدالة، و e هو ثابت أولر (ويسمى أيضًا بالثابت النيبيري) وهو أساس اللوغاريتم الطبيعي. البنية العامة Math.exp(x) x العدد التي ستُجرى عليه العملية. القيمة المعادة القيمة ex-1، حيث x هو الوسيط المُمرَّر إلى الدالة، و e هو ثابت أولر. الوصف لمّا كانت الدالة expm1 هي دالةٌ ساكنة (static method) تابعةٌ للكائن Math، فيجب عليك استخدامها دومًا بالشكل Math.expm1(x)‎، إذ لا تستطيع استخدامها كجزء من كائن Math خاص بك (تذكر ...

الدالة Date.prototype.setMilliseconds()‎ تضبط أجزاء الثواني (0-999) للتاريخ المُحدَّد وفقًا للتوقيت المحلي. البنية العامة dateObj.setMilliseconds(millisecondsValue) millisecondsValue عددٌ صحيحٌ يُمثِّل أجزاء الثانية (بواحدة الملي ثانية، من 0 إلى 999). القيمة المعادة كم ملي ثانية قد مضت بدءًا من ‎1 January 1970 00:00:00 UTC للتاريخ المعطى (وستُغيّر قيمة الكائن Date أيضًا). الوصف إذا كانت قيمة الوسيط خارج المجال المسموح، فستُحدِّث الدالة setMilliseconds الكائن Date بما يتوافق مع ذلك، أو لو ضبطنا قيمة الوسيط millisecondsValue إلى 1005، فستزداد عدد الثواني بمقدار 1 وستُستخدَم القيمة 5 لجزء الملي الثانية. أمثلة مثال عن استخدام الدالة setMilliseconds()‎: var ...

الدالة RegExp.prototype.exec()‎ تجرى بحثًا عن مطابقة للتعبير النمطي في السلسلة النصية المُحدَّدة، وتُعيد مصفوفة النتائج، أو القيمة null. إذا كانتَ تريد تنفيذ البحث لمعرفة إن كانت القيمة موجودةً أم لا فاستخدام الدالة RegExp.prototype.test()‎ أو الدالة String.prototype.search()‎. البنية العامة regexObj.exec(str) str السلسلة النصية التي سنبحث عن مُطابَقة للتعبير النمطي فيها. القيمة المعادة إذا نجحت عملية المطابقة، فستُعيد الدالة exec()‎ مصفوفةً وتُحدِّث خاصيات كائن التعابير النمطية. المصفوفة المعادة ستحتوي على النص المُطابَق في أوّل عنصر فيها، ثم العناصر التي تليه ستحتوي على ...

الدالة Date.prototype.getDate()‎ تعيد اليوم من الشهر (1-31) للتاريخ المُحدَّد وفقًا للتوقيت المحلي. البنية العامة dateObj.getDate() القيمة المعادة عددٌ صحيحٌ بين 1 و 31 يُمثِّل اليوم من الشهر للتاريخ المعطي وفقًا للتوقيت المحلي. أمثلة الشيفرة الآتية تُسنِد القيمة 21 إلى المتغير day وذلك اعتمادًا على قيمة الكائن BD95 من النوع Date: var BD95 = new Date('May 21, 1995 23:15:30'); var day = BD95.getDate(); console.log(day); // 21 دعم المتصفحات الميزة Chrome Firefox Internet Explorer Opera Safari الدعم الأساسي نعم نعم نعم نعم نعم مصادر ...

الدالة Math.sin()‎ تعيد جيب (sine) العدد المعطي. البنية العامة Math.sin(x) x العدد التي ستُجرى عليه العملية بواحدة الراديان. القيمة المعادة جيب (sine) العدد المعطي. الوصف الدالة Math.sin(x)‎ تُعيد قيمةً عدديةً بين -1 و 1، والتي تُمثِّل جيب (sine) الزاوية المعطية. لمّا كانت الدالة sin هي دالةٌ ساكنة (static method) تابعةٌ للكائن Math، فيجب عليك استخدامها دومًا بالشكل Math.sin(x)‎، إذ لا تستطيع استخدامها كجزء من كائن Math خاص بك (تذكر أنَّ الكائن Math ليس له دالةٌ بانية). أمثلة أمثلة عن استخدام ...

الدالة Array.prototype.reduceRight()‎ تؤدي إلى اختزال جميع قيم المصفوفة (بدءًا من اليمين إلى اليسار) إلى قيمة واحدة. var flattened = [[0, 1], [2, 3], [4, 5]].reduceRight(function(a, b) { return a.concat(b); }, []); // [4, 5, 2, 3, 0, 1] انظر صفحة الدالة Array.prototype.reduce()‎ لاختزال القيم من اليسار إلى اليمين. البنية العامة arr.reduceRight(callback[, initialValue]) callback الدالة التي ستختبر كل عنصر من عناصر المصفوفة، وتقبل أربعة وسائط. previousValue القيمة السابقة، انظر النقاش أدناه للتفاصيل. currentValue العنصر الحالي الذي يُعالِج في المصفوفة، وهذه القيمة ...

الدالة Number.isSafeInteger()‎ تُحدِّد إذا كانت القيمة المُمرَّرة إليها هي عددٌ صحيحٌ «آمن». العدد الصحيح الآمن هو عددٌ صحيحٌ الذي: يمكن تمثيله كعدد ذي فاصلة عشرية كما في معيار IEEE 754 بدقة وأن يكون تمثيله كما في معيار IEEE 754 لا يؤدي إلى تقريب أي عدد لكي يكون مُطابِقًا للمعيار. على سبيل المثال، العدد ‎253 - 1 هو عددٌ صحيحٌ آمن، فيمكن تمثيل قيمته كما هي، ولن يُقرّب أيُّ عدد فيه لنتمكن من تمثيله في معيار IEEE 754؛ لكن على النقيض ...

الدالة Date.prototype.toLocaleString()‎ تعيد سلسلةً نصيةً صيغتها تتبع لمحليّة النظام (system locale) التي تُمثِّل الكائن Date. تسمح الوسائط locales و options الجديدة للتطبيقات بتحديد اللغة التي يجب استخدام قواعد التنسيق الخاصة بها، وتسمح بتخصيص سلوك هذه الدالة؛ لكن في الإصدارات القديمة من هذه الدالة، التي كانت تتجاهل قيمة الوسيطين locales و options، كانت ستُستخدَم المحليّة (locale) في النظام ويكون شكل السلسلة النصية المُعادة تابعًا للمتصفح ونظام التشغيل. البنية العامة dateObj.toLocaleString([locales[, options]]) انظر إلى قسم دعم المتصفحات لتعرف ما هي المتصفحات التي تدعم ...

الدالة Object.prototype.__defineSetter__()‎‎ تربط دالةً بإحدى خاصيات الكائن، وستستدعى تلك الدالة عند محاولة ضبط قيمة تلك الخاصية. تحذير: هذه الدالة مهملة ويُفتَرَض تعريف دوال setter عند تهيئة الكائنات أو باستخدام الدالة Object.defineProperty()‎، وعلى الرغم من أنَّ هذه الدالة موجودة في أغلبية المتصفحات، لكنها لم تُعرَّف إلا في آخر مسودة من معيار ECMAScript لأغراض التوافقية، ولا يجب أن تُستخدَم لوجود بدائل أفضل منها. البنية العامة obj.__defineSetter__(prop, fun) prop سلسلة نصية تحتوي على اسم الخاصية التي نريد ربط الدالة المعطية إليها. fun الدالة ...

الدالة Math.tanh()‎ تعيد الظل القطعي (hyperbolic tangent) للعدد المعطي، والذي يمكن التعبير عنه باستخدام عدد أولر (الثابت e): Math.tanh(x) = (e^x - e^-x) / (e^x + e^-x) = (e^2x - 1) / (e^2x + 1) البنية العامة Math.tanh(x) x العدد التي ستُجرى عليه العملية. القيمة المعادة الظل القطعي (hyperbolic sine) للعدد المعطي. الوصف لمّا كانت الدالة tanh هي دالةٌ ساكنة (static method) تابعةٌ للكائن Math، فيجب عليك استخدامها دومًا بالشكل Math.tanh(x)‎، إذ لا تستطيع استخدامها كجزء من كائن Math خاص ...

الدالة Object.isFrozen()‎ تُحدِّد إن كان أحد الكائنات مُجمَّدًا. البنية العامة Object.isFrozen(obj) obj الكائن الذي نريد التحقق منه. القيمة المعادة قيمة منطقية (Boolean) تبيّن إذا كان الكائن مجمَّدًا أم لا. الوصف يكون الكائن مجمدًا إذا لم يكن قابلًا للتوسعة، وكانت جميع خاصياته غير قابلة للضبط (non-configurable)، وكانت جميع خاصيات البيانات (data properties، أي الخاصيات التي ليست دوال getter و setter) غير قابلة للكتابة (non-writable). لاحظ أنَّه في معيار ECMAScript 5 كان استعمال هذه الدالة على وسيطٍ ليس كائنًا (أي قيمةً أوليةً) ...

الدالة String.prototype.padEnd()‎ تحشو السلسلة النصية الحالية من نهايتها بإضافة السلسلة النصية المُعطاة (مع تكرارها إن لزم) لإنشاء سلسلة نصية جديدة لها طول معيّن. البنية العامة str.padEnd(targetLength [, padString]) targetLength طول السلسلة النصية الناتجة بعد إضافة الحاشية، وإذا كانت القيمة أقل من طول السلسلة النصية الحالي، فستُعاد السلسلة النصية كما هي. padString السلسلة النصية التي ستُضاف إلى السلسلة النصية الحالية. وإذا كانت طويلة جدًا مما لا يجعلها تتسع في الطول المُحدَّد فستُقصّ وتُطبَّق بدايتها على السلسلة النصية الأصلية. القيمة الافتراضية لهذا ...

الدالة Date.prototype.getUTCDay()‎ تعيد اليوم من الأسبوع (0-6) للتاريخ المُحدَّد وفقًا للتوقيت العالمي، حيث تُمثِّل القيمة 0 يوم الأحد. إذا أردتَ الحصول على اليوم من الشهر فانظر إلى الدالة getUTCDate()‎. البنية العامة dateObj.getUTCDay() القيمة المعادة عددٌ صحيحٌ بين 0 و 6 يُمثِّل اليوم من الأسبوع للتاريخ المعطي وفقًا للتوقيت العالمي. مثلًا: 0 هو يوم الأحد، و 1 هو يوم الاثنين، و 2 هو يوم الثلاثاء، وهلّم جرًا. أمثلة المثال الآتي يُسنِد ترتيب اليوم في الأسبوع في التاريخ الحالي إلى المتغير weekday: var ...

الدالة String.prototype.repeat()‎ تُنشِئ سلسلةً نصيةً جديدةً تحتوي على العدد المُحدَّد من النسخ من السلسلة النصية التي استدعيت عليها، وراء بعضها بعضًا. البنية العامة str.repeat(count); count عدد صحيح بين 0 و زائد لانهاية، يُشير إلى عدد المرات التي يجب تكرار السلسلة النصية فيها لإنشاء السلسلة النصية الجديدة. القيمة المعادة سلسلة نصية التي تتألف من تكرار للسلسلة النصية المعطية لعدد مُحدَّد من المرات. الاستثناءات سيرمى الاستثناء RangeError إذا كان الوسيط المُمرَّر عددًا سالبًا. ويجب أن يكون الوسيط أقل من اللانهاية (Infinity) ولا ...

الدالة RegExp.prototype.test()‎ تجرى بحثًا عن مطابقة للتعبير النمطي في السلسلة النصية المُحدَّدة، وتُعيد true أو false. البنية العامة regexObj.test(str) str السلسلة النصية التي سنبحث عن مُطابَقة للتعبير النمطي فيها. القيمة المعادة إذا نجحت عملية المطابقة، فستُعيد الدالة test()‎ القيمة true، وإن لم يكن التعبير النمطي موجودًا في السلسلة النصية فستُعيد القيمة false. الوصف الدالة test()‎ تُحدِّد إن كان النمط موجودًا في السلسلة النصية أم لا، وستُعيد قيمة منطقيةً (Boolean)، وذلك على النقيض من الدالة String.prototype.search()‎ التي تُعيد فهرس المُطابَقة (أو ...

الدالة Object.is()‎ تُحدِّد إن كانت تملك القيمتان المُمررتان إليها نفس القيمة. البنية العامة Object.is(value1, value2); value1 القيمة الأولى التي نريد مقارنتها. value2 القيمة الثانية التي نريد مقارنتها. القيمة المعادة قيمة منطقية (Boolean) تبيّن إذا كانت القيمتان متساويتين أم لا. الوصف الدالة Object.is()‎ تُحدِّد إن كانت تملك القيمتان المُمررتان إليها نفس القيمة. ويكون للقيمتين نفس القيمة إذا كانت كلتاهما: undefined null كلتاهما true أو كلتاهما false كلتاهما عبارة عن سلسلة نصية لها الطول نفسه والمحارف نفسها تشيران إلى الكائن نفسه كلتاهما ...

الدالة Object.prototype.propertyIsEnumerable()‎ تُعيد قيمةً منطقيةً تبيّن إن كان الخاصيةُ قابلةً للإحصاء أم لا. البنية العامة obj.propertyIsEnumerable(prop) prop اسم الخاصية التي سنختبرها. القيمة المعادة قيمة منطقية Boolean تُشير إذا كانت الخاصية قابلةً للإحصاء أم لا. الوصف كل كائن ينحدر من الكائن Object يرث الدالة propertyIsEnumerable، ويمكن أن تُستخدَم هذه الدالة لتحديد إن كانت إحدى الخاصيات قابلةٌ للإحصاء وستُعرضَ في حلقة for...in؛ باستثناء الخاصيات التي يرثها الكائن من سلسلة prototype، وإذا لم يملك الكائن الخاصية المُحدَّدة فستُعيد الدالةُ القيمةَ false. أمثلة معرفة ...

الدالة Array.prototype.slice()‎ تنسخ جزءًا من المصفوفة نسخًا سطحيًا (shallow copy) إلى مصفوفة جديدًا بدءًا من الفهرس begin إلى end (دون تضمين العنصر الموجود في الفهرس end)؛ لاحظ أنَّ المصفوفة الأصلية لن تُغيّر. var animals = ['ant', 'bison', 'camel', 'duck', 'elephant']; console.log(animals.slice(2)); // ["camel", "duck", "elephant"] console.log(animals.slice(2, 4)); // ["camel", "duck"] console.log(animals.slice(1, 5)); // ["bison", "camel", "duck", "elephant"] البنية العامة arr.slice([begin[, end]]) begin فهرس بداية الاستخراج، ويبدأ العد من الفهرس 0. القيمة السالبة تُشير إلى بدء الاستخراج من نهاية المصفوفة، فالدالة slice(-2)‎ ستستخرج آخر ...

الدالة Array.prototype.unshift()‎ تضيف عنصرًا أو أكثر إلى بداية مصفوفة وتُعيد عدد عناصر (length) المصفوفة. var a = [1, 2, 3]; a.unshift(4, 5); console.log(a); // [4, 5, 1, 2, 3] البنية العامة arr.unshift(element1[, ...[, elementN]]) elementN العناصر التي ستُضاف إلى بداية المصفوفة. القيمة المعادة قيمة الخاصية length الجديدة للمصفوفة التي استدعيت هذه الدالة عليها. أمثلة var arr = [1, 2]; arr.unshift(0); // الناتج هو 3، وهو عدد عناصر المصفوفة الجديدة // arr: [0, 1, 2] arr.unshift(-2, -1); // = 5 // arr: [-2, -1, 0, 1, 2] arr.unshift([-3]); // ...

الدالة Math.log1p()‎ تعيد اللوغاريتم الطبيعي (loge) للقيمة 1 + x للعدد المعطي x. Math.log1p(x) = ln (1 + x) البنية العامة Math.log1p(x) x العدد التي ستُجرى عليه العملية. القيمة المعادة اللوغاريتم الطبيعي (ذو الأساس e) للعدد المعطي + 1، وإذا كان العدد أصغر من -1 فستُعاد القيمة NaN. الوصف لمّا كانت الدالة log1p هي دالةٌ ساكنة (static method) تابعةٌ للكائن Math، فيجب عليك استخدامها دومًا بالشكل Math.log1p(x)‎، إذ لا تستطيع استخدامها كجزء من كائن Math خاص بك (تذكر أنَّ الكائن ...

الدالة String.prototype.normalize()‎ تُعيد صيغة Unicode Normalization Form للسلسلة النصية المعطاة. البنية العامة str.normalize([form]) form إحدى القيم "NFC" أو "NFD" أو "NFKC" أو "NFKD"، التي تُحدِّد صيغة Unicode Normalization Form، وإذا لم تُحدَّد أو كانت undefined فستُستخدَم القيمة "NFC": NFC‏ — Normalization Form Canonical Composition. NFD ‏— Normalization Form Canonical Decomposition. NFKC ‏— Normalization Form Compatibility Composition. NFKD ‏— Normalization Form Compatibility Decomposition. القيمة المعادة سلسلة نصية تحتوي على صيغة Unicode Normalization Form من السلسلة النصية المعطاة. الاستثناءات سيُرمى الاستثناء RangeError ...

الخاصية arguments.length تحتوي على عدد الوسائط التي مُرِّرَت إلى الدالة. الوصف الخاصية arguments.length تمنحنا القدرة على معرفة عدد الوسائط التي مُرِّرَت إلى الدالة، وهذا العدد قد يكون أقل أو أكثر من عدد المعاملات التي عُرِّفت الدالة معها (انظر إلى صفحة الخاصية Function.length). أمثلة استخدام arguments.length سنُعرِّف في المثال الآتي دالةً تجمع عددين أو أكثر من بعضهما بعضًا: function adder(base /*, n2, ... */) { base = Number(base); for (var i = 1; i < arguments.length; i++) { ...

الدالة Date.parse()‎ تُفسِّر سلسلةً نصيّةً تحتوي على تمثيلٍ للتاريخ، وتعيد كم ملي ثانية مضت منذ ‎1 January 1970 00:00:00 UTC؛ أو القيمة NaN إذا لم يمكن التعرف على السلسلة النصية أو في بعض الحالات إذا احتوت على قيم تاريخ غير صحيحة (مثلًا: 2015‎-02-31‎). من غير المستحسن استخدام الدالة Date.parse لأنَّه قبل معيار ES5 كان تفسير السلاسل النصية يختلف من متصفح لآخر؛ وما تزال هنالك اختلافات في كيفية تفسير بعض أنواع السلاسل النصية، لذا من الأفضل تفسير السلاسل النصية يدويًا (ربما ...

الدالة Date.prototype.getUTCDate()‎ تعيد اليوم من الشهر (1-31) للتاريخ المُحدَّد وفقًا للتوقيت العالمي. البنية العامة dateObj.getUTCDate() القيمة المعادة عددٌ صحيحٌ بين 1 و 31 يُمثِّل اليوم من الشهر للتاريخ المعطي وفقًا للتوقيت العالمي. أمثلة المثال الآتي يُسنِد اليوم في التاريخ الحالي إلى المتغير day: var today = new Date(); var day = today.getUTCDate(); دعم المتصفحات الميزة Chrome Firefox Internet Explorer Opera Safari الدعم الأساسي نعم نعم نعم نعم نعم مصادر ومواصفات مسودة المعيار ECMAScript Latest Draft. معيار ECMAScript 2015 (6th Edition)‎. معيار ...

الدالة String.prototype.padStart()‎ تحشو السلسلة النصية الحالية من بدايتها بإضافة السلسلة النصية المُعطاة (مع تكرارها إن لزم) لإنشاء سلسلة نصية جديدة لها طول معيّن. البنية العامة str.padStart(targetLength [, padString]) targetLength طول السلسلة النصية الناتجة بعد إضافة الحاشية، وإذا كانت القيمة أقل من طول السلسلة النصية الحالي، فستُعاد السلسلة النصية كما هي. padString السلسلة النصية التي ستُضاف إلى السلسلة النصية الحالية. وإذا كانت طويلة جدًا مما لا يجعلها تتسع في الطول المُحدَّد فستُقصّ وتُطبَّق بدايتها على السلسلة النصية الأصلية. القيمة الافتراضية لهذا ...

الخاصية arguments.callee تشير إلى الدالة التي تُنفَّذ حاليًا. الوصف الخاصية callee التابعة للكائن arguments تُشير إلى الدالة التي تُنفَّذ حاليًا داخل جسم تلك الدالة، وهذا مفيدٌ في حال كان اسم الدالة ليس معروفًا، مثل تعابير تعريف الدوال دون اسم (يُطلَق عليها أيضًا اسم «الدوال المجهولة» [anonymous functions]). تحذير: الإصدار الخامس من ECMAScript (أي ES5) يمنع استخدام الخاصية arguments.callee في نمط strict، تفادى استخدام هذه الخاصية بإعطاء اسم لتعابير تعريف الدوال أو التصريح عن دالة باستخدام تعابير التصريح عن الدوال. أمثلة ...

الدالة Math.sqrt()‎ تعيد الجذر التربيعي للعدد، أي لو كانت قيمة الوسيط x أكبر أو تساوي الصفر، فإنَّ هذه الدالة ستُعيد القيمة y التي تكون أكبر أو تساوي الصفر والتي تُحقِّق المعادة y2 = x. البنية العامة Math.sqrt(x) x العدد التي ستُجرى عليه العملية. القيمة المعادة الجذر التربيعي للعدد المعطي، وإذا كان العدد سالبًا فستُعاد القيمة NaN. الوصف إذا كانت قيمة الوسيط x سالبةً فستُعاد القيمة NaN. لمّا كانت الدالة sqrt هي دالةٌ ساكنة (static method) تابعةٌ للكائن Math، فيجب عليك ...

الدالة Number.prototype.toExponential()‎ تُعيد سلسلةً نصيةً تُمثِّل العدد في الشكل العلمي. البنية العامة numObj.toExponential([fractionDigits]) fractionDigits وسيطٌ اختياريٌ يُمثِّل عدد الأرقام بعد الفاصلة العشرية، والسلوك الافتراضي هو استخدام أيّ عدد يلزم من الأرقام بعد الفاصلة العشرية لتحديد قيمة العدد بدقة. القيمة المعادة سلسلة نصيّة تُمثِّل الكائن Number بالشكل العلمي مع استخدام رقم واحد قبل الفاصلة العشرية، وسيُقرّب الناتج حسب قيمة fractionDigits. الاستثناءات RangeError سيرمى هذا الاستثناء إذا كانت قيمة الوسيط fractionDigits كبيرةً جدًا أو صغيرةً جدًا؛ والقيم بين 0 و 20 لن ...

الخاصية RegExp.prototype.global تُشير إذا كانت الراية "g" مضبوطةً في التعبير النمطي أم لا. لاحظ أنَّ الخاصية global تختلف من كائن RegExp إلى آخر وهي قابلة للقراءة فقط. سمات الخاصية RegExp.prototype.global قابلة للكتابة لا قابلة للإحصاء لا قابلة للضبط نعم الوصف قيمة الخاصية global هي قيمةٌ منطقيةٌ (Boolean)، إذ ستُعيد true إذا كانت الراية "g" مستخدمةً، وإلا فستُعيد false. لا يمكن تعديل قيمة هذه الخاصية مباشرةً. الراية "g" تُشير إلى أنَّ التعبير النمطي يجب أن يُختَبَر على جميع المطابقات المُمكنة في ...

الخاصية Math.LN2 تُمثِّل اللوغاريتم الطبيعي للعدد 2، ويساوي تقريبًا 0.693. Math.LN2 = ln(2) ≈ 0.693 سمات الخاصية Math.LN2 قابلة للكتابة لا قابلة للإحصاء لا قابلة للضبط لا الوصف لمّا كانت الخاصية LN2 هي خاصيةٌ ساكنة (static property) تابعةٌ للكائن Math، فيجب عليك استخدامها دومًا بالشكل Math.LN2، إذ لا تستطيع استخدامها كجزء من كائن Math خاص بك (تذكر أنَّ الكائن Math ليس له دالةٌ بانية). أمثلة الدالة الآتية تُعيد قيمة اللوغاريتم الطبيعي للعدد 2: function getNatLog2() { return Math.LN2; } getNatLog2(); // ...

الدالة Math.max()‎ تعيد أكبر قيمة من بين الوسائط المُمرَّرة إليها. البنية العامة Math.max([value1[, value2[, ...]]]) value1, value2, ...‎ الأعداد التي ستُجرى عليها العملية. القيمة المعادة أكبر قيمة من الأعداد المُمرَّرة إلى الدالة، وإذا لم يكن بالإمكان تحويل أحد الوسائط على الأقل إلى قيمةٍ رقمية، فستُعاد القيمة NaN. الوصف لمّا كانت الدالة max هي دالةٌ ساكنة (static method) تابعةٌ للكائن Math، فيجب عليك استخدامها دومًا بالشكل Math.max()‎، إذ لا تستطيع استخدامها كجزء من كائن Math خاص بك (تذكر أنَّ الكائن Math ...

الدالة String.prototype.charCodeAt()‎ تُعيد عددًا صحيحًا بين 0 و 65535 يُمثِّل رمز UTF-16 للمحرف الموجود عند الفهرس المُعيّن (لاحظ أنَّ رمز UTF-16 سيُطابِق رمز المحرف القابل للتمثيل كمحرف واحد في UTF-16، لكن سيُطابِق أوّل قسم من زوجَيّ الرموز للمحارف التي لا يمكن تمثيلها كرمز واحد في UTF-16 مثل رموز يونيكود الأكبر من 0x10000). إذا أردَت الحصول على كامل قيمة الرمز فاستخدم الدالة codePointAt()‎. البنية العامة str.charCodeAt(index) index عدد صحيح بين 0 و length -1. وإذا لم توفَّر قيمة لهذا الوسيط، فالقيمة ...

الدالة Math.sign()‎ تعيد إشارة العدد، التي تُشير إلى أنَّ العدد موجبٌ أم سالبٌ أم صفر. البنية العامة Math.sign(x) x العدد التي ستُجرى عليه العملية. القيمة المعادة عدد يُمثِّل إشارة الوسيط المُمرَّر إلى الدالة. فلو كان الوسيط عددًا موجبًا أو عددًا سالبًا أو صفرًا موجبًا أو صفرًا سالبًا فستعيد هذه الدالة القيم 1 أو -1 أو 0 أو -0 على التوالي وبالترتيب؛ وإلا فستُعاد القيمة NaN. الوصف لمّا كانت الدالة sign هي دالةٌ ساكنة (static method) تابعةٌ للكائن Math، فيجب عليك ...

الدالة String.prototype.lastIndexOf()‎ تُعيد الفهرس الموجود ضمن كائن String الذي يستدعي الدالة والذي يكون موضع آخر مُطابَقة للقيمة المُحدَّدة لهذه الدالة بدءًا من fromIndex وبالرجوع إلى بداية السلسلة النصية، أو القيمة ‎-1 إن لم يُعثَر عليها. البنية العامة str.lastIndexOf(searchValue[, fromIndex]) searchValue السلاسل النصية التي نريد البحث عنها ومعرفة فهرسها. fromIndex قيمة اختيارية، وهي عددٌ صحيحٌ يُمثِّل الفهرس الذي سيبدأ البحث منه باتجاه بداية السلسلة النصية. القيمة الافتراضية هي ‎+Infinity، وإذا كانت قيمة fromIndex >= str.length فسيتم البحث في كامل السلسلة النصية، ...

الدالة RegExp.prototype.[@@split]()‎ تقسم كائن String إلى مصفوفة من السلاسل النصية بفصلها إلى سلاسل نصية فرعية. البنية العامة regexp[Symbol.split](str[, limit]) str السلسلة النصية التي نريد قسمها. limit عدد صحيح يضبط الحد الأقصى لعدد الأجزاء التي ستُقسَّم السلسلة النصية إليها. وعند تحديد قيمة لهذا الوسيط، فستُقسِّم هذه الدالة السلسلة النصية عند كل مُطابَقة للتعبير النمطي، لكنها ستتوقف عند بلوغ عدد عناصر المصفوفة القيمة المُحدَّدة بالوسيط limit. لاحظ أنَّ من الممكن أن تكون هنالك عناصر في المصفوفة عددها أقل من قيمة limit. القيمة المعادة مصفوفة من ...

الدالة Number.prototype.toString()‎ تُعيد سلسلةً نصيةً تُمثِّل الكائن Number المُحدَّد. البنية العامة numObj.toString([radix]) radix عدد صحيح بين 2 و 36 الذي يُمثِّل أساس القيمة العددية المحتواة في السلسلة النصية؛ لاستخدام نظام العد العشري (decimal) شائع الاستخدام بين البشر فحدِّد القيمة 10 القيمة المعادة سلسلة نصيّة تُمثِّل الكائن Number. الاستثناءات RangeError سيرمى هذا الاستثناء إذا لم تكن قيمة الوسيط radix بين 2 و 36. الوصف الكائن Number يُعيد تعريف الدالة toString الموجودة في الكائن Object؛ فهو لا يرث الدالة Object.prototype.toString()‎. فلكائنات Number ...

الدالة Math.trunc()‎ تعيد الجزء الصحيح من العدد بإزالة جميع الأرقام بعد الفاصلة العشرية. البنية العامة Math.trunc(x) x العدد التي ستُجرى عليه العملية. القيمة المعادة الجزء الصحيح من القيمة المعطاة. الوصف على النقيض من الدوال Math.floor()‎ و Math.ceil()‎ و Math.round()‎، طريقة عمل الدالة Math.trunc()‎ بسيطةٌ جدًا، فهي تقتطع (truncate) الفاصلة العشرية وما يليها من أرقام، بغض النظر عمّا إذا كان العدد موجبًا أم سالبًا. سيحوّل الوسيط المُمرَّر إلى هذه الدالة إلى النوع Number ضمنيًا. لمّا كانت الدالة trunc هي دالةٌ ساكنة ...

الدالة Error.prototype.toString()‎ تُعيد سلسلةً نصيةً تُمثِّل كائن Error المُحدَّد. البنية العامة e.toString() القيمة المعادة سلسلة نصيّة تُمثِّل كائن Error المعطي. الوصف يُعيد الكائن Error تعريف الدالة toString الموروثة من الكائن Object؛ وتستخدم هذه الدالة قيمة الخاصيتين name و message لتركيب السلسلة النصية. تكون بنية هذه الدالة البرمجية كما يلي: Error.prototype.toString = function() { 'use strict'; var obj = Object(this); if (obj !== this) { throw new TypeError(); } var name = this.name; ...

الدالة RegExp.prototype.[@@replace]()‎ تُعيد سلسلةً نصيةً جديدةً فيها بعض أو جميع الأجزاء المُطابَقة عبر النمط this قد استبدلتها السلسلة النصية replacement. لاحظ أنَّ النمط pattern يمكن أن يكون سلسلةً نصيةً أو كائن RegExp، ويمكن أن يكون الوسيط replacement سلسلةً نصيةً أو دالةً التي ستُستدعى لكل مُطابَقة. البنية العامة regexp[Symbol.replace](str, newSubStr|function) str السلسلة النصية التي سنبحث عن مُطابَقة للتعبير النمطي فيها لاستبداله. newSubStr السلسلة النصية String التي ستستبدل السلسلة الفرعية، وهنالك عددٌ من الأنماط الفرعية المدعومة فيها، انظر قسم «تحديد سلسلة نصية كوسيط» في صفحة الدالة String.prototype.replace()‎ للتفاصيل. function الدالة ...

الخاصية Boolean.prototype تُعيد كائن prototype للكائن Boolean. سمات الخاصية Boolean.prototype قابلة للكتابة لا قابلة للإحصاء لا قابلة للضبط لا الوصف الكائنات المُنشَأة من الدالة البانية Boolean ترث من Boolean.prototype؛ لاحظ أنَّه من غير الممكن تغيير قيمة الخاصية Boolean.prototype؛ لكن يمكن إضافة خاصيات ودوال إليها لكي تتوافر في جميع الكائنات المُنشَأة من الدالة البانية Boolean. الخاصيات Boolean.prototype.constructor تُحديد الدالة التي ستُنشِئ كائن prototype لكائنات Boolean؛ راجع صفحة الخاصيةObject.prototype.constructor لمزيدٍ من التفاصيل. الدوال Boolean.prototype.toString()‎ إعادة السلسلة النصية "true" أو "false" اعتمادًا على قيمة ...

الدالة Date.prototype.getUTCMonth()‎ تعيد الشهر للتاريخ المُحدَّد وفقًا للتوقيت العالمي؛ نذكِّر أنَّ العد يبدأ من 0 (أي أوّل شهر في السنة رقمه 0). البنية العامة dateObj.getUTCMonth() القيمة المعادة عددٌ صحيحٌ يُمثِّل رقم الشهر (بين 0 و 11) للتاريخ المعطي وفقًا للتوقيت العالمي؛ إذ يُمثِّل العدد 0 شهر كانون الثاني/يناير، ويُمثِّل العدد 1 شهر شباط/فبراير، وهلمّ جرًا. أمثلة المثال الآتي يُسنِد الشهر في التاريخ الحالي إلى المتغير month: var today = new Date(); var month = today.getUTCMonth(); دعم المتصفحات الميزة Chrome Firefox Internet Explorer ...

الدالة Date.prototype.getYear()‎ تعيد السنة للتاريخ المُحدَّد وفقًا للتوقيت المحلي، ولأنَّ هذه الدالة لا تُعيد السنة كاملةً (مشكلة العام 2000) فلم تعد مستخدمةً ويجب استعمال الدالة getFullYear()‎ بدلًا منها. البنية العامة dateObj.getYear() القيمة المعادة عددٌ صحيحٌ يُمثِّل السنة للتاريخ المعطي وفقًا للتوقيت المحلي، مطروحًا منه 1900. الوصف للسنوات التي تكون أكبر أو تساوي 2000، فستكون القيمة المُعادة من الدالة getYear أكبر أو تساوي 100. على سبيل المثال، لو كانت السنة هي 2026، فستُعيد الدالة getYear القيمة 126. للسنوات بين 1900 و ...

الدالة String.prototype.split()‎ تقسم كائن String إلى مصفوفة من السلاسل النصية بفصلها إلى سلاسل نصية فرعية، وذلك باستخدام محرف فصل مُعيّن لمعرفة أين سيكون كل قسم. البنية العامة str.split([separator[, limit]]) separator السلسلة النصية التي تُشير إلى مكان فصل السلسلة النصية، ويمكن أن يكون الفاصل separator سلسلةً نصيةً أو تعبيرًا نمطيًا. وإذا استخدمنا سلسلةً نصيةً عاديةً تحتوي على أكثر من حرف فيجب العثور على السلسلة النصية كلها في مكان الفصل؛ أما لم تُحدَّد قيمة الوسيط separator أو لم يكن موجودًا ضمن السلسلة ...

الدالة String.prototype.endsWith()‎ تُحدِّد إن كانت تنتهي سلسلةٌ نصيةٌ بمحارف سلسلةٍ نصيةٍ أخرى، وتُعيد القيمة true أو false. البنية العامة str.endsWith(searchString[, length]) searchString السلسلة النصية التي سيُبحَث عنها في نهاية السلسلة النصية الأصلية. length قيمة اختيارية، وإذا حُدِّدَت فستتجاوز طول (length) السلسلة النصية التي سيُبحَث فيها، وإذا حُذِفَت فستكون القيمة الافتراضية مساويةً لطول السلسلة النصية. انظر الأمثلة. القيمة المعادة القيمة true إذا عُثِرَ على السلسلة النصية searchString في نهاية السلسلة النصية الأصلية، وإلا فستُعاد القيمة false. الوصف هذه الدالة تسمح لنا ...

الدالة Number.prototype.toFixed()‎ تُعيد سلسلةً نصيةً تُمثِّل العدد مع وضع فاصلة عشرية فيه. البنية العامة numObj.toFixed([digits]) digits وسيطٌ اختياريٌ يُمثِّل عدد الأرقام بعد الفاصلة العشرية، وإذا لم تُحدَّد قيمة هذا الوسيط فستُعدّ على أنها 0. القيمة المعادة سلسلة نصيّة تُمثِّل الكائن Number مع استخدام فاصلة عشرية (ويسمى هذا الشكل بالمصطلح fixed-point notation). الاستثناءات RangeError سيرمى هذا الاستثناء إذا كانت قيمة الوسيط digits كبيرةً جدًا أو صغيرةً جدًا؛ والقيم بين 0 و 100 لن تُسبِّب برمي الخطأ RangeError. TypeError سيرمى هذا الاستثناء ...

الخاصية Math.LOG2E تُمثِّل اللوغاريتم الثنائي (ذو الأساس 2) للعدد E، ويساوي تقريبًا 1.443. Math.LOG2E = log2(e) ≈ 1.442 سمات الخاصية Math.LOG2E قابلة للكتابة لا قابلة للإحصاء لا قابلة للضبط لا الوصف لمّا كانت الخاصية LOG2E هي خاصيةٌ ساكنة (static property) تابعةٌ للكائن Math، فيجب عليك استخدامها دومًا بالشكل Math.LOG2E، إذ لا تستطيع استخدامها كجزء من كائن Math خاص بك (تذكر أنَّ الكائن Math ليس له دالةٌ بانية). أمثلة الدالة الآتية تُعيد قيمة اللوغاريتم الثنائي للثابت الرياضي e: function getLog2e() { ...

الدالة Date.prototype.setUTCFullYear()‎ تضبط السنة (أربعة أرقام) للتاريخ المُحدَّد وفقًا للتوقيت العالمي، تُعيد هذه الدالة بصمة وقت (timestamp). البنية العامة dateObj.setUTCFullYear(yearValue[, monthValue[, dayValue]]) yearValue قيمة عددية صحيحة تُمثِّل السنة، مثلًا 1995. monthValue قيمة اختيارية، وهي قيمةٌ عددية صحيحة تُمثِّل الشهر، وتبدأ من 0 (كانون الثاني/يناير) إلى 11 (كانون الأول/ديسمبر). dayValue قيمة اختيارية، وهي عددٌ صحيحٌ يُمثِّل اليوم من الشهر بين 1 و 31. إذا حدّدت قيمة المعامل dayValue فيجب أن تُحدِّد قيمة monthValue أيضًا. القيمة المعادة كم ملي ثانية قد مضت ...

الدالة Object.prototype.__lookupGetter__()‎‎ تُعيد الدالة المرتبطة بالخاصية المعنية كدالة getter. تحذير: هذه الدالة مهملة، وعلى الرغم من أنَّ هذه الدالة موجودة في أغلبية المتصفحات، لكنها لم تُعرَّف إلا في آخر مسودة من معيار ECMAScript لأغراض التوافقية، ولا يجب أن تُستخدَم لوجود بدائل أفضل منها. البنية العامة obj.__lookupGetter__(sprop) sprop سلسلة نصية تحتوي على اسم الخاصية التي نريد إعادة دالة getter المرتبطة بها. القيمة المعادة دالة getter المرتبطة بالخاصية المُحدَّدة. الوصف إذا عُرِّفَت دالة getter على إحدى خاصيات الكائن، فمن غير الممكن الإشارة ...

الدالة Object.isExtensible()‎ تُحدِّد إن كان أحد الكائنات قابلًا للتوسعة (أي يمكن إضافة خاصيات جديدة إليه). البنية العامة Object.isExtensible(obj) obj الكائن الذي نريد التحقق منه. القيمة المعادة قيمة منطقية (Boolean) تبيّن إذا كان الكائن قابلًا للتوسعة أم لا. الوصف يمكن توسعة الكائنات افتراضيًا، أي يمكن إضافة خاصيات جديدة إليها، لكن يمكن جعل العنصر غير قابلٍ للتوسعة باستخدام الدالة Object.preventExtensions()‎ أو Object.seal()‎ أو Object.freeze()‎. لاحظ أنَّه في معيار ECMAScript 5 كان استعمال هذه الدالة على وسيطٍ ليس كائنًا (أي قيمةً أوليةً) سيؤدي ...

الدالة Object.prototype.__defineGetter__()‎‎ تربط دالةً بإحدى خاصيات الكائن، وستستدعى تلك الدالة عند محاولة الوصول إلى الخاصية. تحذير: هذه الدالة مهملة ويُفتَرَض تعريف دوال getter عند تهيئة الكائنات أو باستخدام الدالة Object.defineProperty()‎، وعلى الرغم من أنَّ هذه الدالة موجودة في أغلبية المتصفحات، لكنها لم تُعرَّف إلا في آخر مسودة من معيار ECMAScript لأغراض التوافقية، ولا يجب أن تُستخدَم لوجود بدائل أفضل منها. البنية العامة obj.__defineGetter__(prop, func) prop سلسلة نصية تحتوي على اسم الخاصية التي نريد ربط الدالة المعطية إليها. func الدالة التي ...

الدالة String.prototype.startsWith()‎ تُحدِّد إن كانت تبدأ سلسلةٌ نصيةٌ بمحارف سلسلةٍ نصيةٍ أخرى، وتُعيد القيمة true أو false. البنية العامة str.startsWith(searchString[, position]) searchString السلسلة النصية التي سيُبحَث عنها في بداية السلسلة النصية الأصلية. length قيمة اختيارية، وإذا حُدِّدَت فستتجاوز طول (length) السلسلة النصية التي سيُبحَث فيها، وإذا حُذِفَت فستكون القيمة الافتراضية مساويةً لطول السلسلة النصية. انظر الأمثلة. القيمة المعادة القيمة true إذا عُثِرَ على السلسلة النصية searchString في بداية السلسلة النصية الأصلية، وإلا فستُعاد القيمة false. الوصف هذه الدالة تسمح لنا ...

الدالة Array.prototype.forEach()‎ تستدعي دالةً لكل عنصر موجود في المصفوفة. const arr = ['a', 'b', 'c']; arr.forEach(function(element) { console.log(element); }); // a // b // c البنية العامة arr.forEach(callback[, thisArg]) callback الدالة التي ستُنفَّذ كل عنصر من عناصر المصفوفة، وتقبل ثلاثة وسائط. currentValue العنصر الحالي الذي يُعالِج في المصفوفة، وهذه القيمة مطلوبة. index فهرس العنصر الحالي في المصفوفة، وهذه القيمة اختيارية. array المصفوفة التي استدعيت الدالة forEach عليها، وهذه القيمة اختيارية. thisArg القيمة التي ستُستخدَم في this عند استدعاء الدالة callback، وهي قيمة ...

الدالة Date.prototype.setYear()‎ تضبط السنة للتاريخ المُحدَّد وفقًا للتوقيت المحلي، ولأنَّ هذه الدالة لا تُعيد السنة كاملةً (مشكلة العام 2000) فلم تعد مستخدمةً ويجب استعمال الدالة setFullYear()‎ بدلًا منها. البنية العامة dateObj.setYear(yearValue) yearValue عدد صحيح يُمثِّل السنة. القيمة المعادة كم ملي ثانية قد مضت بدءًا من ‎1 January 1970 00:00:00 UTC للتاريخ المعطى (وستُغيّر قيمة الكائن Date أيضًا). الوصف إذا كانت قيمة yearValue بين 0 و 99، فستُضبَط السنة للكائن dateObj إلى 1900 + yearValue؛ فيما عدا ذلك، ستُضبَط السنة للكائن dateObj إلى ...

الخاصية Function.arguments تُشير إلى كائنٍ شبيهٍ بالمصفوفات الذي يحتوي على الوسائط المُمرَّرة إلى الدالة. أصبحت هذه الخاصية مهملة في ES3، ويجدر بنا استخدام الكائن arguments بدلًا منها، ومن الممنوع استخدام هذه الخاصية في نمط strict. الوصف في حالة الاستدعاء التعاودي (recursion)، ستُمثِّل قيمة f.arguments وسائط آخر استدعاء للدالة. أمثلة function f(n) { g(n - 1); } function g(n) { console.log('before: ' + g.arguments[0]); if (n > 0) { f(n); } console.log('after: ' + g.arguments[0]); } f(2); console.log('returned: ' + g.arguments); // الناتج // ...

الخاصية RegExp.prototype.source تُعيد سلسلةً نصيةً String تحتوي على النص المصدري للتعبير النمطي، لكن دون الخطين المائلين اللذين يحيطان به، ودون أيّة رايات. سمات الخاصية RegExp.prototype.source قابلة للكتابة لا قابلة للإحصاء لا قابلة للضبط نعم أمثلة استخدام الخاصية source مثال عن استخدام الخاصية source للحصول على التعبير النمطي المستخدم. لاحظ أنَّ الناتج لا يحتوي على الخطين المائلين ولا على الرايتين "ig": var regex = /fooBar/ig; console.log(regex.source); // "fooBar" التعابير النمطية الفارغة وتهريب المحارف بدءًا من ECMAScript 5، لم تعد الخاصية source تُعيد ...

الدالة String.prototype.toLowerCase()‎ تُعيد السلسلة النصية الأصلية لكن مع تحويل محارفها إلى الحالة الصغيرة. البنية العامة str.toLowerCase() القيمة المعادة سلسلة نصية جديدة تُمثِّل السلسلة النصية الأصلية لكن مع تحويل محارفها إلى الحالة الصغيرة. الوصف تُعيد هذه الدالة قيمة السلسلة النصية بعد تحويلها إلى الحالة الصغيرة. لاحظ أنَّ هذه الدالة لا تؤثر على السلسلة النصية نفسه. أمثلة استخدام toLowerCase()‎ console.log('ALPHABET'.toLowerCase()); // 'alphabet' دعم المتصفحات الميزة Chrome Firefox Internet Explorer Opera Safari الدعم الأساسي نعم نعم نعم نعم نعم مصادر ومواصفات مسودة المعيار ...

الخاصية Function.length تُحدِّد عدد الوسائط الذي تتوقعه الدالة. سمات الخاصية Function.length قابلة للكتابة لا قابلة للإحصاء لا قابلة للضبط نعم الوصف الخاصية length التابعة لكائنات Function تُشير إلى عدد الوسائط الذي تتوقعه الدالة، أي عدد المعاملات الرسمية (formal parameters)، وهذا العدد يستثني معامل البقية (rest parameter)، وسيتضمن المعاملات التي قبل أوّل معامل له قيمة افتراضية. وفي المقابل، الخاصية arguments.length تابعة للدالة محليًّا، وتوفِّر عدد الوسائط التي مُرِّرَت فعليًا إلى الدالة. قيمة هذه الخاصية على الدالة البانية Function الدالة البانية Function ...

الدالة Array.prototype.fill()‎ تملأ جميع عناصر المصفوفة من فهرس البداية حتى فهرس النهاية بقيمة ثابتة. var numbers = [1, 2, 3] numbers.fill(1); // [1, 1, 1] البنية العامة arr.fill(value[, start[, end]]) value القيمة التي نريد ملء المصفوفة بها. start فهرس البداية، وقيمته الافتراضية هي 0. end فهرس النهاية، وقيمته الافتراضية هي this.length. القيمة المعادة المصفوفة المُعدَّلة. الوصف الدالة fill تستطيع أن تقبل ثلاثة وسائط هي value و start و end، الوسيطان start و end هما وسيطان اختياريان يأخذان القيم الافتراضية 0 و length ...