Cenários — Guia do usuário | YoBench

Para que serve o módulo «Cenários»

O módulo é um construtor node-graph visual para automações: você conecta blocos em um grafo, o motor os executa em sequência ou em paralelo; para blocos de navegador, o Chromium é controlado via Puppeteer com preview ao vivo dentro do YoBench. Útil para RPA: scraping com interação, auto-registro, fluxos de carga, migrações de dados, cadeias de ações com lógica condicional.

O que você obtém:

• 44 tipos de blocos em 11 categorias.
• Execução paralela — parallelSplit / parallelJoin para bifurcar e reunir.
• Lógica condicional — ifElse, loop, switch.
• Automação do navegador via Puppeteer com perfil anti-detecção (User-Agent, viewport, locale, timezone, geolocation, ruído WebGL/Canvas/WebRTC).
• Preview ao vivo — frames JPEG da aba ativa transmitidos para a janela do YoBench.
• Depuração — passo a passo a partir de qualquer nó (scenarios:debug-start).
• Histórico — scenario_runs (contadores de threads/erros), scenario_executions (log batched por bloco), scenario_template_snapshots (versões do grafo).

Categorias de blocos (44 no total)

• Flow (7) — start, end, badEnd, delay, note, parallelSplit, parallelJoin.
• Logic (3) — ifElse, loop, switch.
• Data (7) — setVariable, logMessage, fileRead, fileWrite, random, textProcess, globalVariable.
• Network (3) — httpRequest, cookieSync, captchaSolve.
• Browser (13) — navigate, click, setValue, getValue, waitFor, screenshot, evaluate, pageData, tabSettings, fileUpload, requestIntercept, dialogHandler, dialogWait.
• Emulation (4) — mouseMove, keyboard, scroll, touchEvent.
• Email (2) — sendMail, receiveMail.
• Code (1) — javascript (JS arbitrário em sandbox).
• Database (1) — sqlQuery.
• FTP (2) — ftpUpload, ftpDownload.
• Proxy (2) — proxyRotate, proxyCheck.
• Project (2) — runSubScenario, setProfile.

Parâmetros do cenário

• Grafo — nós e arestas, serializados como JSON.
• Perfil do navegador — User-Agent, viewport, locale, timezone, geolocation, ruído de fingerprint.
• Concorrência (thread_count) — cópias paralelas.
• Repetições (execution_count) — número de execuções.
• Timeout (run_timeout).

Não há chaves scenarios* nas configurações centrais — parâmetros por cenário (scenarioSettings).

Gatilhos

• Manual — botão Iniciar ou IPC scenarios:start com templateId.
• Depuração — scenarios:debug-start, início a partir de qualquer nó (startNodeId).

Preview ao vivo e depuração

• Preview — scenarios:start-preview conecta-se à aba Chromium escolhida; frames via IPC scenarios:preview-frame em base64 JPEG.
• Depuração passo a passo — execução bloco a bloco com inspeção de variáveis e estado do navegador.

Armazenamento e logs

• scenario_runs — status, hora de início/fim, contadores de threads e erros.
• scenario_executions — log batched de cada chamada com params e resultado JSON.
• scenario_template_snapshots — versões do grafo.

Fluxo de uso

1. Abra o módulo Cenários no menu lateral esquerdo.
2. Crie um cenário, arraste blocos ao canvas e conecte-os.
3. Configure o perfil do navegador (User-Agent, viewport, ...).
4. Execute — acompanhe o fluxo no preview ao vivo.
5. Use Depuração — passo a passo a partir de qualquer nó.
6. Compare execuções no histórico scenario_runs.

Próximos passos

• Cenários podem se aninhar via runSubScenario — subgrafos reutilizáveis.
• Use Web Parser para sites estáticos e Site Audit para SEO/Lighthouse — Scenarios é para casos com interação.
• Para carga — Load Testing.

Ajuda e feedback

Quer triggers cron, webhooks ou marketplace de templates? Escreva para nós pelo formulário de contato.