web_wait_for

Веб-автоматизация · macOS · Windows

Эффект: запись. Статус: условно доступен.

«Условная доступность» означает, что инструмент может зависеть от версии, платформы, разрешений, учётной записи или настроек. Он доступен не во всех установках.

macOS

Назначение

Ждёт (опрашивает, а не спит фиксированное время), пока на странице появится элемент, или завершается по тайм-ауту. Используйте для SPA-страниц, которые гидратируются после загрузки. Предпочитайте `selector` (CSS-селектор, например "input[name=password]"). `condition` также принимает вид "document.querySelector('...')"; любое ДРУГОЕ условие JavaScript выполняет произвольный код на странице (с теми же возможностями, что web_eval): оно требует confirm=true, а без него вы получите предпросмотр, который ничего не выполняет. Отключено, когда LMCP находится в режиме только чтения. Возвращает met:true/false.

Обязательные входные данные

Схема этой платформы не объявляет обязательных входных данных. Необязательные селекторы или требования среды всё же могут применяться.

Разрешения и подтверждение

Схема объявляет явный параметр подтверждения. Проверьте предварительный результат и разрешите реальную операцию согласно контракту платформы.

Используйте на этой платформе только приложения, учетные записи и ресурсы, разрешенные пользователем. Требования к подключению и разрешениям приведены в описании инструмента для конкретной платформы; этот каталог не заявляет о дополнительных областях OAuth или разрешениях OS.

Каноническая техническая схема на английском — macOS

{
  "properties": {
    "condition": {
      "description": "Alternative to selector: \"document.querySelector('...')\" is accepted as-is; any other JS expression runs arbitrary code on the page (same power as web_eval).",
      "type": "string"
    },
    "confirm": {
      "description": "Must be true to run a `condition` that is arbitrary JavaScript. Without it, returns a preview and runs nothing. Not needed for `selector` or the document.querySelector('...') form.",
      "type": "boolean"
    },
    "selector": {
      "description": "CSS selector to wait for (preferred; treated as data, never executed). e.g. .feed",
      "type": "string"
    },
    "session": {
      "description": "Session name (default 'default').",
      "type": "string"
    },
    "timeout_seconds": {
      "description": "Max seconds to wait (default 15).",
      "type": "integer"
    }
  },
  "required": [],
  "type": "object"
}

Пример для документации

Пример документации для web_wait_for. Не выполняйте этот пример. Показанные аргументы относятся к вымышленному набору данных; перед реальным вызовом найдите настоящие идентификаторы и получите разрешение.

{
  "confirm": false,
  "selector": "h1",
  "session": "demo-browser"
}

Windows

Назначение

Ждёт (опрашивает, а не спит фиксированное время), пока появится элемент (или выполнится условие страницы), или завершается по тайм-ауту. ПРЕДПОЧИТАЙТЕ параметр `selector`: CSS-селектор, ожидаемый как данные (например, selector "input[name=password]"). `condition` также принимает документированный вид "document.querySelector('SEL')" для совместимости или любой другой JavaScript для вычисления на странице, что требует confirm=true (без него вы получите предпросмотр, и ничего не выполнится). Возвращает met:true/false.

Обязательные входные данные

Разрешения и подтверждение

Используйте на этой платформе только приложения, учетные записи и ресурсы, разрешенные пользователем. Требования к подключению и разрешениям приведены в описании инструмента для конкретной платформы; этот каталог не заявляет о дополнительных областях OAuth или разрешениях OS.

Каноническая техническая схема на английском — Windows

{
  "properties": {
    "condition": {
      "description": "Alternative to selector: \"document.querySelector('SEL')\" (compat), or any other JavaScript.",
      "type": "string"
    },
    "confirm": {
      "description": "Must be true to run a `condition` that is arbitrary JavaScript. Without it, returns a preview and runs nothing. Not needed for `selector` or the document.querySelector('SEL') form.",
      "type": "boolean"
    },
    "selector": {
      "description": "CSS selector to wait for (preferred; treated as data, never executed). e.g. .feed, input[name=password]",
      "type": "string"
    },
    "session": {
      "description": "Session name (default 'default').",
      "type": "string"
    },
    "timeout_seconds": {
      "description": "Max seconds to wait (default 15).",
      "type": "integer"
    }
  },
  "required": [],
  "type": "object"
}

Пример для документации

{
  "confirm": false,
  "selector": "h1",
  "session": "demo-browser"
}