node-cron is a simple cron-like task scheduler for Node.js, written in pure JavaScript. It lets you schedule jobs using full GNU crontab syntax (including optional seconds) and is useful for running recurring tasks at specified times.
Project status
- Maintenance status: The repo shows an upstream push on 2026-02-14, but the most recent published updates in the provided history are v4.2.1 and v4.2.2 (2025-07-10), so maintenance appears intermittent and quiet relative to releases.
- Update cadence: After clustered patches (v4.2.0 to v4.2.2 in early July 2025), there are no further documented versioned updates up to 2026-06-09.
AI summary generated
Recent updates
v4.2.1
Release v4.2.1 has no publisher release notes provided. The code diff shows multiple API and behavior changes around path resolution/import for background tasks, scheduling execution timing, and task registry/matcher internals.
Featuresv4.2.2
Release v4.2.2 has no publisher-provided release notes. The code changes add scheduling jitter support via a new maxRandomDelay option, adjust runner execution timing and error handling flow, and modify time parsing and matcher traversal logic.
BreakingFeaturesv4.2.0
Release v4.2.0 was published on 2025-07-01, but the publisher did not provide any release notes. As a result, there is no documented information available here about new features, bug fixes, breaking changes, security, or migrations.
v4.0.0
v4.0.0 is primarily a major internal refactor, migrating the project to TypeScript (and changing code structure to a new folder layout). The release notes also mention a README-only documentation addition for the recoverMissedExecutions option and an ES6/docs migration, but they do not enumerate functional API changes.
Breakingv3.0.0
Version 3.0.0 is a major internal refactor of the scheduler, introducing a new scheduling pipeline (TimeMatcher, Scheduler) and a new BackgroundScheduledTask mode that runs jobs in a child process. The public runtime API for scheduled tasks changes significantly, shifting from status-based behavior to an EventEmitter model with a new task-done event.
Featuresv2.0.0
Version 2.0.0 introduces timezone support (via tz-offset), adds a getStatus helper for reading task state, and allows task functions to return promises so node-cron can await them. It also removes the ImmediateStart option, replacing it with an options parameter using scheduled to preserve the prior behavior.
BreakingFeatures