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/rm32263.docent.yaml src/hg/utils/docent/tests/regress/rm32263.docent.yaml
new file mode 100644
index 00000000000..b9a4441853c
--- /dev/null
+++ src/hg/utils/docent/tests/regress/rm32263.docent.yaml
@@ -0,0 +1,36 @@
+# #32263 -- a search engine sends a reader straight to a composite CHILD's settings page,
+# and the page said nothing about the container it belongs to, so there was no way up.
+# 276a54d43de adds a line naming the container and a link to its configuration page;
+# d1f0ba05183 reworded it once and it has been reworded again since, so the assertions
+# below name what the page says today rather than what the commit added.
+#
+# refGene ("UCSC RefSeq") is a child of the refSeqComposite container ("NCBI RefSeq"), and
+# the ticket was filed about exactly that pair.
+#
+# The link is followed rather than only asserted, because the bug this guards against is
+# a link that goes nowhere: the href is built by hand from database, chromosome and
+# tdb->parent->track, so a wrong one is easy to write and impossible to see from the child
+# page alone.  hgTrackUi has no track image, so the container page is recognised by its
+# own text.
+proof:
+  - "assertion-only 2026-09-12 -- written from the ticket and from 276a54d43de, 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=refGene"
+  - expect:
+      text: "is part of the track container"
+      has: 'a[href*="hgTrackUi"][href*="g=refSeqComposite"]'
+
+  - click: 'a:has-text("Click here")'
+
+  # The container's own page: its description, and the subtrack list that only a composite
+  # page has.  The child page carries the container's name too, so naming the name would
+  # not say the click went anywhere.
+  - expect:
+      text: "List subtracks"
+      url: "g=refSeqComposite"