Function scrollToFragment

core/src/components/router/utils/dom.ts:158–203

(
  fragment: string | undefined,
  shouldContinue: () => boolean = () => true
)

 * navigation supersedes this one. It is checked between async steps.
 */
export const scrollToFragment = async (
  fragment: string | undefined,
  shouldContinue: () => boolean = () => true
): Promise<boolean> => {
  if (fragment == null || fragment === '') {
    return false;
  }

  // URL fragments are percent-encoded but element ids are not; decode for
  // matching per the HTML spec's indicated-element resolution.
  let decoded: string;
  try {
    decoded = decodeURIComponent(fragment);
  } catch {
    decoded = fragment;
  }

  const target = await findFragmentTarget(decoded, shouldContinue);
  if (!target || !shouldContinue()) {
    return false;
  }

  // Best-effort scroll: swallow exceptions if the page tears down mid-animation.
  try {
    const contentHost = findClosestIonContent(target);
    if (contentHost && isIonContent(contentHost)) {
      const content = contentHost as HTMLIonContentElement;
      const scrollEl = await getScrollElement(content);
      // Yield one frame so the newly mounted target's layout is stable
      // before we measure its rect.
      await nextFrame();
      if (!shouldContinue()) return false;
      const targetRect = target.getBoundingClientRect();
      const scrollRect = scrollEl.getBoundingClientRect();
      const top = targetRect.top - scrollRect.top + scrollEl.scrollTop;
      // Preserve scrollLeft so RTL and horizontally-scrolling pages aren't reset.
      await content.scrollToPoint(scrollEl.scrollLeft, top, FRAGMENT_SCROLL_DURATION);
    } else {
      target.scrollIntoView({ behavior: 'smooth' });
    }
    return true;
  } catch (e) {
    printIonError('[ion-router] - Exception in scrollToFragment:', e);
    return false;
  }
};

export const waitUntilNavNode = (): Promise<void> => {
  if (searchNavNode(document.body)) {