W3cubDocs

/Web APIs

Highlight: values() method

Baseline 2025

Newly available

Since ⁨June 2025⁩, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.

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.

Note: The keys() method is an alias for this method. It behaves exactly the same and returns values of Highlight elements.

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

Syntax

values()

Parameters

None.

Return value

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

Examples

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
}

Specifications

Specification
ECMAScript® 2026 Language Specification> # sec-set.prototype.values>

Browser compatibility

	Desktop					Mobile
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox for Android	Opera Android	Safari on IOS	Samsung Internet	WebView Android	WebView on iOS
`values`	105	105	140	91	17.2	105	140	72	17.2	20.0	105	17.2