Подсветка: метод entries()

Ограниченная доступность

Эта функция не относится к Baseline, так как она не работает во всех широко используемых браузерах.

Метод entries() интерфейса Highlight возвращает новый объект итератора, содержащий массив [range, range] для каждого объекта Range в объекте Highlight, в порядке вставки.

Highlight — это объект, подобный Set, поэтому это аналогично использованию Set.entries().

Синтаксис

entries()

Возвращаемое значение

Новый объект итератора, содержащий массив [range, range] для каждого объекта Range в заданном Highlight, в порядке вставки.

Примеры

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

const text = new Text("Time is an illusion. Lunchtime doubly so.");

const range1 = document.createRange();
range1.setStart(text, 0);
range1.setEnd(text, 4);

const range2 = document.createRange();
range2.setStart(text, 21);
range2.setEnd(text, 30);

const myHighlight = new Highlight();
myHighlight.add(range1);
myHighlight.add(range2);

const iter = myHighlight.entries();

console.log(iter.next().value); // [Range, Range]
console.log(iter.next().value); // [Range, Range]

Следующий пример демонстрирует итерацию по диапазонам в подсветке с использованием цикла for...of:

const text = new Text("Time is an illusion. Lunchtime doubly so.");

const range1 = document.createRange();
range1.setStart(text, 0);
range1.setEnd(text, 4);

const range2 = document.createRange();
range2.setStart(text, 21);
range2.setEnd(text, 30);

const highlight = new Highlight();
highlight.add(range1);
highlight.add(range2);

for (const [range] of highlight.entries()) {
  console.log(range.toString());
  // Time
  // Lunchtime
}

Спецификации

Спецификация
Спецификация языка ECMAScript # sec-set.prototype.entries

Совместимость с браузерами

	Рабочие столы					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari на iOS	Samsung Internet	WebView Android
`entries`	105	105	предварительный просмотр	91	17.2	105	Нет	72	17.2	20.0	105

См. также

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/Highlight/entries