Sign Up for Free

RunKit +

Try any Node.js package right in your browser

This is a playground to test code. It runs a full Node.js environment and already has all of npm’s 400,000 packages pre-installed, including rafael with all npm packages installed. Try it out:

var rafael = require("rafael")

This service is provided by RunKit and is not affiliated with npm, Inc or the package authors.

rafael v4.2.11

Rafael.js is a simple scheduling library based on the requestAnimationFrame loop.

Rafael

npm Bower Open Github Issues Dependencies Travis CI Build

Rafael.js is a simple client side rafael based on the requestAnimationFrame loop. Typically you may use something like window.setInterval() or window.setTimeout() to achieve this.

However, requestAnimationFrame allows us to utilize the GPU, avoiding the performance bottlenecks of those other methods. requestAnimationFrame is intended to allow Javascript animations to utilize the computer's GPU so it can be handled at ~60fps (performance depends on the machine). Rafael just makes it easy to control multiple tasks running on the requestAnimationFrame loop.

NOTE: This plugin will make it really, really, really easy to bog down your app. Schedule with caution.

Usage

Create a new instance of Rafael:

var rafael = new Rafael;

Now let's schedule something:

var foo = function () {
  console.log('Do a thing.');
};

rafael.schedule('foo', foo);

Then let's stop it:

rafael.unschedule('foo');

Boom. Now let's get crazy:

var fooCounter = 0;
var barCounter = 0;

var foo = function () {
  console.log('foo has run ' + fooCounter + ' times.');
  fooCounter++;
};

var bar = function () {
  console.log('bar has run ' + barCounter + ' times.');
  barCounter++;
};

rafael.schedule('foo', foo);
rafael.schedule('bar', bar);

setTimeout(function () {
  rafael.unschedule('foo');
}, 1000)

Rafael will be happy to run as many tasks as you want to give it.

API

new Rafael

Creates and returns a new instance of Rafael.

Rafael.schedule(taskId, task[, options])

The schedule() method adds a task to the schedule, causing it to run on every iteration of the schedule loop. Returns the task's ID.

ParameterRequired/OptionalDescription
taskIdoptionalA string used to manipulate the task within the context of the Rafael. If an ID is not passed then the task's ID will be it's index in Rafael.tasks.
taskrequiredThe function to be run.
optionsoptionalThis is a hash of options to be considered for the task.

Options

OptionTypeDefaultDescription
contextObjectwindowThe value of this within the task
framerateNumber60The number of times the task should run per second. Max is 60.
pausedBooleanfalseWhether or not the task should start immediately. Tasks that receive paused can be kicked off with Rafael.start.

Rafael.unschedule(taskId)

The unschedule() method removes a task from the schedule and stops it from running. Returns a success boolean.

ParameterRequired/OptionalDescription
taskIdrequiredThe task to be removed from the schedule. This will completely remove the task from the Rafael so it cannot be restarted.

Rafael.pause([taskId])

The pause() method pauses a task without removing it from the schedule. The task can later be restarted with start().

ParameterRequired/OptionalDescription
taskIdoptionalThe task to be paused. If no taskId is passed, the entire rafael will be paused.

Rafael.start([taskId])

The start() method restarts a paused task.

ParameterRequired/OptionalDescription
taskIdoptionalThe task to be started. If no taskId is passed, the entire rafael will be started.

Rafael.clear()

Removes all tasks from the rafael.

RunKit is a free, in-browser JavaScript dev environment for prototyping Node.js code, with every npm package installed. Sign up to share your code.
Sign Up for Free