# Testar e desenvolver

> O modo de teste fora do RPG Desk, o modo de desenvolvimento dentro da mesa e os erros da página.

Página: https://docs.rpgdesk.com/fichas/desenvolvimento/

Três ferramentas ajudam a fazer e consertar uma ficha: o **modo de teste**, para testar sem o RPG Desk; o **modo de desenvolvimento**, para testar dentro da mesa sem reinstalar a cada mudança; e os **erros da página**, para achar o que quebrou.

## O modo de teste

Abra o arquivo da ficha direto no navegador (dois cliques, ou arrastando para uma aba). Sem o RPG Desk em volta, o rpgdesk.js entra no modo de teste:

*Captura de tela:* A ficha no modo de teste: os campos preenchidos e a faixa com o papel Dono da ficha, o registro aberto com duas rolagens e o botão Limpar dados.

- tudo funciona: os campos, as listas, as abas, as contas e as rolagens (sorteadas no navegador);

- os dados ficam guardados no navegador, e voltam ao recarregar a página;

- a faixa no canto tem:

  - **Papel**: **Mestre**, **Dono da ficha** ou **Outro jogador**. Troque para ver o que cada um vê e pode mudar;
  - **Registro**: as rolagens, as mensagens de chat, os avisos, as barras do cartão, os webhooks (de mentira) e os erros. O número laranja conta os erros e as gravações recusadas;
  - **Limpar dados**: começa a ficha do zero.

A faixa fala a língua do navegador. As fichas ao vivo deste site também estão no modo de teste.

> **Nota**
>
> No modo de teste, a escolha de imagem abre os arquivos do computador, e as imagens escolhidas valem até fechar a página.

## O modo de desenvolvimento

Para ver a ficha **dentro da mesa** enquanto você a escreve, sem instalar de novo a cada mudança:

1. Instale o plugin na mesa uma vez.
2. Sirva a pasta da ficha com um servidor local. Por exemplo, com o Node instalado: `npx serve --cors .` (ele mostra o endereço, como `http://localhost:3000`).
3. Em **Configurações da mesa → Plugins**, clique em **Desenvolvimento** no plugin e escreva o endereço do HTML da ficha, como `http://localhost:3000/minha-ficha.html`. Clique em **Salvar**.

*Captura de tela:* A tela Desenvolvimento da Ficha Básica do RPG Desk, com o endereço http\://localhost:5174/index.html para a ficha Personagem e o botão Salvar.

- As fichas desse tipo passam a vir do seu computador, **só no seu navegador**: os outros na mesa continuam com a versão instalada. A ficha mostra “Desenvolvimento:” e o endereço no alto.
- Salvou o arquivo? Recarregue a ficha (feche e abra a aba, ou **Recarregar** se ela parar).
- **Desligar**, na mesma tela, volta à versão instalada.
- Se a página usa `<script type="module">`, o servidor local precisa liberar o CORS (o `--cors` do exemplo).

Terminou? Suba a `version` e instale a versão nova para todos. Veja [Novas versões](https://docs.rpgdesk.com/fichas/versoes/).

## Os erros da página

Dentro da mesa, um erro no JavaScript da ficha não aparece para quem joga, mas a ficha mostra um triângulo com o número de erros no canto. Clique nele:

*Captura de tela:* O painel Erros da página, com um TypeError, e os botões Copiar erros e Limpar.

- **Copiar erros** copia os erros, com a ficha, o plugin e a versão: cole na conversa com a IA ou mande para quem fez o plugin.
- **Limpar** esvazia a lista.

## Quando a ficha não abre

| A mensagem                                                  | O que fazer                                                                                         |
| ----------------------------------------------------------- | --------------------------------------------------------------------------------------------------- |
| **A página não respondeu. Ela carrega o rpgdesk.js?**       | confira as duas linhas do rpgdesk.js no `<head>` e se o script não quebra ao carregar               |
| **A página tentou sair para outro endereço e foi fechada.** | um link, um `<form>` ou um `location = …` tirou a página da ficha. Use abas e `RPGDesk.ui.openLink` |
| **A página parou de responder.**                            | um laço infinito ou uma conta pesada travou a página. **Recarregar** tenta de novo                  |

O [verificador](https://docs.rpgdesk.com/referencia/verificador/), na instalação, já pega a maioria desses problemas antes.