Pular para o conteúdo

JSON Schema para Zod

Converta um Schema JSON em schemas Zod. Types, propriedades obrigatórias, enums, const, anyOf, oneOf e allOf são mapeados para os construtores Zod, e palavras-chave de validação comuns, como minLength, maximum, pattern, format e minItems, passam a ser verificações Zod. Cada definição passa a ser um schema exportado com um tipo z.infer.

Redefinir

Perguntas frequentes

Quais palavras-chave de validação são convertidas?

minLength e maxLength passam a ser .min() e .max() em strings; pattern passa a ser .regex(); e os formatos email, uri, uuid e date-time passam a ser .email(), .url(), .uuid() e .datetime(). minimum, maximum, exclusiveMinimum, exclusiveMaximum e multipleOf passam a ser verificações de número, e minItems e maxItems passam a ser verificações de array.

Como as definições são ordenadas?

Cada definição é declarada antes dos schemas que a usam. Uma definição que se refere a si mesma, diretamente ou por meio de outras, é referenciada com z.lazy para que o código continue funcionando.

Schemas recursivos passam na verificação de tipos?

Eles funcionam, mas TypeScript não consegue inferir o tipo de um schema que se refere a si mesmo por meio de z.lazy. Adicione uma anotação de tipo explícita a esse schema, conforme a documentação de Zod descreve para tipos recursivos.

Como additionalProperties é tratado?

additionalProperties false adiciona .strict(); um schema adiciona .catchall() com esse schema; true adiciona .passthrough(); e um objeto sem propriedades, mas com um schema additionalProperties, passa a ser z.record(z.string(), ...).

Qual versão de Zod o código tem como alvo?

Os construtores gerados, como z.object, z.union, z.record com um schema de chave e .nullable(), existem em Zod 3 e Zod 4. Zod 4 ainda aceita os métodos de formato de string, como .email(), embora também ofereça z.email() como forma abreviada.

O que acontece com as referências que a ferramenta não consegue resolver?

Referências externas ao documento, como as que apontam para outro arquivo ou para um URL, passam a ser z.unknown() e são listadas em um comentário no início da saída.

Sobre OneClick Pro

OneClick Pro é uma coleção gratuita com mais de 150 ferramentas da Web para o trabalho cotidiano: converter imagens e unidades, formatar e validar código, verificar domínios e SEO, e trabalhar com textos, datas e números. Todas as ferramentas funcionam sem registro ou assinatura, e o que você digita é usado apenas para calcular o resultado e nunca é armazenado. Use o serviço como uma caixa de ferramentas para tarefas pontuais ou salve nos favoritos as ferramentas que você usa todos os dias.