HighlightRegistry: метод forEach()

Метод forEach() интерфейса HighlightRegistry выполняет переданную функцию один раз для каждого объекта Highlight в реестре в порядке вставки.

HighlightRegistry — это объект, похожий на Map, поэтому он аналогичен использованию Map.forEach().

callback

Функция, которая выполняется для каждого объекта Highlight, принимающая три аргумента:

highlight

Текущий выделенный фрагмент.

name

Имя выделенного фрагмента.

registry

Объект реестра, на котором был вызван метод forEach().

thisArg

Значение, используемое в качестве this при выполнении callbackFn.

None (undefined).

Следующий фрагмент кода демонстрирует создание нового выделенного фрагмента с двумя диапазонами и последующий вывод диапазонов с помощью метода forEach():

function logAllHighlights(highlight, name) {
  console.log(`Highlight ${name} exists in the registry`, highlight);
}

const customHighlight1 = new Highlight();
const customHighlight2 = new Highlight();
const customHighlight3 = new Highlight();

CSS.highlights.set("custom-highlight-1", customHighlight1);
CSS.highlights.set("custom-highlight-2", customHighlight2);
CSS.highlights.set("custom-highlight-3", customHighlight3);

CSS.highlights.forEach(logAllHighlights);

• API пользовательских выделений CSS
• API пользовательских выделений CSS: предварительный просмотр будущего выделения диапазонов текста в веб-приложениях