Ember-raf-scheduler NPM

ember-raf-scheduler

Super simple RAF scheduler that integrates with the Ember runloop

Compatibility

Ember.js v3.12 or above (possibly older, but older than 3.12 is untested)
Ember CLI v4.4 or above
Node.js v16 or above

Basics

Super simple example:

import { scheduler } from 'ember-raf-scheduler';

// schedule a job
const job = scheduler.schedule('measure', () => {
  console.log('Hello, world!');
});

// cancel the job
scheduler.forget(job);

There are 4 queues:

sync - Wrapped in a runloop, use this queue for all Ember related work
layout - This queue can be used for touch up on the Ember work in general (small DOM manipulations, for instance)
measure - General measurements should occur here
affect - Fixup DOM manipulation after measurements have been done

Tokens

Tokens can be created and passed into the scheduler. All jobs that were scheduled with a token can be cancelled by cancelling the parent token.

import { scheduler, Token } from 'ember-raf-scheduler';

export default Component.extend({
  init() {
    this.token = new Token();
  },

  willDestroy() {
    scheduler.forget(this.token);
  },

  schedule(queue, job) {
    scheduler.schedule(queue, job, this.token);
  }
});

Perf Notes

Measurements in RAFs are basically free if you do them before any other DOM manipulation (same rules as standard forced layouts, etc), so you should batch all measurements in measure and if possible avoid using the sync and layout queues. There are times when it's necessary to do Ember specific manipulations (for instance, you need to use set and you want the template to render before you measure) which is what the sync and layout queues are for.