The values() method of the Highlight interface returns a new Iterator object that contains the values for each Range object in the Highlight object in insertion order.

Highlight is a Set-like object, so this is similar to using Set.values().

A new iterator object containing each Range object in the given Highlight, in insertion order.

The following code snippet shows how to create a new Highlight object with three Range objects, and use the iterator returned by the values() method to log the three ranges:

const myHighlight = new Highlight();
myHighlight.add(new Range());
myHighlight.add(new Range());
myHighlight.add(new Range());

const iter = myHighlight.values();

for (value of iter) {
  console.log(value); // Range
}

• The CSS Custom Highlight API
• CSS Custom Highlight API: The Future of Highlighting Text Ranges on the Web