范围：compareBoundaryPoints() 方法

Range.compareBoundaryPoints() 方法比较 Range 的边界点与另一个范围的边界点。

语法

js
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参数的值无效，则抛出此异常。

示例

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

规范

规范
DOM 标准
# dom-range-compareboundarypoints

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。

另请参阅