Диапазон: метод compareBoundaryPoints()

Базовая линия Широко доступна

Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна в браузерах с марта 2017 года.

Метод Range.compareBoundaryPoints() сравнивает граничные точки объекта Range с граничными точками другого диапазона.

Синтаксис

compareBoundaryPoints(how, sourceRange)

Параметры

how

Константа, описывающая метод сравнения:

Range.END_TO_END сравнивает конечную граничную точку sourceRange с конечной граничной точкой Range.
Range.END_TO_START сравнивает конечную граничную точку sourceRange с начальной граничной точкой Range.
Range.START_TO_END сравнивает начальную граничную точку sourceRange с конечной граничной точкой Range.
Range.START_TO_START сравнивает начальную граничную точку sourceRange с начальной граничной точкой Range.

sourceRange

Объект Range для сравнения граничных точек с диапазоном.

Возвращаемое значение

Число, -1, 0, или 1, указывающее, находится ли соответствующая граничная точка Range соответственно перед, равна или после соответствующей граничной точки sourceRange.

Исключения

NotSupportedError DOMException: Выбрасывается, если значение параметра how некорректно.

Примеры

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);

Спецификации

Спецификация
DOM # dom-range-compareboundarypoints

Совместимость с браузерами

	Рабочие столы					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari на iOS	Samsung Internet	WebView Android
`compareBoundaryPoints`	1	12	1	9	1	18	4	10.1	1	1.0	4.4

См. также

Индекс интерфейсов DOM

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/Range/compareBoundaryPoints