Scheduled

For reasons of time and advancement in technologies, especially JS, this project is no longer maintained.

Thank you for your support and interest in this project.

We personally think this is a good example of simplifying JS code in Node for these purposes and hopefully we'll have enough time to come back to this idea or something similar.

This project has favored great relationships and has provided a lot of learning for its participants

See you later! <3

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.