Function waitForElementByText

content/utils.js:137–210

* Wait for an element matching a text pattern among multiple candidates. * @param {string} containerSelector - Selector for candidate elements * @param {RegExp} textPattern - Regex to match against textContent * @param {number} timeout - Max wait time in ms * @returns {Promise }

(containerSelector, textPattern, timeout = 10000)

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

    function search() {
      const candidates = document.querySelectorAll(containerSelector);
      for (const el of candidates) {
        if (textPattern.test(el.textContent)) {
          return el;
        }
      }
      return null;
    }

    const existing = search();
    if (existing) {
      console.log(LOG_PREFIX, `立即按文本找到元素: ${containerSelector} 匹配 ${textPattern}`);
      log(`已按文本找到元素：${textPattern}`);
      resolve(existing);
      return;
    }

    console.log(LOG_PREFIX, `等待文本匹配: ${containerSelector} / ${textPattern}`);
    log(`正在等待包含文本的元素：${textPattern}...`);

    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 = search();
      if (el) {
        cleanup();
        console.log(LOG_PREFIX, `等待后按文本找到元素: ${textPattern}`);
        log(`已按文本找到元素：${textPattern}`);
        resolve(el);
      }
    });

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

    const timer = setTimeout(() => {
      cleanup();
      const msg = `在 ${location.href} 的 ${containerSelector} 中等待文本 "${textPattern}" 超时，已超过 ${timeout}ms`;