Lista de instruções

Uma lista completa de instruções de navegador suportadas com exemplos para o Web Unblocker.

Argumentos gerais

Todas as instruções definidas abaixo compartilham um conjunto consistente de argumentos. Os argumentos são os seguintes.

tipo

  • Tipo: Enum["click", "input", "scroll", "scroll_to_bottom", "wait", "wait_for_element", "fetch_resource"]

  • Descrição: Tipo de instrução do navegador.

timeout_s

  • Tipo: int

  • Descrição: Quanto tempo até que a ação seja ignorada se não for concluída a tempo.

  • Restrições: 0 < timeout_s <= 60

  • Valor padrão: 5

wait_time_s

  • Tipo: int

  • Descrição: Quanto tempo aguardar antes de executar a próxima ação.

  • Restrições: 0 < wait_time_s <= 60

  • Valor padrão: 0

on_error

  • Tipo: Enum["error", "skip"]

  • Descrição: Indicador do que fazer com as instruções caso esta instrução falhe:

    • "error": Interrompe a execução das instruções do navegador.

    • "skip": Continua para a próxima instrução.

  • Valor padrão: "error"

Exemplo com argumentos gerais

Instruções

click

  • Descrição: Clica em um elemento e aguarda uma quantidade definida de segundos.

  • Args:

    • type: str = "click"

    • selector: dict

      • type: Enum["xpath", "css", "text"]

      • value: str

  • Exemplo:

input

  • Descrição: Insere um texto em um elemento selecionado.

  • Args:

    • type: str = "input"

    • selector: dict

      • type: Enum["xpath", "css", "text"]

      • value: str

    • value: str

    • Exemplo:

scroll

  • Descrição: Rola uma quantidade definida de pixels.

  • Args:

    • type: str = "scroll"

    • x: int

    • y: int

  • Exemplo:

scroll_to_bottom

  • Descrição: Rola até o final por uma quantidade definida de segundos.

  • Args:

    • type: str = "scroll_to_bottom"

  • Exemplo:

wait

  • Descrição: Aguarda uma quantidade definida de segundos.

  • Args:

    • type: str = "wait"

  • Exemplo:

wait_for_element

  • Descrição: Aguarda que o elemento carregue por uma quantidade definida de segundos.

  • Args:

    • type: str = "wait_for_element"

    • selector: dict

      • type: Enum["xpath", "css", "text"]

      • value: str

    • Exemplo:

fetch_resource

circle-exclamation
  • Descrição: Busca a primeira ocorrência de um recurso Fetch/XHR que corresponda ao padrão definido.

  • Args:

    • type: str = "fetch_resource"

    • filter: str(Expressão RegEx)

    • on_error: Enum["error", "skip"]

  • Exemplo:

Validação das instruções

Qualquer inconsistência em relação ao formato da instrução resultará em um 400 código de status e uma mensagem de erro correspondente.

Por exemplo, um payload como este:

Resultará em:

Atualizado

Isto foi útil?