大网数据广告活动
Web 标准与前端开发

Range: compareBoundaryPoints() method

· 52CE 我爱测

The **`compareBoundaryPoints()`** method of the Range interface compares the boundary points of the Range with those of another range.

DOM

The compareBoundaryPoints() method of the Range interface compares the boundary points of the Range with those of another range.

Syntax

compareBoundaryPoints(how, otherRange)

Parameters

  • how
    • : A constant describing the comparison method:
      • Range.END_TO_END compares the end boundary-point of this Range to the end boundary-point of otherRange.
      • Range.END_TO_START compares the start boundary-point of this Range to the end boundary-point of otherRange.
      • Range.START_TO_END compares the end boundary-point of this Range to the start boundary-point of otherRange.
      • Range.START_TO_START compares the start boundary-point of this Range to the start boundary-point of otherRange.
  • otherRange
    • : A Range to compare boundary points with the range.

Return value

A number.

  • -1 if the specified boundary-point of this Range is before the specified boundary-point of otherRange.
  • 0 if the specified boundary-point of this Range is the same as the specified boundary-point of otherRange.
  • 1 if the specified boundary-point of this Range is after the specified boundary-point of otherRange.

This API is consistent with the general convention that, when comparing A to B, a negative number means A comes before B and vice versa (see for example Array.prototype.sort()). The ranges are compared in the direction of this to other, the same as String.prototype.localeCompare(). However, the boundary points are specified in the reverse order for the how parameter: END_TO_START compares the start of this to the end of other.

Exceptions

  • NotSupportedError DOMException
    • : Thrown if the value of the how parameter is invalid.

Examples

Below, we create two ranges on the same text node and compare their different boundary points.

const text = new Text("0123456789");

const thisRange = new Range();
thisRange.setStart(text, 1);
thisRange.setEnd(text, 6);

const otherRange = new Range();
otherRange.setStart(text, 1);
otherRange.setEnd(text, 4);

// The ranges look like this:
// thisRange start   v---------v thisRange end
//                  0 1 2 3 4 5 6 7 8 9
// otherRange start  ^-----^ otherRange end

// this start is *same as* other start
thisRange.compareBoundaryPoints(Range.START_TO_START, otherRange); // 0

// this end is *after* other start
thisRange.compareBoundaryPoints(Range.START_TO_END, otherRange); // 1

// this start is *after* other end
thisRange.compareBoundaryPoints(Range.END_TO_START, otherRange); // -1

// this end is *after* other end
thisRange.compareBoundaryPoints(Range.END_TO_END, otherRange); // 1

Specifications

Browser compatibility

See also

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。