The @esmj/task is tiny package for divide long task to new tasks and improve browser responsiveness, user experience and INP (core web vitals) metric. The new tasks are creating only if it is need.

• Node 18+

npm install @esmj/task

It works for both Javascript modules (ESM and CJS).

import { autoYield, autoYieldStartPoint } from '@esmj/task';

(async () => {
  const tasks = [
    longRunnigTask1,
    normalTask1,
    normalTask2,
    longRunnigTask2
  ];

  autoYieldStartPoint()
  for (const task of tasks) {
    await autoYield()
    await task();
  }
})

Type: () => Promise<void> Method divide long task to new tasks if it is need. If autoYield method is called without set start point with autoYieldStartPoint method then the first call of autoYield method is forceYield. If autoYield logic is turn off then returns immediately resolved Promise.

Type: () => Promise<void> Method create new task for every call, yield to next event loop (0 ms delay).

Type: () => Promise<void> Method create new task for every call, yield to next frame (16 ms delay).

Type: () => void Method reset logic for creating new tasks.

Type: () => void Method set start point for autoYield method so first call of autoYield method not create new task with forceYield.

Type: ({ autoEnable: boolean, autoShareContext: boolean }) => void Method config package autoEnable: turn on/off autoYield logic and autoShareContext: turn on/off shared context through global variable.