Bug 2018359 [wpt PR 57954] - Add OpaqueRange disconnect() method, a=testonly

stephanieyzhang · moz-wptsync-bot · commit 9fdc51f60a9f · 2026-02-26T15:18:42.000Z
Automatic update from web-platform-tests Add OpaqueRange disconnect() method Implement disconnect() per WHATWG DOM spec PR #1404 [0]. Detaches the range from its element, stopping live offset updates and zeroing offsets. Calling it multiple times is safe and has no additional effect. Adds WPT tests covering disconnect behavior. Automatic disconnection when the element is removed from the tree or changes type will be handled in a follow-up CL. [0] whatwg/dom#1404 (comment) Low-Coverage-Reason: COVERAGE_UNDERREPORTED Bug: 421421332 Change-Id: I6f0bb55d57f1eb1876779faad018a19d23b1d665 Reviewed-on: https://chromium-review.googlesource.com/c/chromium/src/+/7595177 Reviewed-by: Dan Clark <daniec@microsoft.com> Commit-Queue: Stephanie Zhang <stephanie.zhang@microsoft.com> Reviewed-by: Ana Sollano Kim <ansollan@microsoft.com> Reviewed-by: Mason Freed <masonf@chromium.org> Cr-Commit-Position: refs/heads/main@{#1588113} -- wpt-commits: 60a655bbbf88ba39ae3959de9e405c4284dd0eba wpt-pr: 57954
diff --git a/testing/web-platform/tests/dom/ranges/tentative/OpaqueRange-disconnect.html b/testing/web-platform/tests/dom/ranges/tentative/OpaqueRange-disconnect.html
@@ -0,0 +1,74 @@
+<!DOCTYPE html>
+<script src="/resources/testharness.js"></script>
+<script src="/resources/testharnessreport.js"></script>
+<body></body>
+<script>
+test(() => {
+  document.body.innerHTML = '<textarea>Hello</textarea>';
+  const textarea = document.body.firstElementChild;
+  const range = textarea.getValueRange(1, 4);
+
+  range.disconnect();
+
+  assert_equals(range.startOffset, 0, "startOffset resets to 0");
+  assert_equals(range.endOffset, 0, "endOffset resets to 0");
+  assert_true(range.collapsed, "range is collapsed");
+  assert_equals(range.startContainer, null, "startContainer remains null");
+  assert_equals(range.endContainer, null, "endContainer remains null");
+  assert_equals(range.getClientRects().length, 0, "no client rects");
+  assert_equals(range.getBoundingClientRect().width, 0, "bounding rect width is 0");
+  assert_equals(range.getBoundingClientRect().height, 0, "bounding rect height is 0");
+}, "disconnect() resets range state and geometry.");
+
+test(() => {
+  document.body.innerHTML = '<textarea>Hello</textarea>';
+  const textarea = document.body.firstElementChild;
+  const range = textarea.getValueRange(1, 4);
+
+  range.disconnect();
+  range.disconnect();
+
+  assert_equals(range.startOffset, 0);
+  assert_equals(range.endOffset, 0);
+}, "disconnect() is idempotent.");
+
+test(() => {
+  document.body.innerHTML = '<textarea>Hello</textarea>';
+  const textarea = document.body.firstElementChild;
+  const range = textarea.getValueRange(1, 4);
+
+  range.disconnect();
+  textarea.value = "World!";
+
+  assert_equals(range.startOffset, 0, "disconnected range ignores value change");
+  assert_equals(range.endOffset, 0);
+}, "disconnect() stops live offset updates.");
+
+test(() => {
+  document.body.innerHTML = '<textarea>Hello</textarea>';
+  const textarea = document.body.firstElementChild;
+  const range1 = textarea.getValueRange(0, 3);
+  const range2 = textarea.getValueRange(2, 5);
+
+  range1.disconnect();
+
+  assert_equals(range2.startOffset, 2, "sibling range unaffected by disconnect");
+  assert_equals(range2.endOffset, 5);
+
+  textarea.value = "Modified";
+  assert_equals(range1.startOffset, 0, "disconnected range stays at 0");
+  assert_equals(range2.startOffset, 0, "sibling range still receives updates");
+}, "disconnect() only affects the target range.");
+
+test(() => {
+  document.body.innerHTML = '<textarea>Hello</textarea>';
+  const textarea = document.body.firstElementChild;
+  const range = textarea.getValueRange(1, 4);
+  range.disconnect();
+
+  const newRange = textarea.getValueRange(0, 5);
+  assert_equals(newRange.startOffset, 0);
+  assert_equals(newRange.endOffset, 5);
+  assert_false(newRange.collapsed);
+}, "Element accepts new ranges after a prior range is disconnected.");
+</script>
