نتائج البحث

الدالة 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.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 ...

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

الدالة Object.assign()‎ تُستخدَم لنسخ قيمة جميع الخاصيات القابلة للإحصاء التابعة للكائن مباشرة (enumerable own properties) من كائنٍ مصدريٍ (source object) أو أكثر، وستُعيد الكائن الهدف (target object). البنية العامة Object.assign(target, ...sources) target الكائن الهدف. sources الكائنات المصدرية. القيمة المعادة الكائن الهدف. الوصف سيستعاض عن الخاصيات في الكائن الهدف بالخاصيات الموجودة في الكائنات المصدرية إن كانت تحمل المفتاح نفسه؛ وستُستخدَم قيمة الخاصيات الموجودة الكائنات المصدرية الأخيرة إذا وجدت خاصيات لها نفس المفتاح في الكائنات المصدرية الأولى. لا تنسخ الدالة Object.assign()‎ إلا ...

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

الدالة Date.prototype.getUTCFullYear()‎ تعيد السنة (أربعة أرقام) للتاريخ المُحدَّد وفقًا للتوقيت العالمي. البنية العامة dateObj.getUTCFullYear() القيمة المعادة عددٌ صحيحٌ يُمثِّل السنة للتاريخ المعطي وفقًا للتوقيت العالمي. الوصف القيمة المُعادة من الدالة getUTCFullYear()‎ هي رقمٌ مطلق (أي ليس نسبةً إلى العام 1900)، فللتواريخ التي تقع بين عامَي 1000 و 9999 ستُعيد الدالة getUTCFullYear()‎ قيمةً عدديةً مكونةً من أربعة أرقام (مثلًا: 1995). أمثلة المثال الآتي يُسنِد قيمة السنة الحالية (عددٌ صحيحٌ يتألف من أربعة أرقام) إلى المتغير year: var today = new Date(); var ...

الدالة Array.prototype.entries()‎ تُعيد كائن Array Iterator جديد الذي يحتوي على أزواج «المفتاح/القيمة» لكل فهرس في المصفوفة. var a = ['a', 'b', 'c']; var iterator = a.entries(); console.log(iterator.next().value); // [0, 'a'] console.log(iterator.next().value); // [1, 'b'] console.log(iterator.next().value); // [2, 'c'] البنية العامة arr.entries() القيمة المعادة كائن Array Iterator جديد. أمثلة استخدام الحلقة for...of var a = ['a', 'b', 'c']; var iterator = a.entries(); for (let e of iterator) { console.log(e); } // [0, 'a'] // [1, 'b'] // [2, 'c'] دعم المتصفحات الميزة Chrome Firefox Internet Explorer Opera Safari الدعم الأساسي ...

الدالة Object.getOwnPropertySymbols()‎ تُعيد مصفوفةً فيها جميع الخاصيات الرمزية (symbol properties) الموجودة مباشرةً في الكائن المعطي. البنية العامة Object.getOwnPropertySymbols(obj) obj الكائن الذي نريد الحصول على جميع خاصياته الرمزية. القيمة المعادة مصفوفة فيها جميع الخاصيات الرمزية (symbol properties) التابعة مباشرةً للكائن المعطي. الوصف بما يشبه الدالة Object.getOwnPropertyNames()‎، يمكن الحصول على جميع الخاصيات الرمزية لكائنٍ ما باستخدام هذه الدالة؛ لكن لاحظ أنَّ الدالة Object.getOwnPropertyNames()‎ لا تُعيد الخاصيات الرمزية وإنما ستعيد الخاصيات النصية فقط. ولمّا كانت جميع الكائنات لا تحتوي على خاصيات رمزية عند ...

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

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

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

الدالة Array.prototype.pop()‎ تحذف آخر عنصر من المصفوفة وتُعيد قيمته، وهذه الدالة تُغيّر عدد عناصر (length) المصفوفة. var plants = ['broccoli', 'cauliflower', 'cabbage', 'kale', 'tomato']; console.log(plants.pop()); // "tomato" console.log(plants); // ["broccoli", "cauliflower", "cabbage", "kale"] plants.pop(); console.log(plants); // ["broccoli", "cauliflower", "cabbage"] البنية العامة arr.pop() القيمة المعادة القيمة المحذوفة من المصفوفة، أو القيمة undefined إذا كانت المصفوفة فارغة. الوصف الدالة pop تحذف آخر عنصر من المصفوفة وتُعيد تلك القيمة إلى التعبير البرمجي الذي استدعاها؛ وإذا اُستدعيت الدالة pop على مصفوفة فارغة فستُعيد القيمة undefined. أمثلة المثال الآتي يُنشِئ مصفوفةً باسم ...

الرمز المعروف Symbol.species يُشير إلى خاصيةٍ قد أُسنِدَت إليها دالةٌ التي يمكن أن تستعملها الدالة البانية لإنشاء كائنات مشتقة (derived objects). سمات الخاصية Symbol.species قابلة للكتابة لا قابلة للإحصاء لا قابلة للضبط لا الوصف الخاصية species تسمح للأصناف الفرعية بإعادة تعريف الدالة البانية الافتراضية للكائنات. أمثلة إذا أردنا إعادة كائنات من النوع Array من الصنف الفرعي MyArray، مما يمكننا من استخدام دوال مثل الدالة map()‎ التي تعيد الدالة البانية الافتراضية؛ لذا سنستخدم الخاصية species لجعل تلك الدوال تُعيد كائن Array ...

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

الدالة String.prototype.concat()‎ تدمج سلسلتين نصيتين مع بعضهما بعضًا وتُعيد سلسلةً نصيةً جديدةً. البنية العامة str.concat(string2[, string3, ..., stringN]) string2...stringN السلاسل النصية التي ستُجمَع مع بعضها لتشكيل السلسلة النصية الجديدة. القيمة المعادة سلسلة نصية جديدة تحتوي على النص الموجود في السلاسل النصية المُمرَّرة إلى الدالة. الوصف الدالة concat()‎ تجمع النص من سلسلة نصية أو أكثر وتُعيد سلسلةً نصيةً جديدة، والتغييرات التي تحدث على إحدى السلاسل النصية لن تؤثر على البقية. بخصوص الأداء، من المستحسن (وبشدّة) استخدام معاملات الإسناد (أي + و ...

الدالة Number.parseFloat()‎ تُفسِّر الوسيط النصيّ المُمرَّر إليها وتُعيد عددًا عشريًا؛ وهذه الدالة تسلك نفس سلوك الدالة العامة parseFloat()‎، وأُضيفَت في معيار ECMAScript 2015، والغرض من إضافتها هو تقسيم الدوال والخاصيات العامة إلى وحدات (modules). البنية العامة Number.parseFloat(value) value القيمة التي ستُفسَّر. القيمة المعادة عدد ذو فاصلة عشرية ناتج عن تفسير السلسلة النصية المعطاة، وإذا لم يكن تحويل السلسلة النصية إلى رقم ممكنًا فستعاد القيمة NaN. الوصف انصر صفحة الدالة parseFloat()‎ للتفاصيل والأمثلة. تعويض نقص دعم المتصفحات Number.parseFloat = parseFloat; دعم المتصفحات ...

الدالة Date.prototype.toUTCString()‎ تعيد سلسلة نصية تُمثِّل كائن Date المُحدَّد في المنطقة الزمنية UTC. البنية العامة dateObj.toUTCString() القيمة المعادة سلسلة نصية تُمثِّل التاريخ في توقيت UTC. الوصف القيمة المُعادة من الدالة toUTCString()‎ هي سلسلة نصية يسهل قراءتها من البشر بتوقيت UTC. لاحظ أنَّ صيغة القيمة المُعادة قد تختلف تبعًا للمتصفح أو نظام التشغيل، لكن أكثر صيغة شائعة هي RFC 1123. أمثلة مثال عن استخدام الدالة toUTCString()‎: var today = new Date('Wed, 14 Jun 2017 00:00:00 PDT'); var UTCstring = today.toUTCString(); // Wed, ...

الدالة Array.prototype.splice()‎ تغيّر محتويات مصفوفة بإزالة عناصر موجودة فيها أو إضافة عناصر جديدة إليها. var myFish = ['angel', 'clown', 'mandarin', 'sturgeon']; myFish.splice(2, 0, 'drum'); // إضافة عنصر في الفهرس 2 // myFish: ["angel", "clown", "drum", "mandarin", "sturgeon"] myFish.splice(2, 1); // إزالة عنصر واحد (1) في الفهرس 2 // myFish: ["angel", "clown", "mandarin", "sturgeon"] البنية العامة array.splice(start[, deleteCount[, item1[, item2[, ...]]]]) start الفهرس الذي سنبدأ فيه تغيير المصفوفة (ويكون المبدأ هو 0)، وإذا كانت هذه القيمة أكبر من عدد عناصر المصفوفة (أي length)، فسيُضبَط فهرس ...

الدالة Date.prototype.toISOString()‎ تعيد سلسلة نصية بصيغة ISO الموسعة المبسّطة (ISO 8601) وهي تكون دومًا بطول 24 أو 27 محرفًا (YYYY-MM-DDTHH:mm:ss.sssZ أو ‎±YYYYYY-MM-DDTHH:mm:ss.sssZ). وتكون المنطقة الزمنية هي UTC، كما هو واضح من اللاحقة Z. البنية العامة dateObj.toISOString() القيمة المعادة سلسلة نصية تُمثِّل التاريخ بصيغة ISO 8601 وفقًا للتوقيت العالمي. أمثلة مثال استخدام الدالة toISOString()‎: var today = new Date('05 October 2011 14:48 UTC'); console.log(today.toISOString()); // 2011-10-05T14:48:00.000Z لاحظ أنَّ المثال السابق يفسّر سلسلة نصية غير معيارية ليحوّلها إلى تاريخ، وقد لا يعمل كما ينبغي ...

الدالة Math.atan2()‎ تعيد معكوس الظل (arctangent) لناتج قسمة الوسيطين الممررين إليها. البنية العامة Math.atan2(y, x) y العدد الأول. x العدد الثاني. القيمة المعادة معكوس الظل (arctangent) لناتج قسمة الوسيطين. الوصف الدالة Math.atan(x)‎ تُعيد قيمةً عدديةً بين -π و π، وهذه القيمة تُمثِّل الزاوية θ للزاوية التي تقع بين المحور x والمستقيم المار من المبدأ ومن النقطة (x, y) والمُقاسة عكس عقارب الساعة. لاحظ أنَّ الوسائط المُمرَّرة إلى هذه الدالة هي إحداثيات y أولًا ثم إحداثيات x. الزاوية التي تُعيدها الدالة ...

الدالة String.prototype.trim()‎ تُزيل الفراغات من بداية ونهاية السلسلة النصية؛ والفراغات المذكورة هنا هي جميع محارف الفراغات (الفراغ العادي، ومسافة الجدولة [tab]، والفراغ الذي لا يقبل القسم [no-break space] ...إلخ.) وجميع محارف نهاية الأسطر (LF و CR ...إلخ.). البنية العامة str.trim() القيمة المعادة سلسلة نصية جديدة تُمثِّل السلسلة النصية الأصلية لكن مع إزالة جميع الفراغات من بدايتها ونهايتها. الوصف تُعيد هذه الدالة سلسلة نصية جديدة تُمثِّل السلسلة النصية الأصلية لكن مع إزالة جميع الفراغات من بدايتها ونهايتها. لاحظ أنَّ هذه الدالة ...

الدالة Math.atan()‎ تعيد معكوس الظل (arctangent) للعدد بواحدة الراديان. أي لو أعادت هذه الدالة العدد y الذي ينتمي إلى المجال [-π/2 ; π/2] فسيكون التعبير الرياضي tan(y) = x محققًا. البنية العامة Math.atan(x) x العدد التي ستُجرى عليه العملية. القيمة المعادة معكوس الظل (arctangent) للعدد بواحدة الراديان. الوصف الدالة Math.atan(x)‎ تُعيد قيمةً عدديةً بين -π/2 و π/2. لمّا كانت الدالة atan هي دالةٌ ساكنة (static method) تابعةٌ للكائن Math، فيجب عليك استخدامها دومًا بالشكل Math.atan(x)‎، إذ لا تستطيع استخدامها كجزء من ...

الدالة String.prototype.search()‎ تبحث عن تعبيرٍ نمطيٍ (regular expression) في سلسلةٍ نصية. البنية العامة str.search(regexp) regexp كائن التعابير النمطية، وإذا مُرِّرَ كائن obj ليس من النوع RegExp، فسيحوَّل إليه ضمنيًا باستخدام الدالة البانية new RegExp(obj)‎. القيمة المعادة فهرس أوّل مطابقة للتعبير النمطي في السلسلة النصية، أو القيمة -1 إن لم تكن هنالك مطابقة. الوصف إذا أردتَ معرفة إن كان النمط موجودًا في السلسلة النصية وما هو فهرسه، فاستخدم الدالة search()‎ (أما إذا أردتَ معرفة إن كان موجودًا فقط فاستخدم الدالة test()‎ ...

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

الدالة Math.atanh()‎ معكوس الظل القطعي (hyperbolic arctangent) للعدد. أي لو أعادت هذه الدالة العدد y فسيكون التعبير الرياضي tanh(y) = x محققًا. البنية العامة Math.atanh(x) x العدد التي ستُجرى عليه العملية. القيمة المعادة معكوس التجيب القطعي (hyperbolic arctangent) للعدد. الوصف لمّا كانت الدالة atanh هي دالةٌ ساكنة (static method) تابعةٌ للكائن Math فيجب عليك استخدامها دومًا بالشكل Math.atanh(x)‎، إذ لا تستطيع استخدامها كجزء من كائن Math خاص بك (تذكر أنَّ الكائن Math ليس له دالةٌ بانية). أمثلة لاحظ أنَّ الدالة ...

الدالة Number.isInteger()‎ تُحدِّد إذا كانت القيمة المُمرَّرة إليها هي عددٌ صحيحٌ أم لا. البنية العامة Number.isInteger(value) value القيمة التي ستُختبَر إن كانت عددًا صحيحًا. القيمة المعادة قيمة منطقية Boolean تُشير إذا كان العدد صحيحًا أم لا. الوصف إذا كانت القيمة المُمرَّرة إلى هذه الدالة هي عددٌ صحيحٌ، فستُعاد القيمة true، وإلا فستُعاد القيمة false؛ وإذا كانت القيمة NaN أو اللانهاية (Infinity) فستُعاد القيمة false. أمثلة أعداد صحيحة: Number.isInteger(0); // true Number.isInteger(1); ...

الدالة Array.prototype.concat()‎ تدمج مصفوفتين أو أكثر؛ وهذه الدالة لا تُغيّر المصفوفات الأصلية، وإنما تُعيد مصفوفةً جديدةً. var arr1 = ['a', 'b', 'c']; var arr2 = ['d', 'e', 'f']; var arr3 = arr1.concat(arr2); // arr3: [ "a", "b", "c", "d", "e", "f" ] البنية العامة var new_array = old_array.concat(value1[, value2[, ...[, valueN]]]) valueN المصفوفات أو القيم التي ستُضاف إلى بعضها لتشكيل مصفوفة جديدة. القيمة المعادة مصفوفة جديدة. الوصف الدالة concat تُنشِئ مصفوفةً جديدةً تحتوي على العناصر الموجودة في الكائن الذي استدعيت هذه الدالة عليه، ...