مولد تعبيرات node-cron

صيغة node-cron

يتكوّن تعبير node-cron من خمسة حقول، أو ستة عند إضافة الثواني في البداية. ومع خمسة حقول تعمل المهمة عند الثانية 0:

الرموز الخاصة

أمثلة على كرون node-cron

اضغط على أي تعبير لتحميله في المولّد أعلاه.

الفرق بين node-cron وكرون تاب في لينكس

• يأتي حقل الثواني الاختياري أولًا، فالتعبير */10 * * * * * يعمل كل 10 ثوانٍ، بينما لا يعرف كرون تاب الثواني أصلًا.
• إذا حدّدت يوم الشهر ويوم الأسبوع معًا فيجب أن يتطابقا معًا: فالتعبير 0 0 13 * 5 لا يعمل إلا يوم الجمعة الموافق 13، أما كرون تاب فيشغّله في كل يوم 13 وفي كل جمعة.
• الرموز L وW و# مأخوذة من Quartz، لكن ترقيم الأيام ليس كذلك: 1 تعني الإثنين كما في كرون تاب، ويمكن تحديد حقلي اليوم معًا.
• تعمل المهام داخل عملية Node.js نفسها، فلا يعمل شيء أثناء توقفها، وتشغّل كل نسخة من تطبيقك نسختها الخاصة من المهمة ما لم تضبط distributed: true (من 4.4).
• من دون الخيار timezone تتبع الجداول المنطقة الزمنية لعملية Node.js، وغالبًا ما تكون UTC على الخوادم وداخل الحاويات.

الاستخدام في Node.js

جدول دالة باستخدام cron.schedule(). في الإصدار 4 من node-cron تبدأ المهمة فورًا، وتحدّد الخيارات المنطقة الزمنية وتتخطى أي تشغيل جديد ما دام السابق لم ينتهِ:

import cron from 'node-cron';

const task = cron.schedule('0 30 8 * * 1-5', async () => {
  await sendDailyReport();
}, {
  name: 'daily-report',
  timezone: 'Asia/Riyadh',
  noOverlap: true,
});

cron.validate('0 30 8 * * 1-5'); // true
task.getNextRuns(3);             // the next three run dates (4.4+)

تقرأ node-cron 3 بعض التعبيرات بطريقة مختلفة: فالخطوة فيها لا تُبقي إلا القيم التي تقبل القسمة عليها، لذا يعمل 5-59/15 عند الدقائق 15 و30 و45 بدلًا من 05 و20 و35 و50. نفّذ npm ls node-cron لمعرفة الإصدار المثبّت لديك.

الأسئلة الشائعة

مولدات كرون لمنصات أخرى

تصفّح كل أمثلة تعبيرات الكرون ←