Highlight: Highlight() constructor

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

The Highlight() constructor returns a newly created Highlight object which can hold a collection of Range objects to be styled using the CSS Custom Highlight API.

Syntax

js
new Highlight()
new Highlight(range)
new Highlight(range1, range2, /* …, */ rangeN)

Parameters

range1, …, rangeN Optional

One ore more initial Range objects to add in the new highlight.

Return value

A new Highlight object.

Examples

The example code below demonstrates how to create an empty highlight object, and then add ranges to it:

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

The example code below demonstrates how to create a new highlight object and add ranges to it during instantiation:

js
const highlight = new Highlight(range1, range2);

Specifications

Specification
CSS Custom Highlight API Module Level 1
# dom-highlight-highlight

Browser compatibility

desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Highlight() constructor

See also