Painel do Chrome DevTools (F12) para depurar páginas da plataforma TOTVS Fluig. Versão 1.0.1.
A extensão evita o trabalho manual de atravessar iframes, decifrar nomes dinâmicos de campos e colar scripts no console. O painel só aparece quando a página tem os objetos globais WCMAPI ou FLUIGC. Fora do Fluig, ela fica inerte.
Tudo roda na aba inspecionada. A extensão não pede permissão de rede, armazenamento nem <all_urls>, e não envia dados para servidores externos.
| Aba | O que faz |
|---|---|
| Processo | Número, código, descrição e versão do processo, situação, solicitante, início e fim, formulário, atividade atual, responsáveis e destinos seguintes. Sem solicitação, indica a aba Formulário. |
| Formulário | Lista campos simples e tabelas pai-filho. Lê, localiza e altera o valor no DOM. No topo, mostra nome, versão, id do formulário, id da ficha e empresa quando a página tem ficha. |
| Widget | Instâncias SuperWidget da página: código, instanceId, slot, classes, bindings, métodos e configurações em texto. Não chama init nem handlers. |
| Consultar Dataset | Consulta somente leitura com DatasetFactory.getDataset (nome, colunas, ordenação e filtros), na sessão de quem está logado. |
| Rede Fluig | Chamadas de dataset e REST capturadas com o DevTools aberto. Filtra por tipo, oculta ruído interno do portal e permite inspecionar cada chamada. |
| Dump JSON | Exporta campos, tabelas, logs do console, contexto da solicitação e chamadas de rede, para colar numa IA. Dados sensíveis podem ser mascarados. |
Processo, Formulário e Widget releem a página quando a URL, o src de um iframe, os widgets ou os nomes dos campos mudam, sem fechar o DevTools.
Alterar um campo aplica o valor no DOM da página (jQuery.val ou o equivalente nativo) e relê o resultado. Isso não grava no Fluig e não depende de dataset customizado.
O localizador abre painéis fechados (.collapse, .tab-pane, <details>), rola até o campo e aplica um destaque temporário.
Nomes de campo são resolvidos nas formas que o Fluig usa:
- nome ou id simples (
codigo) - campo desabilitado com prefixo
_(_codigo) - linha de tabela pai-filho com sufixo
___N(item___1) - modo visualização, em que o valor fica no texto de um
<span>
- Processo 100% Local: Todo o processamento ocorre exclusivamente na aba inspecionada do navegador. A extensão não coleta, transmite nem armazena telemetria, credenciais ou dados em servidores externos.
- Sem Gravação em Produção: Alterações em campos de formulários atuam estritamente no DOM em memória (volátil). A extensão não executa gravação no banco de dados do Fluig. Um recarregamento da página (F5) descarta qualquer alteração.
- Operações Somente Leitura: Consultas de datasets e inspeção de processos utilizam apenas a sessão já autenticada do usuário ativo e operam em modo somente leitura.
- Privilégios Mínimos (Manifest V3): Zero permissões de rede abusivas, armazenamento persistente ou
<all_urls>. - Inerte fora do Fluig: O painel permanece totalmente inativo até que os objetos globais
WCMAPIouFLUIGCsejam detectados.
- Google Chrome 88 ou superior (Manifest V3)
- Uma página Fluig aberta e autenticada na sessão do usuário
- Abra
chrome://extensions. - Ative o Modo do desenvolvedor.
- Clique em Carregar sem compactação.
- Selecione a pasta deste repositório (a que contém
manifest.json). - Abra uma página Fluig, pressione F12 e escolha o painel Fluig devtools.
Se o painel não aparecer, a página ainda não expôs WCMAPI ou FLUIGC. Recarregue a página com o DevTools aberto.
Depois de atualizar os arquivos, clique em Recarregar no cartão da extensão em chrome://extensions.
- Escopo de Rede: A aba Rede Fluig e as chamadas incluídas no dump monitoram exclusivamente as requisições XHR/Fetch realizadas na página com o painel do DevTools aberto.
- Modo Volátil (DOM): Alterações em campos de formulários refletem estritamente no DOM em memória e são descartadas no próximo recarregamento da página (F5). A extensão não possui mecanismos de escrita, gravação ou persistência no backend do Fluig.
- Sessão e Permissões: Consultas de dataset e inspeções respeitam estritamente o escopo de privilégios e a sessão ativa do usuário logado na plataforma.
manifest.json Manifest V3 e página do DevTools
devtools.html Página oculta que carrega devtools.js
devtools.js Detecta o Fluig e cria o painel
panel.html Interface do painel
css/panel.css Tema escuro do painel
js/ Leitura da página, abas e comunicação via eval
icons/ Ícones da extensão
A comunicação com a página usa chrome.devtools.inspectedWindow.eval. A busca no DOM percorre o documento principal e os iframes de mesma origem, inclusive o pageworkflowview.
Fluig devtools é software livre sob a GNU General Public License v3.0 (GPL-3.0). Você pode usar, estudar, modificar e redistribuir o programa, e as versões modificadas precisam permanecer sob a mesma licença. O texto completo está em LICENSE.