TaskController: setPriority() метод

Метод setPriority() интерфейса TaskController может быть вызван для установки нового приоритета для signal данного контроллера. Если задаче с приоритетом настроено использование сигнала, это также изменит приоритет задачи.

Наблюдатели уведомляются об изменениях приоритета путём отправки события prioritychange. Метод уведомит только в том случае, если приоритет действительно изменился (событие не генерируется, если приоритет не будет изменён вызовом).

Обратите внимание, что приоритет задачи может быть изменён только для задач с изменяемым приоритетом. Если задача неизменяема, вызов функции игнорируется.

priority

Приоритет задачи. Один из: "user-blocking", "user-visible", "background".

Ничего (undefined).

NotAllowedError DOMException

Изменение приоритета уже началось.

Сначала мы создаём контроллер задач. В данном случае мы не задаём приоритет, поэтому он будет по умолчанию user-visible.

// Create a TaskController with default priority: 'user-visible'
const controller = new TaskController();

Затем мы передаём сигнал контроллера методу Scheduler.postTask().

// Post task passing the controller's signal.
// The signal priority sets the initial priority of the task
scheduler
  .postTask(() => "Task execute", { signal: controller.signal })
  .then((taskResult) => {
    console.log(`${taskResult}`);
  }) // Run on success)
  .catch((error) => {
    console.log(`Catch error: ${error}`);
  }); // Run on fail

Затем контроллер можно использовать для изменения приоритета

// Change the priority to 'background' using the controller
controller.setPriority("background");

Дополнительные примеры, включая показ того, как обработать событие, возникающее при изменении приоритета, можно найти в: API планирования задач с приоритетами > Примеры.