marko-virtual: scrollToEnd during an in-flight prepend strands the view one prepend above the bottom (chat-pretext e2e fails on CI)
Describe the bug
In the Marko chat-pretext example (and the e2e test built on it), calling scrollToEnd() while a history prepend is in flight leaves the view stranded exactly one prepend above the bottom, with no scroll event to recover it. The e2e/chat-pretext.spec.ts › Latest returns to the bottom and status flips back to At latest test fails deterministically on CI because of this (see #1260, two consecutive runs), while passing locally where the timing differs.
Root cause
The <virtualizer> tag's onUpdate runs setOptions(...), then _willUpdate(), then notify():
current.setOptions({ ...current.options, ...buildOptions(input, notify) })
current._willUpdate()
notify() // ← sets the reactive `size`; the sizer DOM grows in a later batchOn an end-anchored prepend, setOptions bumps the tracked scrollOffset by the prepended height and _willUpdate writes that offset to scrollTop. At that moment the sizer still has the old height, so the browser clamps the write to the old maximum. The sizer grows afterwards, scrollTop never moves, and the DOM is left prependedHeight short of the end. Core's tracked offset already holds the new value, so isAtEnd() reports true and the example's pinPending re-issue (which exists for exactly this strand, see the comment in examples/marko/chat-pretext/src/routes/+page.marko) disarms without correcting anything.
This is the same ordering problem react-virtual fixed in #1237 by growing the container before _willUpdate syncs the scroll position.
Reproduction (deterministic)
Drop this into packages/marko-virtual/e2e/app/e2e/ and run CI=1 npx playwright test latest-race. Fails 4/4 on main (and on #1260) with distance 870 (12 rows × ~72px):
import { expect, test } from '@playwright/test'
import type { Page } from '@playwright/test'
const dist = (page: Page) =>
page.locator('.messages').evaluate((el) => el.scrollHeight - el.scrollTop - el.clientHeight)
// Same as "Latest returns to the bottom" but clicks Latest right after arming the
// auto history load, so the 180ms prepend lands AFTER the jump — the ordering CI hits.
for (let i = 0; i < 4; i++) {
test(`race ${i}: Latest then late prepend keeps the bottom`, async ({ page }) => {
await page.goto('/chat-pretext')
await expect.poll(() => dist(page), { timeout: 5000 }).toBeLessThanOrEqual(80)
await page.waitForTimeout(400) // autoHistoryEnabled arms after 250ms
await page.locator('.messages').evaluate((el) => { el.scrollTop = 0 })
await page.waitForTimeout(30)
await page.locator('[data-testid="latest"]').click()
await page.waitForTimeout(1500)
expect(await dist(page)).toBeLessThanOrEqual(80)
})
}Expected behavior
scrollToEnd() followed by a late prepend keeps the viewport pinned to the bottom (or, at minimum, the prepend keeps the visible content anchored, which for a bottom-pinned view means staying at the bottom).
Possible fixes
- Marko adapter: write the sizer height to the DOM synchronously before calling
_willUpdate(), mirroring react-virtual'sapplyContainerSizeordering from #1237. - Core: extend the clamp-detect-and-retry introduced in #1260 for compensation writes to the anchor-sync write in
_willUpdate, so every adapter recovers regardless of DOM update ordering.
Until one of those lands, the affected e2e test is marked test.fixme referencing this issue so unrelated PRs can go green.
Platform
Chromium (Playwright), Linux CI runner; reproducible on macOS with the forced-timing spec above.
tanstack-virtual version
@tanstack/[email protected], @tanstack/marko-virtual current main.
Source: TanStack/virtual