31dd19d6395d10ee6632bb2afcf1947f33eff3dd
braney
  Sat Sep 12 16:03:40 2026 -0700
docent: ten regression tests for hgTrackUi, refs #38252

Four scripts here already touched hgTrackUi in passing (rm37389, rm37489,
rm38126, rm38272).  These are about the page itself: the superTrack
configuration page, composite and subtrack configuration, filters, the color
override, the parent link, and two bad-input paths.

rm20460  the color override is offered on a genePred track and not on a
chain track, which is the type restriction 6d78a8e2d72 added
rm32263  a composite child's page names its container, and the link reaches
the container's own configuration page
rm34651  the density-graph options div is densGraphOptions<track> and the
old shared id is gone
rm35906  Clear filters survives a submit: the cart comes back on All, which
is what the button only appeared to do before
rm36484  the filterComposite select has no stray <br> inside it
rm36668  both the rearrangement and density-graph checkboxes on, submitted
together, does not crash hgTracks
rm36917  the superTrack page's Hide all / Show all / Apply to all controls,
and Show all leaving no child hidden
rm37130  under noParentConfig both filters are on the jaspar child page and
neither is on the parent
rm37282  Hide all greys the superTrack's own dropdown, and a child's Hide
does not force the container back to show
rm37743  a dup_1_refGene request with nothing in the cart errAborts with a
message naming it, instead of taking a SIGSEGV

All ten are assertion-only.  make test is 67 of 67 green: the suite went from
57 scripts to 67 for 14 extra seconds, 10m32s in total, because hgTrackUi draws
no image and most of these never leave it.

README.txt gains the four things the batch settled.  No track image means rows:
is unavailable and a positive text: is mandatory, since a crash hands the
browser an empty document where every noText: passes.  Most hgTrackUi bugs ARE
the markup, so naming the id or class the commit changed is the right check
here, unlike on hgTracks.  A cart round trip is the only way to tell a control
that works from one that looks right.  And Docent cannot pick an option from a
select, so a visibility goes in through the URL and a button is clicked wherever
one exists.

Two candidates were rejected: #38192's missing-track message is live but the
ticket is still Reviewing, and #37840's "add db= to links" is not true of every
link on the page today, so a blanket assertion would fail for a reason that is
not a bug.

diff --git src/hg/utils/docent/tests/regress/rm36917.docent.yaml src/hg/utils/docent/tests/regress/rm36917.docent.yaml
new file mode 100644
index 00000000000..1ba96544d74
--- /dev/null
+++ src/hg/utils/docent/tests/regress/rm36917.docent.yaml
@@ -0,0 +1,48 @@
+# #36917 -- a superTrack settings page had a "+" and a "-" button per subtrack, which only
+# turned a track on or off.  Visibility has five values, so the pair could not express what
+# a user wanted, and Max replaced them: a row of visibility buttons per track, and a
+# dropdown with "Apply to all tracks" beside "Hide all tracks" and "Show all tracks".
+#
+# This asserts the controls and then uses one of them, because a page can carry all three
+# buttons and still have none of them wired: "Show all tracks" has to reach every child's
+# own visibility dropdown.  Those dropdowns are the vizSelect selects, and hgTrackUi writes
+# them with class hiddenText when the track is hidden and normalText when it is not
+# (hg/hgTrackUi/hgTrackUi.c), so "no child is left hidden" is a check on the page rather
+# than on the cart -- and it does not need a submit.
+#
+# wgEncodeReg (ENCODE3 Regulation) is a superTrack with ten children, all hidden in a fresh
+# cart, which is the state the buttons are for.
+#
+# rm37282 is the other half of this page: what those same buttons do to the superTrack's
+# own dropdown.
+proof:
+  - "assertion-only 2026-09-12 -- written from the ticket after the fix shipped"
+
+target: genome-test
+db: hg38
+position: chr1:11102837-11267747
+reset: true
+fast: true
+steps:
+  - goto: "/cgi-bin/hgTrackUi?db=hg38&g=wgEncodeReg"
+  - expect:
+      has:
+        - '#superVizHideAllButton'
+        - '#superVizShowAllButton'
+        - '#superVizApplyAllButton'
+        - 'select#superSubViz'
+        - 'div.seg-btn-group[data-trackname="wgEncodeRegTxn"]'
+      text: "Use the buttons below to set their visibility"
+
+  # wgEncodeRegTxn is one of the children that start hidden, so it is the state the
+  # button has to change.  Not every child starts hidden -- this superTrack has one on by
+  # default -- so the before-check names a track rather than the whole set.
+  - expect: {has: 'select#wgEncodeRegTxn.hiddenText'}
+
+  - click: '#superVizShowAllButton'
+  - sleep: 600
+
+  # Afterwards nothing under the container is left hidden, which is what "all" has to mean.
+  - expect:
+      has: 'select#wgEncodeRegTxn.normalText'
+      noHas: 'select.vizSelect.hiddenText'