Method getElementTimings

packages/sdk/src/session.ts:165–215

()

  // fallow-ignore-next-line complexity
  getElementTimings(): Record<HfId, ElementTimingSnapshot> {
    const script = getGsapScript(this.parsed.document);

    // Extract all addLabel("name", position) calls from the GSAP script (see cache note above).
    let allLabels: ReturnType<typeof extractGsapLabels>;
    if (script && this._gsapLabelCache?.script === script) {
      allLabels = this._gsapLabelCache.labels;
    } else {
      allLabels = script ? extractGsapLabels(script) : [];
      this._gsapLabelCache = script ? { script, labels: allLabels } : null;
    }

    const result: Record<HfId, ElementTimingSnapshot> = {};
    const elements = this.getElements();
    for (const el of elements) {
      const domEl = resolveScoped(this.parsed.document, el.scopedId);
      if (!domEl) continue;

      const startStr = domEl.getAttribute("data-start");
      const endStr = domEl.getAttribute("data-end");
      const durationStr = domEl.getAttribute("data-duration");

      // Same preference as handleSetTiming: prefer data-duration, fall back to end - start.
      const start = startStr !== null ? parseFloat(startStr) : 0;
      const durationAttr = durationStr !== null ? parseFloat(durationStr) : null;
      const endAttr = endStr !== null ? parseFloat(endStr) : null;

      let duration: number;
      if (durationAttr !== null && Number.isFinite(durationAttr)) {
        duration = durationAttr;
      } else if (endAttr !== null && Number.isFinite(endAttr)) {
        duration = endAttr - start;
      } else {
        // No timing info — skip non-timed elements.
        continue;
      }

      const enterAt = Number.isFinite(start) ? start : 0;
      const exitAt = enterAt + (Number.isFinite(duration) ? duration : 0);

      // Labels whose position falls within [enterAt, exitAt] (end-inclusive: a
      // label exactly at exitAt is treated as within the element's window).
      const labels = allLabels
        .filter(({ position }) => position >= enterAt && position <= exitAt)
        .map(({ name }) => name);

      result[el.scopedId] = { enterAt, exitAt, labels };
    }

    return result;
  }

  setElementTiming(
    map: Record<HfId, { start?: number; duration?: number; trackIndex?: number }>,