GraphQL의 OneOf 입력 객체는 여러 대안 중 하나만 선택해야 하는 입력을 스키마에 표현합니다. 예를 들어 사용자를 ID 또는 사용자명으로 찾을 때 둘을 동시에 보내거나 둘 다 빼면 오류입니다. 선택된 필드 값도 null일 수 없습니다.
데모는 id만 지정하면 통과하고 id·username을 함께 보내면 막히는 입력 게이트를 보여줍니다. @oneOf 필드는 nullable 타입으로 정의하되 실제 입력에서는 정확히 하나의 값을 제공해야 합니다.
언제 쓰나
검색·조회 조건처럼 서로 배타적인 입력 대안을 한 인자로 받아야 할 때 씁니다.