نتائج البحث

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

الدالة 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)‎، إذ لا تستطيع استخدامها كجزء من ...