Como diagnosticar NUI no FiveM: Failed to fetch, callbacks, foco e console

[Hideki]

NUI conecta a interface CEF ao resource. Quando aparece “Failed to fetch”, investigue o nome do callback, o manifesto e a resposta do servidor antes de alterar a interface inteira.

Antes de começar

• Resource com ui_page e arquivos NUI declarados no manifest.
• Console F8 do cliente e console do servidor disponíveis.
• Uma ação reproduzível que dispara o erro.

Passo a passo

1. Abra o console F8 e registre o primeiro erro, a ação que o gerou e o nome do resource.
2. Compare a URL do fetch com o nome usado em RegisterNUICallback; ambos precisam representar o mesmo callback.
3. Envie JSON válido e defina o cabeçalho apropriado na chamada do navegador.
4. Garanta que toda execução do callback chame cb(...), inclusive nos caminhos de erro.
5. Verifique se SetNuiFocus é ativado e removido nos fluxos corretos para não prender teclado ou mouse.
6. Teste o fluxo com dados vazios, permissão negada e reinicialização do resource.

Erros comuns e cuidados

• Nunca confie em valores enviados pela NUI para entregar dinheiro, itens ou permissões: valide novamente no servidor.
• Não deixe callback sem resposta; a interface aguardará até falhar.
• Evite mensagens de debug e dados sensíveis no navegador em produção.

Checklist final

• Callback e URL têm o mesmo nome.
• Todos os caminhos retornam cb.
• Foco fecha corretamente.
• Validação crítica acontece no servidor.
• Erro reproduzido e resolvido em teste.

Próximo passo: A documentação oficial de NUI callbacks traz exemplos em Lua, JavaScript e C#.

Conteúdo revisado pela FiveMDEV. Faça backup antes de alterar uma cidade em produção.

---

Exemplos práticos

Os dois nomes abaixo devem ser iguais. E o callback Lua sempre responde, inclusive em um caso de erro.

Conteúdo oculto 🔒 Login necessário

🔒 Este é conteúdo está oculto, por favor faça login para visualizar.

Fazer Login Cadastre-se

Conteúdo oculto 🔒 Login necessário

🔒 Este é conteúdo está oculto, por favor faça login para visualizar.

Fazer Login Cadastre-se