Digite para filtrar os verbetes do Glossário.

    Desenvolvimento web · Vibe Coding: Do Zero ao MVP

    O que é oneOf?

    O oneOf combina schemas e aceita um valor quando exatamente uma alternativa é válida. A validação falha quando nenhuma ou várias alternativas correspondem.

    Também chamado de: JSON Schema oneOf

    StayCloudVPS Agêntica

    O mesmo ambiente do SetupVibe, agora numa VPS

    Os atalhos, o shell e as CLIs de IA que você já usa no computador rodam numa VPS da StayCloud com servidor no Brasil.

    Criar minha VPS na StayCloud

    Link de parceiro da Promovaweb.

    Black Friday até 30/11

    30%off

    nos 2 primeiros meses do plano mensal da VPS

    • Backup diário grátis para sempre
    • Servidores em São Paulo no datacenter da Ascenty
    • Datacenter Tier III manutenção sem parada
    • Acesso root com disco SSD NVMe
    • Réplica do backup em Ashburn, nos EUA

    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

    Aplicaçã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
    Capa da Formação Vibe Coding do Zero ao MVP

    Fontes consultadas

    Referências deste verbete

    Este verbete ajudou você?

    Planos Promovaweb

    Tire seus projetos do papel

    O Plano Martech cobre automação e atendimento. O Plano IA Makers acrescenta desenvolvimento com IA, enquanto o Plano Founders trata de gestão de negócios. Todos são anuais.

    Plano Martech

    Para conectar automação, marketing e atendimento com infraestrutura própria.

    R$ 897

    R$ 597/ano

    • Grade de automação, atendimento, marketing e análise de indicadores
    • Instalador Exclusivo Promovaweb
    • n8n, Evolution API, Chatwoot e Mautic
    • Trilha DevOps incluída
    • Encontros ao vivo (terça e quinta)
    • Comunidade e acompanhamento
    Conhecer o plano

    Plano Founders

    Plano anual para fazer um projeto de tecnologia avançar, com 90 dias de mentoria intensiva. R$ 1.997 à vista ou até 10x de R$ 219 no cartão.

    R$ 1.997/ano

    • 12 meses de acesso ao Founders
    • 90 dias de mentoria intensiva, um encontro por dia útil
    • Dia de conteúdo (terça e quinta) e War Room (segunda, quarta e sexta)
    • Encontro semanal em grupo após a fase intensiva
    • Formação Vibe Coding incluída no plano anual
    • Consultoria individual de até duas horas (bônus)
    Conhecer o plano