GraphQL 스키마 실험실
GraphQL 질의는 구문이 맞아도 스키마의 필수 인자를 누락하거나 변수를 잘못된 위치에 쓰고 fragment를 순환 참조할 수 있습니다. SDL 스키마·질의·변수 객체를 붙여 브라우저에서 검사하고, 정상 질의의 선택 필드 경로와 타입 모양의 가상 응답을 살펴보세요.
주요 기능
- SDL 스키마와 단일 질의의 필드·인자·fragment·변수 규칙 검사
- SDL/질의 구문·계약 검증·JSON 변수 강제 변환 오류와 위치 구분
- 직접 선택·별칭·fragment를 타입이 붙은 필드 경로로 펼치기
- 표준 include/skip 지시어를 변수에 적용해 결정론적 로컬 가상 값 실행
- 진단·그래프·모의 JSON 보고서 저장
사용 방법
- 정상 예제를 불러오거나 SDL 스키마를 입력합니다.
- 질의 하나와 필요한 변수 값을 JSON 객체로 입력합니다.
- 검증을 실행하고 오류 단계와 행·열을 확인합니다.
- 정상 질의라면 선택 경로와 가상 응답을 비교합니다.
- 입력을 수정해 다시 실행하고 필요할 때만 보고서를 저장합니다.
활용 예시
- 클라이언트 질의 연결 전 필수 인자 누락 찾기
- fragment 순환 또는 변수 선언 타입 불일치 진단
- API 클라이언트 개발 중 별칭과 중첩 반환 타입 검토
- 실제 GraphQL 서버 연결 없이 응답 형태 탐색
자주 묻는 질문
GraphQL 서버에 연결하나요?
아니요. SDL·질의·변수는 현재 브라우저 메모리에 남습니다. GraphQL.js가 계약을 검증하고 결정론적 가상 필드 값만 실행하며 실제 URL이나 resolver는 사용하지 않습니다.
어떤 문법을 지원하나요?
질의 작업 하나와 객체·입력·열거형·기본 스칼라 타입, 일반적인 별칭·fragment·변수·표준 include/skip 지시어를 지원합니다. 변경·구독·복수 작업·인터페이스·유니언·사용자 스칼라/지시어·인트로스펙션은 이 제한된 모의 실행 범위 밖입니다.
예제 응답 값이 실제 데이터인가요?
아니요. 문자열·숫자·ID·불리언은 필드 경로에서 재현 가능하게 만든 자리표시 값입니다. 목록마다 가상 항목 하나만 만듭니다. 데이터베이스 값·권한·사용자 resolver 동작은 반영하지 않습니다.
그래프에는 있는데 JSON에는 없는 필드가 있나요?
그래프는 가능한 정적 선택 분기를 보여줍니다. 모의 응답은 변수에 따라 표준 include/skip 지시어를 실행하므로 조건부 필드가 빠질 수 있습니다.
정상 판정이 GraphQL 전체 표준 적합성을 보장하나요?
아니요. 이 제한된 입력에 GraphQL.js 검증 규칙을 적용하지만 서버별 확장·resolver·성능·업무 규칙은 검사하지 않습니다.
개인정보 안내
입력은 브라우저 메모리에서 처리하며 GraphQL 서버·스키마 저장소·resolver에 연결하지 않습니다. 사용자가 저장한 보고서에는 필드명과 진단 내용이 포함됩니다.
댓글과 질문