.parentsUntil()?.parentsUntil([stop] [, filter]) (since jQuery 1.4) returns ancestors of each matched element up to but not including a stop selector, DOM node, or jQuery object (node/jQuery stop since 1.6). Optional filter keeps only matching ancestors in that range. Returns a new jQuery set; does not change the DOM.
$("li.item-a").parentsUntil(".level-1");
$("li.item-2").parentsUntil("ul.level-1", ".yes");
$("button").parentsUntil($("#panel")); // stop at jQuery (1.6+)
// parentsUntil(stop) → ancestors before stop
// parents() → all ancestors
// parent() → one level up
// closest() → nearest match (incl. self)| Need | Use |
|---|---|
| Ancestors until a stop | $el.parentsUntil(stop) |
| Range + filter | $el.parentsUntil(stop, filter) |
| All ancestors | .parents() |
| Direct parent only | .parent() |
| Nearest match (incl. self) | .closest() |
.parentsUntil()Pick a start, choose where to stop climbing, then optionally filter the range.
$("li.item-a")..parentsUntil(stop) with a selector, Element, or jQuery object.filter selector to keep matching ancestors only..append(), .addClass(), …).| Piece | Required? | Role |
|---|---|---|
| Matched set | Yes | Starting element(s) |
stop | No | Selector / Element / jQuery — climb until here (excluded) |
filter | No | Keep only matching ancestors in the range |
| Return value | — | New jQuery set (unique ancestors before stop) |
call $(starts).parentsUntil(stop?, filter?)
result = empty set
for each start in the matched set:
node = start.parentElement
while node is an element:
if stop is set AND node matches stop:
break // do not include stop
if no filter OR node matches filter:
add node to result
node = node.parentElement
return unique ancestors as a new jQuery objectKeep these upward methods side by side.
| Topic | Detail |
|---|---|
| Syntax | .parentsUntil([stop] [, filter]) |
| Since | jQuery 1.4 (Element/jQuery stop: 1.6) |
| Stop included? | No — boundary only |
| No stop / no match | Same as .parents() |
vs .parents() | Full chain vs cut off at stop |
| Sibling cousins | .nextUntil(), .prevUntil() |
| DOM change? | No — query only |
From li.item-a, compare .parentsUntil(".level-1"), .parents(), and .parent().
Short, copy-ready snippets. Open DevTools, or use Try It Yourself for a live editor.
.level-1Official idea: from li.item-a, mark ancestors before the outer list.
$("li.item-a").parentsUntil(".level-1").append(" [until]");li.item-a..level-1 is reached..yesOfficial idea: until ul.level-1, keep only ancestors that have class yes.
$("li.item-2")
.parentsUntil($("ul.level-1"), ".yes")
.append(" [yes]");li.item-2.$("ul.level-1")..yes only..parentsUntil() vs .parents()Same start — cut off at a stop versus the full ancestor chain.
$("#until-demo li.item-a").parentsUntil(".level-1").append(" [until]");
$("#parents-demo li.item-a").parents().append(" [parents]");Pass an Element (or jQuery object) as the first argument instead of a selector string.
var stop = document.getElementById("panel");
$("#panel button").parentsUntil(stop).append(" [path]");Click a link — mark ancestors inside the section, not past it.
$("section").on("click", "a", function (e) {
e.preventDefault();
$("section").find("[data-mark]").remove();
$(this).parentsUntil("section").append(" [path]");
});section.Common surprises when stopping the climb early.
Need the boundary too? Combine with .addBack() patterns or select the stop separately.
If the stop is omitted or never found, you get the same set as .parents().
.parentsUntil(stop, filter) — swap them and you change the stop, not the filter.
Climbing begins at the parent. Need self-or-ancestor? Use .closest().
Selector stop works since 1.4. Passing a DOM node or jQuery object requires jQuery 1.6+.
.parentsUntil() has been part of jQuery since 1.4 (Element/jQuery stop since 1.6). It works in every browser that runs your loaded jQuery version — no separate browser feature flag.
Supported across jQuery 1.x (1.4+), 2.x, and 3.x. Prefer a current jQuery 3.x build. Traversal uses the live DOM tree.
Bottom line: Cut the ancestor chain at a stop. Prefer .parents() for the full climb, .parent() for one hop.
| Approach | Cost | Best for |
|---|---|---|
.parent() | Cheapest upward | Known direct wrapper |
.closest(sel) | Stops at first match | One nearest match / self |
.parentsUntil(stop) | Walk until stop | Path inside a known container |
.parents() | Walks to root | Full ancestor chain |
Prefer .parentsUntil() when you know the outer boundary — fewer nodes than climbing to html.
.parents().One line: .parentsUntil() collects ancestors until a boundary — and leaves that boundary out.
Continue with jQuery utility helpers after the traversing parent chain.
10 people found this page helpful