SOLUÇÃO DE PROBLEMAS

Erro: "Arquivo não é JSON válido"

Causa provável: O arquivo contém erros de sintaxe ou a extensão não é .json.

Solução:

1. Abra o arquivo no Bloco de Notas ou VS Code.
2. Verifique se começa com { e termina com }.
3. Procure vírgulas sobrando antes de } ou ].
4. Cole o conteúdo no JSONLint para validar a sintaxe.

Erro: "Campo Obrigatório Ausente"

Causa provável: O JSON não possui o campo nomeSimulado ou questoes, ou uma questão está faltando id, tipo, alternativas ou respostasCorretas.

Solução: Baixe o Arquivo de Exemplo e compare campo a campo com o seu.

Erro: "ID de resposta não encontrado nas alternativas"

Causa provável: Um valor em respostasCorretas não corresponde a nenhum id dentro do array alternativas daquela questão. IDs são case-sensitive: "A" e "a" são diferentes.

Solução: Certifique-se de que cada valor em respostasCorretas existe exatamente (mesma capitalização) como id em alternativas.

Conflito de conteúdo em importação em massa

Causa: Você importou múltiplos arquivos e um deles tem o mesmo nome de um simulado já salvo, mas com conteúdo diferente. Em lote, o sistema não substitui automaticamente.

Solução: Importe o arquivo conflitante individualmente (um único arquivo por vez). O sistema irá perguntar se você deseja substituir o simulado existente.

Botão "Confirmar" não habilita

Causa: Em questões de múltipla escolha, você selecionou mais ou menos opções do que o exigido.

Solução: Leia o aviso "(SELECIONE EXATAMENTE X)" exibido abaixo do enunciado. Desmarque alternativas extras se tiver selecionado mais do que o necessário.

Timer do Modo Exame não apareceu

Causa mais comum: O simulado foi iniciado no Modo Estudo, não no Modo Exame. O timer só é exibido no Modo Exame.

Causa secundária: O simulado não tem o campo tempoLimiteMinutos no JSON e o cálculo automático (questões × 2 minutos) produziu um valor muito alto o timer existe, mas você ainda não o viu decrescer de forma perceptível.

Solução: Reinicie o simulado selecionando explicitamente "Modo Exame" nas opções de início. Para definir um tempo personalizado, adicione "tempoLimiteMinutos": 60 ao JSON e reimporte.

Sessão salva não aparece para retomar

Causa: A sessão salva só é oferecida no Modo Estudo. Sessões do Modo Exame não são persistidas. Além disso, se o simulado salvo na sessão tiver sido excluído da biblioteca, a sessão é descartada automaticamente.

Solução: O botão "Retomar" aparece apenas no card do simulado correspondente na biblioteca, não na tela inicial. Acesse a Biblioteca e procure o card com o indicador de sessão salva.

Travou ou Tela Branca

Causa: Erro raro de script, geralmente após atualização de versão com Service Worker em cache.

Solução passo a passo:

1. Pressione Ctrl+Shift+R (Windows/Linux) ou Cmd+Shift+R (Mac) para forçar recarga ignorando o cache.
2. Se persistir, abra as Ferramentas do Desenvolvedor (F12) → aba "Application" → "Service Workers" → clique em "Unregister".
3. Recarregue a página normalmente (F5).

O progresso do simulado em curso será perdido, mas os dados da biblioteca permanecem intactos.

Simulados sumiram

Causa mais comum: Limpeza de cache do navegador, uso de aba anônima, ou troca de navegador/dispositivo.

Prevenção: Sempre exporte simulados importantes pelo botão de download (ícone de seta para baixo) no card da biblioteca. O arquivo .json pode ser reimportado a qualquer momento.

Não consegue salvar novo simulado (armazenamento cheio)

Causa: O uso do localStorage atingiu 85% da quota segura de 4 MB. O indicador circular no topo da tela ficará vermelho.

Solução: Exclua simulados que não usa mais (individualmente ou em massa via modo de seleção). Após liberar espaço, o indicador voltará ao normal e novas importações serão permitidas.

Indicador de armazenamento travado em 0% ou valor incorreto

Causa: O cálculo usa Blob.size para medir cada chave do localStorage. Em navegadores muito antigos que não suportam a API Blob, o fallback pode retornar valores inconsistentes.

Solução: Atualize seu navegador para a versão mais recente. O QuizLab é otimizado para navegadores modernos (Chrome 90+, Firefox 88+, Safari 14+).

Aba Revisão aparece vazia mesmo após errar questões

Causa mais comum: O simulado foi jogado sem estar salvo na biblioteca. O rastreamento de erros funciona exclusivamente para simulados da Biblioteca Local. Simulados abertos diretamente de arquivo sem salvar não registram erros.

Solução: Salve o simulado na biblioteca (pelo modal de opções ou pelo criador) e jogue a partir dela. Ao finalizar, os erros serão registrados automaticamente.

Quiz de revisão não aparece no histórico da biblioteca

Comportamento esperado: O simulado de revisão é temporário por design. Ele não é salvo na biblioteca e, portanto, não aparece no histórico de tentativas. Os resultados são distribuídos de volta para cada simulado de origem individualmente.

Slider de quantidade da revisão resetou sozinho

Comportamento esperado: Ao desmarcar uma fonte de simulado, o total de questões disponíveis diminui. Se a quantidade selecionada no slider for maior que o novo total, ela é ajustada automaticamente para o máximo disponível. Isso é intencional para evitar iniciar uma revisão com mais questões do que existem.

Erros não diminuíram após acertar na revisão

Causa: Para uma questão ser removida do banco de erros, ela precisa ser respondida e confirmada durante o quiz de revisão. Questões puladas (sem resposta confirmada) não são contabilizadas e permanecem no banco.

Solução: Certifique-se de confirmar a resposta em cada questão durante a revisão, mesmo que você não saiba a resposta assim o sistema registra o resultado corretamente.

Ícones aparecem em branco ou como quadrados

Causa: A fonte de ícones (Material Symbols) ainda não terminou de carregar quando a interface foi renderizada. Isso ocorre em conexões lentas ou no primeiro carregamento (antes do Service Worker cachear os assets).

Solução: Aguarde alguns segundos e recarregue a página (F5). Após o primeiro carregamento completo, os ícones serão servidos do cache em todas as visitas seguintes, sem depender da velocidade da conexão.

Interface parece desatualizada após uma atualização do QuizLab

Causa: O Service Worker está servindo arquivos da versão anterior do cache. Isso pode acontecer se o navegador não executou o ciclo de atualização do worker corretamente.

Solução:

1. Pressione Ctrl+Shift+R para forçar recarga sem cache.
2. Se o problema persistir: F12 → Application → Service Workers → "Unregister" → recarregue.
3. Alternativamente: F12 → Network → marque "Disable cache" → recarregue uma vez.

Tema claro/escuro não persiste entre sessões

Causa: A preferência de tema é salva no localStorage. Se o cache foi limpo ou a aba é anônima, a preferência é perdida e o tema padrão (escuro) é usado.

Solução: Selecione o tema desejado pelo botão de sol/lua no cabeçalho. Em sessões normais (não anônimas), a preferência será mantida.