Ajuda e Resolução de Problemas

Soluções para os problemas mais comuns

Checklist de Diagnóstico Rápido
Force o recarregamento da página (Ctrl+F5 ou Ctrl+Shift+R)
Verifique a versão do app no rodapé
Limpe o cache do Service Worker: DevTools > Application > Service Workers > Unregister
Teste em uma aba anônima/privada para descartar extensões
Verifique o console do navegador (F12) por erros em vermelho

Problemas de Importação

4
Arquivo JSON rejeitado/inválido

Verifique a estrutura do schema: IDs obrigatórios, mínimo 2 alternativas por questão, mínimo 1 resposta correta.

documentação completa

Importação bloqueada por limite de armazenamento

Exporte ou exclua simulados antigos para liberar espaço. O indicador circular mostra o percentual de uso.

documentação completa

Nada acontece ao arrastar arquivo

Verifique se o arquivo tem extensão .json e tamanho menor que 2 MB. Arquivos maiores são rejeitados silenciosamente.

documentação completa

Conflito de nome ao importar

O arquivo tem o mesmo nome de um simulado existente, mas conteúdo diferente. Renomeie o arquivo ou exclua o existente na biblioteca.

documentação completa

Problemas de Simulado/Quiz

5
Timer zerou antes do esperado

O Modo Exame calcula questões × 120 segundos por padrão. Se o JSON tiver tempoLimiteMinutos, esse valor sobrescreve o cálculo.

documentação completa

Não consigo alterar resposta no Modo Exame

A partir da v1.5.0, respostas podem ser alteradas livremente enquanto houver tempo. Force refresh (Ctrl+Shift+R) se o problema persistir.

documentação completa

Mapa de questões não aparece

O mapa de navegação está disponível apenas no Modo Exame. No Modo Estudo, a navegação é sequencial com feedback imediato.

documentação completa

Questões marcadas com flag não aparecem na revisão

Flags no Modo Exame aparecem na tela de revisão pré-finalização. No Modo Estudo, flags são apenas para referência visual.

documentação completa

Resultado mostra nota incorreta

Verifique se o JSON tem respostasCorretas com IDs que existem em alternativas. IDs inválidos são rejeitados na importação.

documentação completa

Problemas de Interface e Dados

4
App ficou em branco / tela cinza

Force recarregamento (Ctrl+F5). Se persistir, limpe o cache do Service Worker: DevTools > Application > Service Workers > Unregister.

documentação completa

Tema escuro não persiste

O tema é salvo no localStorage. No modo anônimo/privado, os dados são limpos ao fechar o navegador.

documentação completa

Simulado sumiu da biblioteca

Verifique se não foi excluído acidentalmente em seleção em massa. O app não possui lixeira a exclusão é permanente.

documentação completa

Não consigo retomar simulado

A retomada funciona apenas no Modo Estudo. Exames não possuem retomada por design são contínuos.

documentação completa

Problemas de Performance e Offline

3
App lento com muitos simulados

A biblioteca carrega todos os metadados de uma vez. Se tiver mais de 100 simulados grandes, exporte e arquive localmente.

documentação completa

Funciona offline no desktop, mas não no mobile

A primeira visita precisa ser concluída com internet para o Service Worker instalar.

documentação completa

Ícones não aparecem no modo offline

Pode indicar cache do Service Worker incompleto. Limpe o cache e recarregue.

documentação completa

Segurança

2
Conteúdo do simulado aparece como texto puro

Isso é intencional. Tags HTML em enunciados e alternativas são sanitizadas para prevenir XSS. Use apenas quebras de linha no JSON.

documentação completa

Navegador bloqueia recursos ao abrir o app

Verifique se sua rede não bloqueia Content Security Policy. Desative extensões de bloqueio se necessário.

documentação completa