Exatamente uma correspondência
O oneOf é uma palavra-chave do JSON Schema que aceita uma entrada quando ela atende a exatamente um dos schemas da lista. Cada schema descreve uma alternativa permitida. A combinação falha tanto quando nenhuma alternativa aceita a entrada quanto quando duas ou mais a aceitam.
Num cadastro que admite formatos diferentes, cada alternativa pode descrever as propriedades de um desses formatos. Você precisa verificar se um mesmo cadastro atende a duas alternativas para saber se o oneOf corresponde à validação desejada.
Múltiplos de 3 ou de 5
Este schema aceita números múltiplos de 3 ou de 5, desde que o número não seja múltiplo dos dois:
{ "oneOf": [ { "type": "number", "multipleOf": 3 }, { "type": "number", "multipleOf": 5 } ]}As entradas 9 e 10 são válidas: a primeira atende apenas ao schema dos múltiplos de 3 e a segunda atende apenas ao dos múltiplos de 5. Já 15 é inválido por atender às duas alternativas. O número 2 também é inválido, pois não atende a nenhuma. Com o anyOf, o mesmo conjunto de alternativas aceitaria 15.
Sobreposição entre os schemas
Ao investigar uma falha, você precisa conferir quais alternativas aceitaram a entrada. Testar apenas um número válido pode esconder a sobreposição demonstrada por 15. O oneOf verifica a validade da entrada, sem escolher um formato de saída ou converter seu conteúdo.
Dúvidas frequentes
Perguntas frequentes sobre oneOf
- Qual é a diferença entre oneOf e anyOf?
- O anyOf aceita uma ou mais alternativas válidas. O oneOf exige exatamente uma e recusa a entrada quando há sobreposição.
- O oneOf usa somente a primeira alternativa válida?
- Não. O validador precisa verificar se outra alternativa também aceita a entrada, pois isso faria a combinação falhar.
- Como separar alternativas para objetos diferentes?
- Cada alternativa pode exigir uma propriedade de tipo com um valor específico. Essa propriedade deve ser obrigatória e ter valores distintos nos schemas para separar os formatos.
Para continuar
Recursos relacionados
Documentação
JSON Schema: combinação de schemas
Explica a exclusividade do oneOf e compara seu comportamento com allOf e anyOf.
Abrir recursoSite de referência
DevSide: desenvolvimento colaborativo
Orientação técnica ao vivo para investigar uma validação que recusa entradas aceitas por mais de um schema.
Abrir recursoAplicação na formação
Vibe Coding: Do Zero ao MVP
A validação de entradas exige conferir se os schemas aceitam os formatos previstos, inclusive quando o código foi gerado por agentes.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.