method

WebView.scrollTo

selector: string,
options?: ScrollToOptions
): Promise<void>;

Wait for an element to exist, then scroll it into view.

Uses Element.scrollIntoView({ block, behavior: 'instant' }) — scrolls every scrollable ancestor in the chain, not just the document. scrollY is updated synchronously before the promise resolves. No wheel event fires (this is a programmatic scroll).

await view.scrollTo("#footer");               // center (default)
await view.scrollTo("#hero", { block: "start" });
await view.scrollTo(".item", { block: "nearest" }); // minimal scroll

Referenced types

interface ScrollToOptions

  • block?: 'end' | 'center' | 'start' | 'nearest'

    Vertical alignment. "nearest" scrolls minimally (no-op if already in view); "center" snaps the element's center to the viewport center.

  • timeout?: number

    Maximum time in milliseconds to wait for the element to exist.