نتائج البحث

الدالة 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 تُنشِئ مصفوفةً جديدةً تحتوي على العناصر الموجودة في الكائن الذي استدعيت هذه الدالة عليه، ...

الخاصية Number.EPSILON تُمثِّل الفرق بين العدد 1 والعدد العشري الأكبر منه مباشرة (أي بعبارةٍ أخرى: تُمثِّل هذه الخاصية أقل فرق بين عددين متتاليين). ليس من الضروري أن تُنشِئ كائن Number للوصول إلى هذه الخاصية الساكنة (static property). سمات الخاصية Number.EPSILON قابلة للكتابة لا قابلة للإحصاء لا قابلة للضبط لا الوصف الخاصية EPSILON تملك القيمة التقريبية 2.2204460492503130808472633361816E-16 أو 2‎-52. أمثلة سنختبر مساواة ناتج عملية حسابية على الأعداد العشرية: x = 0.2; y = 0.3; z = 0.1; equal = (Math.abs(x - y + z) ...

الدالة Date.prototype.toString()‎ تعيد سلسلة نصية تُمثِّل كائن Date المُحدَّد. لاحظ أنَّ الدالة toString تُعيد تمثيلًا نصيًا للتاريخ بصيغة American English دومًا. البنية العامة dateObj.toString() القيمة المعادة سلسلة نصية تُمثِّل التاريخ. أمثلة مثال عن استخدام الدالة toString()‎: var x = new Date(); myVar = x.toString(); // "Sun Dec 10 2017 15:59:25 GMT+0200 (EET)" دعم المتصفحات الميزة Chrome Firefox Internet Explorer Opera Safari الدعم الأساسي نعم نعم نعم نعم نعم مصادر ومواصفات مسودة المعيار ECMAScript Latest Draft. معيار ECMAScript 2015 (6th Edition)‎. معيار ECMAScript ...

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

الدالة Date.prototype.getTimezoneOffset()‎ تعيد الفرق بين المنطقة الزمنية للمحليّة (locale، اي إعدادات الجهاز المحلي) وتوقيت UTC بالدقائق. البنية العامة dateObj.getTimezoneOffset() القيمة المعادة عددٌ صحيحٌ يُمثِّل الفرق بين المنطقة الزمنية للمحليّة (locale) وتوقيت UTC بالدقائق. الوصف تُعيد هذه الدالة الفرق بين المنطقة الزمنية المحليّة وتوقيت UTC، لاحظ أنَّ الفرق سيكون موجبًا إذا كان توقيت المنطقة الزمنية المحليّة يسبق توقيت UTC، وسالبًا إذا كان توقيت المنطقة الزمنية المحليّة يلي توقيت UTC. مثلًا، لو كنّا في المنطقة الزمنية UTC+10:00 (توقيت شرق أستراليا) فالقيمة المُعادة ...

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

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

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

الدالة Math.hypot()‎ تعيد الجذر التربيعي لمجموع مربعات الوسائط المُمرَّرة إلى الدالة. أي: Math.hypot(v1, v2, ... , vn) = sqrt(v1^2 + v2^2 + ... + vn^2) البنية العامة Math.hypot([value1[, value2[, ...]]]) value1, value2, ...‎ الأعداد التي ستُجرى عليها العملية. القيمة المعادة الجذر التربيعي لمجموع مربعات الوسائط المُمرَّرة إلى الدالة، وإذا لم لكن بالإمكان تحول وسيط واحد على الأقل إلى رقم فستُعاد القيمة NaN. الوصف تساعد هذه الدالة في الحسابات الرياضية، مثل إيجاد طول وتر مثلث (فبدلًا من استخدام الدالة Math.sqrt(v1*v1 + ...

الدالة Math.cbrt()‎ تعيد الجذر التكعيبي (cube root) للعدد. أي لو أعادت هذه الدالة العدد y فسيكون التعبير الرياضي y3 = x محققًا. البنية العامة Math.cbrt(x) x العدد التي ستُجرى عليه العملية. القيمة المعادة الجذر التكعيبي (cube root) للعدد. الوصف لمّا كانت الدالة cbrt هي دالةٌ ساكنة (static method) تابعةٌ للكائن Math، فيجب عليك استخدامها دومًا بالشكل Math.cbrt(x)‎، إذ لا تستطيع استخدامها كجزء من كائن Math خاص بك (تذكر أنَّ الكائن Math ليس له دالةٌ بانية). أمثلة أمثلة عددية: Math.cbrt(NaN); // ...

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

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

الدالة RegExp.prototype.[@@match]()‎ تُعيد ما يُطابِقه تعبيرٌ نمطيٌ (regular expression) في سلسلة نصية. البنية العامة regexp[Symbol.match](str) str السلسلة النصية التي سنبحث عن مُطابَقة للتعبير النمطي فيها. القيمة المعادة إذا كانت هنالك مُطابَقة بين التعبير النمطي والسلسلة النصية، فستُعاد مصفوفة Array تحتوي على كامل السلسلة النصية المُطابَقة كأوّل عنصر فيها، ويليها أيّة نتائج تمت مُطابَقتها في التعابير النمطية الفرعية الموجودة بين قوسين. وإذا لم تُطابَق أيّة نتائج فستُعاد القيمة null. الوصف تُستدعى هذه الدالة داخليًا في الدالة String.prototype.match()‎. فمثلًا، كلا المثالين الآتيين له يُعيد النتيجة ...

الدالة RegExp.prototype.[@@search]()‎ تبحث عن تعبيرٍ نمطيٍ (regular expression) في سلسلةٍ نصية. البنية العامة regexp[Symbol.search](str) str السلسلة النصية التي سنبحث عن مُطابَقة للتعبير النمطي فيها. القيمة المعادة فهرس أوّل مطابقة للتعبير النمطي في السلسلة النصية، أو القيمة -1 إن لم تكن هنالك مطابقة. الوصف تُستدعى هذه الدالة داخليًا في الدالة String.prototype.search()‎. فمثلًا، كلا المثالين الآتيين يُعيد النتيجة نفسها: 'abc'.search(/a/); /a/[Symbol.search]('abc'); الغرض من وجود هذه الدالة هو السماح بإمكانية تخصيصها في الأصناف الفرعية المشتقة من RegExp. أمثلة استدعاء مباشر ستُستخدَم هذه الدالة بنفس طريقة ...

الخاصية RegExp.lastIndex هي خاصيةٌ عدديةٌ تابعةٌ للكائنات من النوع RegExp وتقبل القراءة والكتابة وتُحدِّد الفهرس الذي ستبدأ منه عملية البحث عن مطابقة. سمات الخاصية RegExp.lastIndex قابلة للكتابة نعم قابلة للإحصاء لا قابلة للضبط لا البنية العامة regExpObj.lastIndex الوصف ستُضبَط هذه الخاصية إذا احتوى التعبير النمطي على الراية "g" للإشارة إلى أنَّ البحث سيكون عامًّا في كامل السلسلة النصية، وستُطبَّق القواعد الآتية: إذا كانت قيمة lastIndex أكبر من طول السلسلة النصية، فلن تعمل الدالتان test()‎ و exec()‎ وبالتالي ستُضبَط قيمة lastIndex ...

الدالة Date.prototype.setTime()‎ تضبط الكائن Date إلى الوقت المُمثَّل بكم ملي ثانية مضت منذ January 1, 1970, 00:00:00 UTC. البنية العامة dateObj.setTime(timeValue) timeValue عددٌ صحيحٌ يُمثِّل كم ملي ثانية قد مضت منذ ‎1 January 1970 00:00:00 UTC. القيمة المعادة كم ملي ثانية قد مضت بدءًا من ‎1 January 1970 00:00:00 UTC للتاريخ المعطى (وهي نفس قيمة الوسيط المُمرّر إلى الدالة)، وستُغيّر قيمة الكائن Date أيضًا. الوصف تُستخدَم الدالة setTime()‎ للمساعدة في إسناد التاريخ إلى كائن Date آخر. أمثلة مثال عن استخدام الدالة setTime()‎: ...

الدالة Object.getPrototypeOf()‎ تُعيد كائن prototype (أي قيمة الخاصية الداخلية [[Prototype]]) للكائن المُحدَّد. البنية العامة Object.getPrototypeOf(obj) obj الكائن الذي نريد الحصول على كائن prototype التابع له. القيمة المعادة كائن prototype للكائن المعطي، وإن لم تكن هنالك خاصياتٌ موروثة فستُعاد القيمة null. الوصف لاحظ أنَّه في معيار ECMAScript 5 كان استعمال هذه الدالة على وسيطٍ ليس كائنًا (أي قيمةً أوليةً) سيؤدي إلى رمي TypeError، لكن بدءًا من ECMAScript 2015 (أي ES6) فستُعامل الوسائط التي لا تُمثِّل كائنات على أنها كائنات: Object.getPrototypeOf('foo'); // TypeError: ...

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

الدالة Date.UTC()‎ تقبل نفس الوسائط التي يقبلها أطول شكل من أشكال الدالة البانية، وتُعيد كم ملي ثانية مضت منذ January 1, 1970, 00:00:00 في التوقيت العالمي (UTC). البنية العامة Date.UTC(year, month[, day[, hour[, minute[, second[, millisecond]]]]]) year قيمة عددية صحيحة تُمثِّل السنة بعد عام 1900. month قيمة عددية صحيحة تُمثِّل الشهر، وتبدأ من 0 (كانون الثاني/يناير) إلى 11 (كانون الأول/ديسمبر). day قيمة اختيارية، وهي عددٌ صحيحٌ يُمثِّل اليوم من الشهر (من 1 إلى 31). hours قيمةٌ اختياريةٌ، وهي عددٌ صحيحٌ ...

الدالة Date.prototype.setUTCMonth()‎ تعيد الشهر للتاريخ المُحدَّد وفقًا للتوقيت العالمي؛ نذكِّر أنَّ العد يبدأ من 0 (أي أوّل شهر في السنة رقمه 0). البنية العامة dateObj.setUTCMonth(monthValue[, dayValue]) monthValue عدد صحيح بين 0 و 11، يُمثِّل الأشطر من كانون الثاني/يناير إلى كانون الأول/ديسمبر. dayValue وسيطٌ اختياري، وهو عددٌ صحيحٌ من 1 إلى 31، يُمثِّل اليوم في الشهر. القيمة المعادة كم ملي ثانية قد مضت بدءًا من ‎1 January 1970 00:00:00 UTC للتاريخ المعطى (وستُغيّر قيمة الكائن Date أيضًا). الوصف إذا لم تُحدَّد قيمة للمعامل ...

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

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

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

الخاصية Number.NaN تُمثِّل القيمة الخاصة Not-A-Number، وهي تكافئ القيمة NaN. لستَ بحاجةٍ إلى إنشاء كائن Number للوصول إلى هذه الخاصية الساكنة (static property)، فيمكنك أن تستخدم Number.NaN مباشرةً. سمات الخاصية Number.NaN قابلة للكتابة لا قابلة للإحصاء لا قابلة للضبط لا دعم المتصفحات الميزة Chrome Firefox Internet Explorer Opera Safari الدعم الأساسي نعم نعم نعم نعم نعم مصادر ومواصفات مسودة المعيار ECMAScript Latest Draft. معيار ECMAScript 2015 (6th Edition)‎. معيار ECMAScript 5.1. معيار ECMAScript 1st Edition.

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

الدالة Object.seal()‎ تجعل الكائن مختومًا، مما يمنع إضافة خاصيات جديدة إليه، ويجعل جميع الخاصيات الموجودة مسبقًا فيه غيرَ قابلةٍ للضبط (non-configurable)؛ لكن ما يزال بالإمكان تعديل قيم الخاصيات الموجودة لطالما كانت قابلةً للكتابة (writable). البنية العامة Object.seal(obj) obj الكائن الذي نريد جعله مختومًا. القيمة المعادة الكائن المعني لكن مع جعله مختومًا. الوصف افتراضيًا، تكون الكائنات قابلةً للتوسعة (extensible، أي يمكن إضافة خاصيات جديدة إليها)، وجعل الكائن مختومًا يمنع إضافة خاصيات جديدة ويجعل جميع الخاصيات الموجودة غير قابلةٍ للضبط؛ وهذا يمكِّن ...

الدالة Object.freeze()‎ تُجمِّد كائنًا، مما يمنع إضافة خاصيات جديدة إليه، ويمنع حذف الخاصيات الموجودة فيه، ويمنع تعديل قيمة أو قابلية إحصاء أو قابلية ضبط أو قابلية الكتابة التابعة لخاصياته؛ ويمنع أيضًا تعديل سلسلة prototype، وستُعيد هذه الدالة الكائن في الحالة «المُجمَّدة». البنية العامة Object.freeze(obj) obj الكائن الذي سيُجمَّد. القيمة المعادة الكائن المُجمَّد. الوصف لا يمكن إضافة أو حذف أيّ شيء من خاصيات الكائنات المجمّدة؛ وأي محاولة لفعل ذلك ستفشل إما بصمت أو سترمي الاستثناء TypeError (وسيرمى هذا الخطأ عادةً في ...

الدالة Symbol.keyFor(key)‎ تحصل على مفتاحٍ للرمز المعطي من سجل الرموز العام. البنية العامة Symbol.keyFor(sym); sym الرمز الذي سنبحث عنه. القيمة المعادة سلسلة نصية تمثل الرمز المرتبط بالرمز المعطي إن كان موجودًا في السجل العام؛ وإلا فستعاد القيمة undefined. أمثلة سنستخدم الدالة Symbol.for()‎ لإنشاء رمز عام جديد ثم سنحصل على قيمة مفتاحه عبر الدالة Symbol.KeyFor()‎ في المثال الآتي: var globalSym = Symbol.for('foo'); // إنشاء رمز عام جديد Symbol.keyFor(globalSym); // "foo" لاحظ أنَّ الدالة Symbol.KeyFor()‎ لن تُعيد قيمة رمز المفتاح المحلي، لأنَّه ليس موجودًا ...

الدالة Date.prototype.toGMTString()‎ تحوّل التاريخ إلى سلسلة نصية تستخدم توقيت غرينتش (GMT). صيغة القيمة التي تُعيدها هذه الدالة تختلف بين المتصفحات. ملاحظة: الدالة toGMTString()‎ هي دالة مهملة (deprecated) ولا يجدر بنا استخدمها، لكنها بقيت موجودةً لأغراض التوافقية. يرجى استخدام الدالة toUTCString()‎ بدلًا منها. البنية العامة dateObj.toGMTString() القيمة المعادة سلسلة نصية تُمثِّل التاريخ بتوقيت غرينتش (GMT). أمثلة مثال بسيط عن استخدام الدالة toGMTString()‎ لتحويل التاريخ إلى GMT باستخدام الفارق الزمني الموجود في نظام التشغيل. لاحظ أنَّ صيغة التاريخ المُعادة قد تختلف باختلاف ...

الخاصية Function.prototype تُعيد كائن prototype للكائن Function. الوصف الكائنات المُنشَأة من الدالة البانية Function ترث من Function.prototype؛ لاحظ أنَّه من غير الممكن تغيير قيمة الخاصية Function.prototype.  الخاصيات Function.arguments مصفوفة تحتوي على الوسائط المُمرَّرة إلى الدالة، وهذه الخاصية أصبحت مهملة (deprecated)، ويُفضَّل استخدام الكائن arguments المتاح ضمن الدوال بدلًا منها. Function.arity تحديد عدد الوسائط التي تتوقعها الدالة. هذه الدالة محذوفة وغير مدعومة في جميع المتصفحات، ويجب استخدام الخاصية length بدلًا منها. Function.caller تحديد اسم الدالة التي استدعت الدالة التي تُنفَّذ حاليًا. ...

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

الدالة Date.now()‎ تعيد كم ملي ثانية مضت منذ ‎1 January 1970 00:00:00 UTC. البنية العامة Date.now() القيمة المعادة قيمة عددية من النوع Number تُمثِّل كم ملي ثانية مضت منذ بدء توقيت يونكس (UNIX epoch). الوصف لمّا كانت الدالة now()‎ دالةً ساكنة (static method) تابعةً للكائن Date، فيجب استخدامها دومًا بالشكل Date.now()‎. تعويض نقص دعم المتصفحات أُضيفت هذه الدالة في معيار ECMAScript 5.1، لذا يمكننا استخدام الشيفرة الآتية لإضافتها في المتصفحات التي لا تدعمها: if (!Date.now) { Date.now = function ...

الدالة Date.prototype.getMonth()‎ تعيد الشهر للتاريخ المُحدَّد وفقًا للتوقيت المحلي؛ نذكِّر أنَّ العد يبدأ من 0 (أي أوّل شهر في السنة رقمه 0). البنية العامة dateObj.getMonth() القيمة المعادة عددٌ صحيحٌ يُمثِّل رقم الشهر (بين 0 و 11) للتاريخ المعطي وفقًا للتوقيت المحلي؛ إذ يُمثِّل العدد 0 شهر كانون الثاني/يناير، ويُمثِّل العدد 1 شهر شباط/فبراير، وهلمّ جرًا. أمثلة الشيفرة الآتية تُسنِد القيمة 4 إلى المتغير month وذلك اعتمادًا على قيمة الكائن BD95 من النوع Date: var BD95 = new Date('May 21, 1995 23:15:30'); var month = BD95.getMonth(); console.log(month); // ...

الدالة Number.isFinite()‎ تُحدِّد إذا كانت القيمة المُمرَّرة إليها هي عددٌ محدود (finite number) أم لا. البنية العامة Number.isFinite(value) value القيمة التي ستُختبَر إن كانت عددًا محدودًا (finite number). القيمة المعادة قيمة منطقية Boolean تُشير إذا كان العدد محدودًا أم لا. الوصف بالمقارنة مع الدالة العامة isFinite()‎، هذه الدالة لا تفرض تحويل الوسيط المُمرَّر إليها إلى رقم، وهذا يعني أنَّ القيم العددية والتي تمثل عددًا محدودًا هي القيم التي ستؤدي إلى إعادة true من هذه الدالة. أمثلة قيم ليست محدودةً: Number.isFinite(Infinity); ...

الدالة Array.prototype.some()‎ تختبر إذا كان أحد عناصر المصفوفة على الأقل يحقق الاختبار المُحدَّد من قِبل الدالة المعنية. function isBiggerThan10(element, index, array) { return element > 10; } [2, 5, 8, 1, 4]. some(isBiggerThan10); // false [12, 5, 8, 1, 4].some(isBiggerThan10); // true البنية العامة arr.some(callback[, thisArg]) callback الدالة التي ستختبر كل عنصر من عناصر المصفوفة، وتقبل ثلاثة وسائط. currentValue العنصر الحالي الذي يُعالِج في المصفوفة، وهذه القيمة مطلوبة. index فهرس العنصر الحالي في المصفوفة، وهذه القيمة اختيارية. array المصفوفة التي ...

الرمز المعروف Symbol.toPrimitive يُشير إلى خاصيةٍ قد أُسنِدَت إليها دالةٌ التي يمكن أن تستدعى لتحويل الكائن إلى القيمة الأوليّة المناسبة. سمات الخاصية Symbol.toPrimitive قابلة للكتابة لا قابلة للإحصاء لا قابلة للضبط لا الوصف بمساعدة الخاصية Symbol.toPrimitive (التي تُشير إلى دالة)، يمكننا تحويل الكائنات إلى القيم الأوليّة الموافقة لها، وهذه الدالة تُستدعى مع الوسيط النصي hint، والذي يُحدِّد ما هو النوع المُفضَّل للقيمة الأوليّة المُعادة، ويمكن أن تكون قيمة هذا الوسيط "number" أو "string" أو "default". أمثلة المثال الآتي يبيّن كيف ...

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

الدالة Object.getOwnPropertyNames()‎ تُعيد مصفوفةً فيها جميع الخاصيات التابعة مباشرةً للكائن المعطي، بما في ذلك الخاصيات غير القابلة للإحصاء (non-enumerable) لكن باستثناء خاصيات الرموز Symbol. البنية العامة Object.getOwnPropertyNames(obj) obj الكائن الذي نريد الحصول على جميع خاصياته. القيمة المعادة مصفوفة فيها سلاسل نصية لأسماء جميع الخاصيات التابعة مباشرةً للكائن المعطي. الوصف الدالة Object.getOwnPropertyNames()‎ تُعيد مصفوفةً فيها جميع الخاصيات التابعة مباشرةً للكائن obj، وترتيب الخاصيات القابلة للإحصاء متوافقٌ مع الترتيب الذي تُظهِره حلقة التكرار for...in (أو الدالة Object.keys()‎)؛ أما ترتيب الخاصيات غير القابلة ...

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

الدالة Array.prototype.find()‎ تُعيد قيمة أوّل عنصر في المصفوفة الذي يُطابِق الشرط الموجود في دالة الاختبار؛ وإلا ستُعاد القيمة undefined. function isBigEnough(element) { return element >= 15; } [12, 5, 8, 130, 44].find(isBigEnough); // 130 انظر أيضًا إلى صفحة الدالة findIndex()‎ التي تُعيد فهرس العنصر الذي عُثِر عليه في المصفوفة بدلًا من قيمته؛ أما إذا أردتَ معرفة موضع عنصر مُحدَّد فانظر إلى الدالة indexOf()‎، وإذا شئت تحديد إن كان العنصر موجودًا ضمن المصفوفة فاستعمل الدالة includes()‎. البنية العامة arr.find(callback[, thisArg]) callback الدالة التي ...

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

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

الدالة Array.prototype.copyWithin()‎ تنسخ جزءًا من المصفوفة إلى مكانٍ آخر فيها نسخًا سطحيًا، وتُعيد هذا الجزء دون تعديل طول المصفوفة. ['alpha', 'bravo', 'charlie', 'delta'].copyWithin(2, 0); // ["alpha", "bravo", "alpha", "bravo"] البنية العامة arr.copyWithin(target[, start[, end]]) target الفهرس (العد يبدأ من الصفر) الذي ستوضع العناصر المنسوخة فيه، وإذا كانت هذه القيمة سالبةً فسيبدأ العد من النهاية. إذا كانت قيمة هذا الوسيط تساوي أو أكبر من arr.length، فلن يُنسَخ أيّ عنصر، وإذا كانت هذه القيمة أكبر من start، فسيُقتَطَع الجزء المنسوخ ليتسع في arr.length. ...

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

الدالة Array.prototype.map()‎ تُنشِئ مصفوفةً جديدةً باستخدام القيم المُعادة من استدعاء دالة مُحدَّدة على جميع عناصر المصفوفة الأصلية. var array1 = [1, 4, 9, 16]; // دالة سهمية const map1 = array1.map(x => x * 2); console.log(map1); // [2, 8, 18, 32] البنية العامة var new_array = arr.map(callback[, thisArg]) callback الدالة التي ستختبر كل عنصر من عناصر المصفوفة، وتقبل ثلاثة وسائط. currentValue العنصر الحالي الذي يُعالِج في المصفوفة، وهذه القيمة مطلوبة. index فهرس العنصر الحالي في المصفوفة، وهذه القيمة اختيارية. array المصفوفة التي استدعيت ...

الدالة Array.prototype.values()‎ تُعيد كائن Array Iterator جديد الذي يحتوي على كل قيمة في المصفوفة. var a = ['w', 'y', 'k', 'o', 'p']; var iterator = a.values(); console.log(iterator.next().value); // w console.log(iterator.next().value); // y console.log(iterator.next().value); // k console.log(iterator.next().value); // o console.log(iterator.next().value); // p البنية العامة arr.values() القيمة المعادة كائن Array Iterator جديد. أمثلة استخدام الحلقة for...of var arr = ['w', 'y', 'k', 'o', 'p']; var iterator = arr.values(); for (let letter of iterator) { console.log(letter); } دعم المتصفحات الميزة Chrome Firefox Internet Explorer Opera Safari ...

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

الدالة Date.prototype.getTime()‎ تعيد قيمةً رقميةً تُمثِّل التاريخ المُحدَّد وفقًا للتوقيت العالمي. لاحظ أنَّ الدالة getTime()‎ تستخدم توقيت UTC لتمثيل الوقت، أي لو كان جهاز العميل في منطقةٍ زمنيةٍ ما، فستعطي الدالة getTime()‎ نفس القيمة التي كانت ستُعطيها لمُستخدِم آخر في منطقةٍ زمنيةٍ أخرى. يمكننا الاستفادة من هذه الدالة بإسناد الوقت والتاريخ إلى كائن Date آخر، ووظيفة هذه الدالة تكافئ الدالة valueOf()‎. البنية العامة dateObj.getTime() القيمة المعادة عددٌ صحيحٌ يُمثِّل كم ملي ثانية قد مضت منذ ‎1 January 1970 00:00:00 UTC ...

هذا الدليل عبارة عن مدخل يطلعك على كيفية تسريع تطبيق ريلز عبر التخزين المؤقت. يعني التخزين المؤقت تخزين المحتوى الذي أُنشِئ أثناء دورة الاستجابة للطلب وإعادة استخدامه عند الاستجابة لطلبات مشابهة. غالبًا ما يكون التخزين المؤقت الطريقة الأكثر فاعلية لتعزيز أداء التطبيق. من خلال التخزين المؤقت، يمكن لمواقع الويب التي تعمل على خادم واحد مع قاعدة بيانات واحدة الحفاظ على تحميل الآلاف من المستخدمين المتزامنين. يوفر ريلز مجموعة مميزة من ميزات التخزين المؤقت. سوف يعلمك هذا الدليل نطاق وغرض كل ...

يُستعمَل العنصر <video> لتضمين المحتوى المرئي في المستندات، وقد يحتوي على ملف مصدري واحد أو أكثر التي تُمثَّل باستخدام الخاصية src أو عبر العنصر <source>، وسيختار المتصفح أنسب صيغة لتشغيلها. مثال عن استخدام العنصر <video> لإضافة مقطع فيديو بصيغة WebM (عبر الخاصية src) بارتفاع 360، مع عرض عناصر التحكم (عبر الخاصية controls) وله صورة غلاف تُعرَض إلى أن يبدأ تشغيله (الخاصية poster)، وستُعرَض رسالة نصية تنوِّه المستخدم أنَّ متصفحه لا يدعم العنصر <video>: <video src="khamsat.webm" controls poster="khamsat-poster.jpg" height="360"> لا ...

مقدمة وجود ملفٍّ باسم ‎tsconfig.json‎ في مجلّدٍ ما إشارةٌ إلى أنّ المجلّد هو جذر (root) مشروع TypeScript. يُحدِّد الملفّ ‎tsconfig.json‎ الملفات الجذر (root files) وخيارات الترجمة المطلوبة لترجمة المشروع. يُترجم المشروع بإحدى الطريقتين التاليتين: عبر استخدام أداة ‎tsc‎ دون أي ملفّات مُدخلَة (input files): في هذه الحالة يبحث المترجم عن الملف ‎tsconfig.json‎ بدءًا من المجلد الحالي ثمّ الصعود للأعلى في سلسلة المجلدات الآباء (parent directory chain). عبر استخدام أداة ‎tsc‎ دون أي ملفّات مُدخلَة وخيار سطر الأوامر ‎--project‎ (أو ‎-p‎ ...

يوضح هذا الدليل كيفية تعديل مشروعات كوردوفا للترقية انطلاقًا من الإصدارات القديمة من كوردوفا. تُطبَّق معظم هذه الإرشادات على المشاريع التي تم إنشاؤها باستخدام أدوات سطر الأوامر القديمة التي كانت قبل واجهة سطر الأوامر cordova. يمكنك الانتقال إلى توثيق واجهة سطر الأوامر للحصول على معلومات حول كيفية تحديث إصدار واجهة سطر الأوامر. الترقية إلى الإصدار ‎7.X.X أفضل طريقة للترقية إلى الإصدار ‎7.X.X هي إزالة منصة أندرويد من مشروعك، ثم إعادة إضافتها بالإصدار الجديد. مثلًا: cordova platform remove android cordova platform add ...

الخاصية new.target تسمح لك بمعرفة إن استدعيت دالةٌ عاديةٌ أم دالةٌ بانيةٌ باستخدام المعامل new، ففي الدوال البانية التي تُهيَّئ باستخدام المعامل new ستعيد الخاصية new.target مرجعيةً إلى الدالة البانية، أما الدوال العادية فستكون قيمة الخاصية new.target هي undefined. البنية العامة new.target الوصف التعبير new.target يحتوي على الكلمة المحجوزة new ثم نقطة ثم اسم الخاصية target، لاحظ أنَّ هذا الشكل قد يبدو من الوهلة الأولى على أنها وصولٌ إلى خاصيات أحد الكائنات، لن الكلمة المحجوزة new ليست كائنًا. الخاصية new.target ...

التعبير البرمجي import يُستخدَم لاستيراد ما صُدِّر من وحدة (module) أخرى. لاحظ أنَّ دعم هذه الميزة ما يزال محدودًا، لذا انظر إلى قسم «دعم المتصفحات» قبل استخدامها. البنية العامة import defaultExport from "module-name"; import * as name from "module-name"; import { export } from "module-name"; import { export as alias } from "module-name"; import { export1 , export2 } from "module-name"; import { export1 , export2 as alias2 , [...] } from "module-name"; import defaultExport, { export [ , [...] ] } from "module-name"; import defaultExport, * ...

مقدمة مع إضافة الأصناف إلى TypeScript ونسخة ES6، فقد ظهرت كذلك حاجةٌ إلى ميزات إضافية لدعم تعديل الأصناف وعناصر الأصناف أو توصيفها (annotating). توفّر المزخرفات (Decorators) طريقة لإضافة توصيفات وبنية برمجة وصفيّة (meta-programming) لتصريحات الأصناف وعناصرها. المزخرفات حاليًّا اقتراح في المرحلة 2 (stage 2 proposal) في JavaScript وهي متوفّرة كميّزة تجريبيّة في TypeScript. ملاحظة: المزخرفات ميّزة تجريبيّة قد تتغيّر في النسخ الجديدة مستقبلًا. لتفعيل الدعم التجريبي للمزخرفات، عليك تفعيل خيار المترجم ‎experimentalDecorators‎ إما على سطر الأوامر أو في ملفّ ‎tsconfig.json‎ ...

jQuery.ajax( url [, settings ] )‎ القيم المعادة تعيد كائنًا من النوع jqXHR. الوصف ترسل هذه الدالة طلب ‎(Ajax) HTTP غير متزامن. jQuery.ajax( url [, settings ] )‎ أُضيف مع الإصدار: 1.5. url سلسلة نصية تحتوي على العنوان URL المراد إرسال الطلب إليه. settings كائن مجرَّد (object) يمثِّل مجموعة من الأزواج مفتاح/قيمة التي تضبط طلب Ajax. جميع الإعدادات اختيارية ويمكن تعيين إعدادات افتراضية لأي ضبط باستعمال التابع ‎$.ajaxSetup()‎. انظر إلى القسم التالي للاطلاع على القائمة الكاملة لجميع الإعدادات. jQuery.ajax( [ ...

jQuery.ajax( url [, settings ] )‎ القيم المعادة تعيد كائنًا من النوع jqXHR. الوصف ترسل هذه الدالة طلب ‎(Ajax) HTTP غير متزامن. jQuery.ajax( url [, settings ] )‎ أُضيف مع الإصدار: 1.5. url سلسلة نصية تحتوي على العنوان URL المراد إرسال الطلب إليه. settings كائن مجرَّد (object) يمثِّل مجموعة من الأزواج مفتاح/قيمة التي تضبط طلب Ajax. جميع الإعدادات اختيارية ويمكن تعيين إعدادات افتراضية لأي ضبط باستعمال التابع ‎$.ajaxSetup()‎. انظر إلى القسم التالي للاطلاع على القائمة الكاملة لجميع الإعدادات. jQuery.ajax( [ ...

توفر الوحدة timer واجهة برمجيّة (API) عامة (global) لجدولة (scheduling) الدوال، مما يُمكِّن استدعاءها في فترة مستقبليّة معينة. لا حاجة لاستيراد الوحدة عبر الدالة require('timers')‎‎ لاستخدام الواجهة البرمجيّة؛ وذلك لكون دوال المكتبة عامة. تصنَع دوال المؤقتات (timers)، في Node.js، واجهة برمجيّة مشابهة لتلك الموجودة في مُتصفحات الويب ولكن باستخدام بنيّة داخليّة مُختلفة مبنيّة اعتمادًا على تقنيّة حلقة الأحداث (Event Loop). الصنف Immediate ينشَأ هذا الكائن داخليًا ويُعاد من الدالة ‎setImmediate()‎. يُمكِن تمرير هذا الكائِن إلى الدالة clearImmediate()‎‎ لإلغاء الأحداث المُجدولة. ...

‎.on( events [, selector ] [, data ], handler )‎ القيم المعادة يعيد كائنًا من النوع jQuery. الوصف يربط هذا التابع دالة معالج حدث لحدثٍ واحدٍ أو أكثر  بالعناصر المحدَّدة. ‎.on( events [, selector ] [, data ], handler )‎ أُضيف مع الإصدار: 1.7. events سلسلة نصية تحتوي على نوع حدث واحد، أو عدَّة أنواع أحداث مفصولة بمسافة فارغة بالإضافة إلى مجالات أسماء (namespaces) (اختياريَّا) مثل "click"، أو "keydown.myPlugin". selector سلسلة نصية تمثِّل اسم المحدِّد الذي يرشِّح أحفاد (descedants) العناصر ...

يجلب هذا التابع قيمة خاصِّيَّة كائن محدَّدةٍ للعنصر الأول من مجموعة العناصر المطابقة، أو يضبط قيمة خاصِّيَّة كائن واحدة أو أكثر لجميع العناصر المطابقة. ‎.prop( propertyName )‎ القيم المعادة يعيد أي شيء (وهو نوع افتراضي مُستخدَم في jQuery للإشارة إلى إمكانيَّة إعادة أي نوع). الوصف يجلب هذا التابع قيمة خاصِّيَّة كائن محدَّدةٍ للعنصر الأول من مجموعة العناصر المطابقة. ‎.prop( propertyName )‎ أُضيف مع الإصدار: 1.6. propertyName سلسلة نصية تمثِّل اسم الخاصِّيَّة المراد إعادة قيمتها. يجلب التابع ‎.prop()‎ قيمة خاصِّيَّة معينة ...

مؤشر الاستقرار: 2 - مستقر لاستخدام خادم وعميل HTTP يجب استدعاء require('http')‎. صُمِمت واجهات HTTP في Node.js لدعم العديد من ميزات البروتوكول التي كانت صعبة الاستخدام تقليديًا. على وجه الخصوص، الرسائل الكبيرة، التي قد تكون مرمّزة كقطع ضخمة. وتكون الواجهة حريصة على عدم تخزين الطلبات أو الاستجابات بأكملها مؤقتًا، بحيث يكون المستخدم قادرًا على دفق البيانات (stream data). تُمثَّل ترويسات رسائل HTTP بواسطة كائن مثل التالي: { 'content-length': '123', 'content-type': 'text/plain', 'connection': 'keep-alive', 'host': 'mysite.com', 'accept': ...

 مقدمة يوفر الصنف Illuminate\Support\Collection غلافًا ملائمًا و مساعدًا على العمل مع مصفوفات البيانات. مثلًا، تفقد الشيفرة الموالية إذ سنستعمل المساعد collect لإنشاء نسخة Collection جديدة من المصفوفة، ننفذ الدالة strtoupper مع كل عنصر، ثم نحذف كل العناصر الفارغة: $collection = collect(['taylor', 'abigail', null])->map(function ($name) { return strtoupper($name); }) ->reject(function ($name) { return empty($name); }); كما ترى، تسمح الدالة بسلسلة توابعها لتنفيذِ تخطيطِ دقيق و التحكم في حجم المصفوفة قيد العمل. بشكل عام، المجموعات غير قابلة للتغيير، أي أن كل ...

مقدمة الحزم هي الطريقة الأولى لإضافة وظائف ل Laravel. يمكن أن تكون الحزم أي شيء مثل طريقة للعمل مع التواريخ مثل Carbon أو إطار متكامل لاختبار قواعد البيانات مثل Behat. طبعًا، يوجد أنواع مختلفة من الحزم. بعض الحزم مكتفية بذاتها أي أنها تعمل مع أي إطار PHP مثل Behat و Carbon. يمكن طلب أي من هذه الحزم عبر الملف composer.json. من جهة أخرى، بعض الحزم مصنوعة خصيصا ل Laravel. هذه الحزم لديها مسارات، وحدات تحكم،  واجهات، وملفات ضبط معدة خصيصًا ...

عناصر <input> ذات النوع number تسمح للمستخدم بإدخال قيمة عددية. سيتم التحقق من صحة المدخلات تلقائيًا للتأكد أنَّها أعداد وسيرفض المتصفح أيّة قيم غير رقمية، ويمكن أن يوفر المتصفح أسهمًا بجوار هذا الحقل للسماح للمستخدم بزيادة أو إنقاص القيمة باستخدام الفأرة أو بالضغط عليها بأصبعه. إذا لم يكن المتصفح يدعم الحقل number فسيستخدم المتصفح الحقل text الافتراضي. <input type="number" name="number"> الخاصية value تُمثَّل قيمة الخاصية value بكائن Number. يمكنك ضبط القيمة الافتراضية في هذا الحقل بإسناد رقم للخاصية value كما ...

تعريف الحزم (Package) يُكتب توصيف الحزمة (package) في بداية الملف المصدريّ (source file) بالشكل الآتي: package my.demo import java.util.* // ... ولا يُشترط التوافق ما بين الحزمة (package) والمجلد الذي توجد فيه (directory)، إذ من الممكن أن تتوضع الملفات المصدريّة عشوائيًّا في نظام الملفات. المزيد عن الحزم (packages). تعريف الدوال (Function) إن كانت الدالة بمتحولين من نوع Int وتعيد قيمةً بنوع Int أيضًا، فسيصبح تعريفها بالشكل: fun sum(a: Int, b: Int): Int {   return a + b } أما الشيفرة الآتية فهي لتعريف دالةٍ باسم sum ...

‎.bind( eventType [, eventData ], handler )‎ القيمة المعادة كائن jQuery. أُهمِل هذا التّابع في الإصدار: 3.0. الوصف يُستخدَم التّابع ‎.bind()‎ في إرفاق مُعالِج أحداث (Event handler) لحدثٍ ما للعناصر. ‎.bind( eventType [, eventData ], handler )‎ أضيفت في الإصدار: 1.0. eventType سلسلة نصيّة، وتُمثِّل أنواع حدث DOM مثل click، أو submit، أو أسماء مُخصَّصة للأحداث. eventData أي شيء (وهو نوع افتراضي مُستخدَم في jQuery للإشارة إلى إمكانيّة استخدام أي نوع)، ويُمثِّل كائن يحتوي على البيانات التي ستُمرَّر إلى مُعالِج ...

 الكلمات المفتاحيّة الثابتة (Hard Keywords) تُعدُّ الكلمات الآتية كلماتٍ مفتاحيّةً في لغة Kotlin وليس ممكنًا استخدامها كمُعرِّفات (identifiers): as تُستخدَم في التحويلات ما بين الأنواع (typecasts) تُحدِّد تسميةً بديلةً (alias) عند عملية الاستيراد (import) as?‎ للتحويلات الحافظة للنوع (safe type casts) break لإنهاء تنفيذ الحلقات (loops) class للتصريح عن الأصناف continue  للاستمرار بالخطوة التالية لأقرب حلقة محيطة (enclosing) do للبدء بحلقة do/while (والتي يُختبَر الشرط فيها لاحقًا) else لتعريف فرعٍ (branch) من تعبير الشرط if والذي سيُنفَّذ عندما يكون الشرط بالقيمة false false ...