Highlight: Highlight() constructor

Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

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

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:

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:

const highlight = new Highlight(range1, range2);

Specifications

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

Browser compatibility

BCD tables only load in the browser

See also