Web Workers — Cálculos Fora da Thread Principal
Cálculos previdenciários são computacionalmente intensivos (varredura de histórico, apuração de grupos, concomitâncias). Para manter a UI responsiva, todas as calculadoras executam a lógica de domínio em Web Workers separados da thread principal.
Infraestrutura: criarWorkerScope
criarWorkerScope(ctx, opcoesLogger, trabalho) recebe o contexto do worker, a configuração do logger (fixa ou derivada da mensagem) e a função de trabalho. Ela instala os handlers e responde com um envelope tipado: sucesso, erro ou progresso. O retorno do motor está em dados, não na raiz da mensagem.
O caminho usado em prev-tc é:
- a interface monta dados serializáveis e as tabelas necessárias;
- o worker instala as tabelas e reconstrói as entidades;
- o pacote RGPS executa a análise;
- o worker devolve o resultado para a interface.
Trecho representativo de apps/prev-tc/app/composables/workers/calculoTempo.ts:
ts
import type { MensagemWorker } from '@fc/utils/etc/worker/tipos'
import type { DadosInputWeb } from '../tipos'
import { AnaliseBeneficiosRgps } from '@fc/calculos-rgps/analise-beneficios/AnaliseBeneficiosRgps'
import { instalarTabelasCalculo } from '@fc/indices/instalarTabelasCalculo'
import { criarWorkerScope } from '@fc/utils/etc/worker/criarWorkerScope'
import { desserializar } from './desserializar'
// eslint-disable-next-line no-restricted-globals
const ctx = self as DedicatedWorkerGlobalScope
criarWorkerScope(ctx, mensagem => mensagem.loggerOptions, (mensagem: MensagemWorker<DadosInputWeb>) => {
instalarTabelasCalculo(mensagem.dados)
const dadosCalculo = desserializar(mensagem.dados)
return new AnaliseBeneficiosRgps(dadosCalculo).apurarGrupos(true)
})Uma mensagem atravessa uma fronteira de serialização: não envie uma instância de entidade supondo que seus métodos e protótipos estarão disponíveis do outro lado. Use os adaptadores de entrada do domínio.
Estrutura de referência
text
apps/prev-tc/app/composables/
├── workers/
│ ├── calculoTempo.ts
│ ├── calculoRmi.ts
│ └── desserializar.ts
├── useCalculoTempo.ts
└── useCalculoRmi.tsOs composables consumidores coordenam execução, progresso, erro, cancelamento e invalidação do resultado quando as entradas mudam. Reutilize essa infraestrutura em vez de tratar toda mensagem recebida como sucesso.
Iteração de RMI
CalculoRmi.calcular é um gerador síncrono de etapas de descarte. Rodar esse percurso em um Web Worker torna o trabalho independente da thread da interface; não transforma o contrato do motor em gerador assíncrono. Nas APIs, a entrega por job ou streaming também pertence ao consumidor.
Testes
Confira separadamente o motor, o adaptador que reconstrói suas entradas e o consumidor das mensagens. Os testes de worker precisam preparar o ambiente e o suporte de Web Worker usados pela aplicação; apenas selecionar happy-dom não instala essa comunicação.
Use apps/prev-tc/test/nuxt/ e a configuração Vitest da aplicação como referência para exercitar o percurso real. Inclua erro e cancelamento quando alterar a orquestração.