Range: compareBoundaryPoints() Methode
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since March 2017.
Die Range.compareBoundaryPoints()-Methode vergleicht die Grenzpunkte des Range mit denen eines anderen Bereichs.
Syntax
js
compareBoundaryPoints(how, sourceRange)
Parameter
how-
Eine Konstante, die die Vergleichsmethode beschreibt:
Range.END_TO_ENDvergleicht den End-Grenzpunkt von sourceRange mit dem End-Grenzpunkt vonRange.Range.END_TO_STARTvergleicht den End-Grenzpunkt von sourceRange mit dem Start-Grenzpunkt vonRange.Range.START_TO_ENDvergleicht den Start-Grenzpunkt von sourceRange mit dem End-Grenzpunkt vonRange.Range.START_TO_STARTvergleicht den Start-Grenzpunkt von sourceRange mit dem Start-Grenzpunkt vonRange.
sourceRange-
Ein
Range, mit dem die Grenzpunkte des Bereichs verglichen werden sollen.
Rückgabewert
Eine Zahl, -1, 0 oder 1, die anzeigt, ob der entsprechende Grenzpunkt des Range jeweils vor, gleich oder nach dem entsprechenden Grenzpunkt von sourceRange liegt.
Ausnahmen
NotSupportedErrorDOMException-
Wird ausgelöst, wenn der Wert des
how-Parameters ungültig ist.
Beispiele
js
const range = document.createRange();
range.selectNode(document.querySelector("div"));
const sourceRange = document.createRange();
sourceRange.selectNode(document.getElementsByTagName("div")[1]);
const compare = range.compareBoundaryPoints(Range.START_TO_END, sourceRange);
Spezifikationen
| Specification |
|---|
| DOM # dom-range-compareboundarypoints |
Browser-Kompatibilität
BCD tables only load in the browser