Function waitForElement

content/utils.js:65–128

* Wait for a DOM element to appear. * @param {string} selector - CSS selector * @param {number} timeout - Max wait time in ms (default 10000) * @returns {Promise }

(selector, timeout = 10000)

 * @returns {Promise<Element>}
 */
function waitForElement(selector, timeout = 10000) {
  return new Promise((resolve, reject) => {
    throwIfStopped();

    const existing = document.querySelector(selector);
    if (existing) {
      console.log(LOG_PREFIX, `立即找到元素: ${selector}`);
      log(`已找到元素：${selector}`);
      resolve(existing);
      return;
    }

    console.log(LOG_PREFIX, `等待元素: ${selector}（超时 ${timeout}ms）`);
    log(`正在等待选择器：${selector}...`);

    let settled = false;
    let stopTimer = null;
    const cleanup = () => {
      if (settled) return;
      settled = true;
      observer.disconnect();
      clearTimeout(timer);
      clearTimeout(stopTimer);
    };

    const observer = new MutationObserver(() => {
      if (flowStopped) {
        cleanup();
        reject(new Error(STOP_ERROR_MESSAGE));
        return;
      }
      const el = document.querySelector(selector);
      if (el) {
        cleanup();
        console.log(LOG_PREFIX, `等待后找到元素: ${selector}`);
        log(`已找到元素：${selector}`);
        resolve(el);
      }
    });

    observer.observe(document.body || document.documentElement, {
      childList: true,
      subtree: true,
    });

    const timer = setTimeout(() => {
      cleanup();
      const msg = `在 ${location.href} 等待 ${selector} 超时，已超过 ${timeout}ms`;
      console.error(LOG_PREFIX, msg);
      reject(new Error(msg));
    }, timeout);

    const pollStop = () => {
      if (settled) return;
      if (flowStopped) {
        cleanup();
        reject(new Error(STOP_ERROR_MESSAGE));
        return;