-
Notifications
You must be signed in to change notification settings - Fork 0
Scheduled
Esta librería permite programar tareas a ejecutar mediante un patrón de tiempo. Dispone de control de estado, conociendo en todo momento todas las tareas que se han programado en la propiedad Scheduled.jobs y pudiendo por lo tanto, realizar acciones sobre éstas.
Para crear una tarea se instancia un objeto de tipo Scheduled:
var Scheduled = require("scheduled");
var myJob = new Scheduled({
id: "minuteTaskEven",
pattern: "*/2", // Tarea a ejecutar cada dos minutos
task: function(){
console.log("Minuto par");
}
}).start();
##Crear una tarea Al instanciar el objeto para crea una tarea hay que definir un conjunto de propiedades:
- id: String. Identificador de la tarea.
- pattern: String. Patrón de tiempo en el que se ejecutará la tarea. Sigue el formato cron.
- task: function. Tarea a ejecutar.
var myJob = new Scheduled({
id: "minuteTaskEven",
pattern: "*/2",
task: function(){
console.log("Minuto par");
}
}).start();
##Propiedades ###Scheduled.jobs Propiedad estática. Es de tipo ObjectArray, contiene todas las tareas que se han programado. Cada vez que se crea un nueva tarea programada se inserta en Scheduled.jobs.
Al ser de tipo ObjectArray permite capturar mediante identificador una tarea y manipularla, entre muchas otras funcionalidades. Ver ObjectArray.
###myJob.last Última vez que se ejecutó la tarea. En caso de aún no haberse ejecutado, devolverá undefined.
###myJob.next Próxima vez que se va a ejecutar la tarea. Si no se va a ejecutar más, devolverá undefined.
##Métodos ###Scheduled.close() Método estático. Para todas tareas programadas.
###myJob.start() Inicia la programación de una tarea. Si no toca que se ejecute, no se ejecutará.
###myJob.stop(); Detiene la programación de una tarea.
###myJob.launch(); Ejecuta una tarea sin iniciar su programación.
###myJob.clear(); Elimina la tarea de Scheduled.jobs.
http://www.nncron.ru/help/EN/working/cron-format.htm
var Scheduled = require("scheduled"); var i18n = require("textualization"); i18n.languages = ['es']; /* scheduled 2min. cron-jobs Cada dos minutos muestra unmensaje en consola
Scheduled.jobs es un object array que contiene todas las tareas que se han programado. cada vez que se hace un new Scheduled se mete en Scheduled.jobs
Scheduled.close(); // hace un stop de todos los jobs. cada job tiene las propiedades con las que se crean, tiene un método configure, para reconfigurar el job. metodo start. que inicia esa programación. metodo stop. que para la programación metodo launch, que dispara la tarea. metodo clear. que crea el job del cron y se apaga.
cada job:
- last - undiefined si todavia no se ha ejecutado. la ultima vez que se ejecutó.
- next - la proxima vez que se va a ejecutar la tarea. puede ser undefined. */
var myJob = new Scheduled({ id: "minuteTaskEven", pattern: "*/2", //patron, string, patron del tipo crojob task: function(){ console.log("Minuto par"); }//función - tarea que se va a realizar }).start();