Range.comparePoint()

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

The Range.comparePoint() method returns -1, 0, or 1 depending on whether the referenceNode is before, the same as, or after the Range.

If the reference node is a Node of type Text, Comment, or CDATASection, then offset is the number of characters from the start of reference node. For other Node types, offset is the number of child nodes between the start of the reference node.

Syntax

returnValue = range.comparePoint(referenceNode, offset)

Parameters

referenceNode
The Node to compare with the Range.
offset
An integer greater than or equal to zero representing the offset inside the referenceNode.

Example

range = document.createRange();
range.selectNode(document.getElementsByTagName('div').item(0));
returnValue = range.comparePoint(document.getElementsByTagName('p').item(0), 1);

Specification

Specification Status Comment
DOM
The definition of 'Range.comparePoint()' in that specification.
Living Standard Initial specification.

Browser compatibility

DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidFirefox for AndroidOpera for AndroidSafari on iOSSamsung Internet
comparePoint
Experimental
Chrome Full support YesEdge Full support 17Firefox Full support YesIE No support NoOpera Full support 15Safari Full support YesWebView Android Full support YesChrome Android Full support YesFirefox Android Full support YesOpera Android Full support 14Safari iOS Full support YesSamsung Internet Android Full support Yes

Legend

Full support
Full support
No support
No support
Experimental. Expect behavior to change in the future.
Experimental. Expect behavior to change in the future.

See also