وأنت تكتب الشيفرة، ستقول في نفسك «أريد تشغيل هذه الدالة بعد قليل وليس الآن الآن. هذا ما نسمّيه “بجدولة الاستدعاءات” (scheduling a call).
إليك دالتين اثنتين لهذه الجدولة:
- يتيح لك
setTimeout تشغيل الدالة مرّة واحدة بعد فترة من الزمن. - يتيح لك
setInterval تشغيل الدالة تكراريًا يبدأ ذلك بعد فترة من الزمن ويتكرّر كلّ فترة حسب تلك الفترة التي حدّدتها.
صحيح أنّ هاتين الدالتين ليستا في مواصفة لغة جافا سكريبت إلّا أنّ أغلب البيئات فيها مُجدوِل داخلي يقدّمهما لنا. وللدقّة، فكلّ المتصّفحات كما وNode.js تدعمهما.
setTimeout
صياغة الشيفرة:
let timerId = setTimeout(func|code, [delay], [arg1], [arg2], ...)
المتغيرات:
func|code- ما يجب تنفيذه أكان دالة أو سلسلة نصية فيها شيفرة. عادةً, هي دالة ولكن كعادة الأسباب التاريخية (أيضًا) يمكن تمرير سلسلة نصية فيها شيفرة، ولكنّ ذلك ليس بالأمر المستحسن.
delay- The delay before run, in milliseconds (1000 ms = 1 second), by default 0.
arg1,arg2…- وُسطاء الدالة (ليست مدعومة في IE9-)
إليك هذه الشيفرة التي تستدعي sayHi() بعد ثانيةً واحدة:
function sayHi() {
alert('Hello');
}
setTimeout(sayHi, 1000);
مع المتغيرات:
function sayHi(phrase, who) {
alert( phrase + ', ' + who );
}
setTimeout(sayHi, 1000, "Hello", "John"); // Hello, John
If the first argument is a string, then JavaScript creates a function from it.
So, this will also work:
setTimeout("alert('Hello')", 1000);
But using strings is not recommended, use arrow functions instead of them, like this:
setTimeout(() => alert('Hello'), 1000);
يُخطئ المبرمجون المبتدئون أحيانًا فيُضيفون أقواس () بعد الدالة:
// wrong!
setTimeout(sayHi(), 1000);
لن يعمل ذلك إذ يتوقّع setTimeout إشارة إلى الدالة، بينما هنا sayHi() يشغّل الدالة وناتج التنفيذ هو الذي يُمرّر إلى setTimeout. في حالتنا ناتج sayHi() ليس معرّفًا undefined (إذ لا تُعيد الدالة شيئًا)، ويعني ذلك أنّ عملنا ذهب سدًى ولم نُجدول أي شيء.
الإلغاء باستعمال دالة clearTimeout
نستلمُ حين نستدعي setTimeout «هويّةَ المؤقّت» timerId ويمكن استعمالها لإلغاء عملية التنفيذ.
The syntax to cancel:
let timerId = setTimeout(...);
clearTimeout(timerId);
In the code below, we schedule the function and then cancel it (changed our mind). As a result, nothing happens: