Function createWebInputPrimitives

packages/web-integration/src/web-page.ts:437–577

(
  page: AbstractWebPage,
)

}

export function createWebInputPrimitives(
  page: AbstractWebPage,
): BrowserInputPrimitives {
  const scheduleVisualUpdate = () => {
    if (page.schedulePendingVisualUpdate) {
      page.schedulePendingVisualUpdate();
      return;
    }

    const pendingRefresh = page.flushPendingVisualUpdate?.();
    void pendingRefresh?.catch(() => undefined);
  };

  return {
    pointer: {
      tap: async ({ x, y }) => {
        await page.mouse.click(x, y, { button: 'left' });
      },
      rightClick: async ({ x, y }) => {
        await page.mouse.click(x, y, { button: 'right' });
      },
      doubleClick: async ({ x, y }) => {
        await page.mouse.click(x, y, { button: 'left', count: 2 });
      },
      hover: async ({ x, y }) => {
        await page.mouse.move(x, y);
      },
      dragAndDrop: async (from, to) => {
        await page.mouse.drag(from, to);
      },
      longPress: async ({ x, y }, opts) => {
        await page.longPress(x, y, opts?.duration);
      },
    },
    keyboard: {
      typeText: async (value, opts) => {
        const element = opts?.target;
        if (element && opts?.replace !== false) {
          await page.clearInput(element as ElementInfo);
          // Frameworks (React/Vue/etc.) often re-render in response to
          // the `input` event fired by clearing. If that re-render lands
          // between clearInput returning and the first typed character,
          // the keypresses can be dropped. Wait for the DOM to settle
          // before starting to type.
          await page.waitForDomQuiet?.({ target: element as ElementInfo });
        } else if (element && opts?.focusOnly) {
          const target = element as ElementInfo;
          await page.mouse.click(target.center[0], target.center[1], {
            button: 'left',
          });
          await page.keyboard.press([{ key: 'End' }]);
        }

        if (opts?.focusOnly) {
          return;
        }

        await page.keyboard.type(value);