Gerador de JSON simulado

O que é um gerador de JSON simulado?#

Dados de teste realistas são o aborrecido gargalo de qualquer protótipo. Quer-se ver como é que uma tabela renderiza com quinhentas linhas, como é que um formulário se comporta com endereços de e-mail estranhos, como é que um gráfico fica quando os números abrangem três ordens de grandeza — e em vez disso passa-se a tarde a escrever {"name":"test","email":"[email protected]"} vezes sem fim, porque os dados reais são privados e não os pode usar.

Um gerador de JSON simulado preenche essa lacuna. Descreve-se a forma do objeto que se precisa — alguns tipos de campo, ou um modelo com marcadores — e ele sintetiza quantas linhas se peçam, todas diferentes, nenhuma de pessoas reais. A saída é um array JSON que se pode largar diretamente num arquivo de fixture, numa base de dados de demonstração, ou num mock de fetch.

Esta página gera de duas formas. O modo Campos predefinidos dá um menu de campos comuns (nome completo, e-mail, telefone, UUID, data, empresa, e mais) que se marca e desmarca; cada linha torna-se um objeto com esses campos. O modo Modelo deixa escrever um esqueleto JSON com marcadores {{faker.path}}, pelo que se controlam os nomes exatos das chaves e o aninhamento. A saída pode ser baixada como JSON ou CSV para o caminho da folha de cálculo, e os dados sensíveis à localidade são suportados para que os nomes fiquem certos para o público a quem se está fazendo a demonstração.

Como usar#

1. Escolha um modo no interruptor da barra de ferramentas:
   • Campos predefinidos (predefinição): aparece uma lista de verificação de tipos de campo à esquerda. Marque os que quer em cada linha — por exemplo Nome completo, E-mail e UUID. Cada campo tem uma chave predefinida fixa (name, email, uuid).
   • Modelo: aparece em vez disso uma área de texto. Escreva um objeto (ou array) JSON cujas folhas de string contenham marcadores como {{person.fullName}} ou {{internet.email}}.
2. Defina a Quantidade — quantas linhas gerar, de 0 até 1000.
3. Escolha um idioma para dar sabor aos nomes, cidades e números de telefone gerados. São oferecidos dez idiomas, de inglês a 中文, 日本語, 한국어, العربية.
4. Clique em Gerar. O painel da direita preenche-se com um array JSON embelezado das linhas sintetizadas.
5. Clique em Baixar JSON ou Baixar CSV por baixo da saída para guardar o resultado como arquivo (CSV é útil para carregar numa folha de cálculo ou alimentar uma base de dados via importação).
6. Use Exemplo para carregar um modelo inicial, ou Limpar para repor.

A biblioteca pesada do gerador só carrega quando se clica em Gerar pela primeira vez, pelo que a página abre instantaneamente. A geração corre inteiramente no seu navegador.

Principais funcionalidades#

• Dois estilos de autoria. Marque campos para um arranque rápido, ou escreva um modelo quando precisa de chaves personalizadas, aninhamento, ou uma mistura de texto literal com valores gerados.
• Catorze campos predefinidos. Nomes, cargos, e-mails, nomes de usuário, telefones, UUIDs, datas recentes, cidades, países, empresas, URLs, parágrafos e nomes de cores — os blocos de construção comuns de um registro de demonstração.
• Valores sensíveis à localidade. Mude de idioma e os dados de pessoa e localização seguem-no — útil quando a demonstração tem de parecer local.
• Marcadores de modelo mantêm os tipos. Um marcador que é o valor inteiro de uma folha de string resolve-se para o seu tipo nativo — pelo que {{date.recent}} se torna uma verdadeira string de data ISO, não um fragmento entre aspas.
• Até 1000 linhas. Suficiente para povoar uma tabela paginada ou uma fixture representativa sem sobrecarregar o separador.
• Exportação JSON e CSV. Gere uma vez, exporte para o consumidor que tiver — uma fixture JSON ou uma importação de folha de cálculo.
• Apenas local. Os dados são sintetizados no seu navegador; nada sobre o seu modelo ou saída sai da página.

Exemplo prático#

Precisa de dez registros de usuário para uma demonstração, cada um com um nome, um e-mail e um id único. Deixe no modo Campos predefinidos, desmarque tudo exceto Nome completo, E-mail e UUID, defina Quantidade como 10, e clique em Gerar. A saída é um array JSON cujas primeiras linhas se parecem com:

[
  {
    "name": "Sara Schultz",
    "email": "[email protected]",
    "uuid": "f3a1c2b4-9d8e-4a7b-bc6e-1f2d3a4b5c6d"
  },
  {
    "name": "Derrick Watsica",
    "email": "[email protected]",
    "uuid": "b7e6d5c4-a3b2-4987-8d6e-5c4b3a2f1e09"
  }
]

Cada linha é diferente, nenhum dos endereços é uma caixa de correio real, e os UUIDs são únicos. Para uma forma personalizada que os campos predefinidos não conseguem exprimir — digamos um registro que mistura um cargo literal com campos gerados — mude para o modo Modelo e escreva:

{
  "id": "{{string.uuid}}",
  "name": "{{person.fullName}}",
  "role": "member",
  "email": "{{internet.email}}"
}

O campo role é texto literal, pelo que todas as linhas dizem "member"; os outros três resolvem-se a valores sintetizados frescos em cada linha. Defina a quantidade para as que precisar e exporte.

FAQ#

Os endereços de e-mail são caixas de correio reais para onde posso enviar?#

Não. Todos os valores são sintetizados — os nomes são combinações plausíveis, e os endereços de e-mail seguem uma forma realista mas não encaminham para ninguém. Esse é o ponto: obtém dados que parecem dados de produção para testar esquema, validação e ordenação, sem tocar na caixa de correio de uma pessoa real.

Posso fazer os dados parecerem locais a um país específico?#

Sim. O seletor de idioma altera a forma como os nomes de pessoas, cidades e números de telefone são gerados. Escolha 中文（简体） e os nomes tornam-se chineses; escolha 日本語 e tornam-se nomes japoneses. Isto importa quando uma demonstração tem de parecer autêntica ao seu público.

No modo modelo, porque é que {{date.recent}} aparece como uma string ISO sem aspas ao redor da lógica de data?#

Quando um marcador é o valor inteiro de uma folha de string, resolve-se para o valor de retorno nativo do gerador em vez de ser interpolado como texto. Uma chamada de data recente devolve um objeto de data real, que depois se serializa como uma string ISO no JSON de saída. Se em vez disso o quiser incorporado em texto envolvente, coloque caracteres literais ao redor — "shipped on {{date.recent}}" — e será transformado em string dentro da frase.

Quantas linhas consegue gerar de uma só vez?#

Até mil. Isso é suficiente para preencher uma tabela paginada, povoar um arquivo de fixture, ou alimentar uma base de dados de testes via importação CSV. Para além disso, gere em lotes ou recorra a um alimentador de base de dados dedicado.

Os dados gerados são reproduzíveis?#

Cada clique em Gerar produz um conjunto aleatório fresco — é o que se quer quando se estão procurando casos extremos numa interface. Os valores não estão fixados a uma semente nesta página, pelo que não trate uma saída específica como algo que possa recriar byte a byte mais tarde; guarde a saída num arquivo de fixture se precisar de reproduzir um conjunto de dados em particular exatamente.