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/rm20460.docent.yaml src/hg/utils/docent/tests/regress/rm20460.docent.yaml
new file mode 100644
index 00000000000..b5878f63862
--- /dev/null
+++ src/hg/utils/docent/tests/regress/rm20460.docent.yaml
@@ -0,0 +1,43 @@
+# #20460 -- a reader could not change the color of a native track.  The answer is a color
+# override on the track's settings page: a checkbox, a text field holding a hex value, and
+# a spectrum picker beside it.
+#
+# 6d78a8e2d72 is the part this asserts.  The first version offered the control on every
+# track, including types that do not draw items in a single color at all, so it was
+# restricted to the types that support it -- bed, bigBed, genePred, bigGenePred, wig,
+# bigWig, rmsk, interact, bigInteract, bigLolly, vcf and vcfTabix -- behind one function,
+# tdbSupportsColorOverride(), rather than the same list written out twice.
+#
+# So the test is two pages: a genePred track has the control, and a chain track does not.
+# One page alone would not say the restriction is there, and the restriction is what the
+# commit changed.  refGene and chainHs1 are both on hg38 and neither is a composite, so
+# nothing but the type differs between them.
+#
+# The control is behind showColorPicker in hg.conf, which is on for hgwdev and genome-test.
+# A server with it off would fail this script for a reason that is not a bug; the nightly
+# runs against genome-test.  The `noText:` on the chain page is there because a settings
+# page for a track that does not exist would also have no color control.
+proof:
+  - "assertion-only 2026-09-12 -- written from the ticket and from 6d78a8e2d72, 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:
+      has:
+        - 'input[type=checkbox][name="refGene.colorOverrideOn"]'
+        - 'input[type=text][name="refGene.colorOverride"]'
+      text: "UCSC annotations of RefSeq RNAs"
+
+  # A chain track is not one of the types the override supports.
+  - goto: "/cgi-bin/hgTrackUi?db=hg38&g=chainHs1"
+  - expect:
+      noHas:
+        - 'input[name="chainHs1.colorOverrideOn"]'
+        - 'input[name="chainHs1.colorOverride"]'
+      text: "Chain"
+      noText: "Can't find"