GraphQL 포매터
이 GraphQL 포매터로 GraphQL 쿼리, 뮤테이션, 프래그먼트, 스키마의 서식을 지정하세요. 문서를 붙여넣으면 GraphQL 파서로 파싱한 뒤 표준 형식으로 출력합니다. 공백 두 칸 들여쓰기, 줄마다 필드 하나, 필드 사이의 쉼표 제거, 인수와 변수의 간격을 일관되게 적용합니다. 구문 오류를 보고하므로 API 개발자는 문서화, 검토, 디버깅에 활용할 읽기 쉬운 작업과 SDL을 얻을 수 있습니다.
자주 묻는 질문
GraphQL 포매터는 어떻게 작동하나요?
문서를 GraphQL 구문 트리로 파싱한 뒤 표준 형식으로 출력합니다. 문서를 파싱하기 때문에 잘못된 GraphQL은 잘못된 형식으로 바뀌는 대신 거부됩니다.
무엇을 형식화할 수 있나요?
쿼리, 뮤테이션, 구독, 프래그먼트와 SDL의 스키마 정의(예: type, input, enum, interface, union, schema 블록)를 형식화할 수 있습니다. 하나의 문서에 여러 정의를 함께 넣을 수 있습니다.
출력 결과는 어떤 모양인가요?
각 선택 집합은 두 칸 들여쓰기하고 필드는 한 줄에 하나씩 배치하며, 필드 사이의 쉼표는 제거합니다. 인수와 변수 정의에서는 콜론 뒤에 공백을 넣습니다. 예: user(id: $id).
구문 오류가 있으면 어떻게 되나요?
도구가 중단되고 Syntax Error: Expected Name, found }와 같은 파서 메시지를 표시합니다. 보고된 위치를 수정한 뒤 다시 형식화하세요.
주석이 보존되나요?
포매터는 파서가 연결할 수 있는 위치(예: 닫는 중괄호 뒤)에 해시 주석(#)을 유지합니다. 스키마 타입과 필드의 따옴표로 묶인 설명은 문서의 일부이므로 항상 보존됩니다.
스키마에 맞춰 쿼리를 검증하나요?
아니요. 구문만 확인합니다. 필드와 인수가 존재하는지는 서버의 스키마에 따라 결정되므로, 검증하려면 GraphQL 클라이언트나 서버를 사용하세요.
JavaScript에서 복사한 쿼리 문자열을 형식화할 수 있나요?
앞뒤의 따옴표, 백틱 또는 gql 태그를 제외하고 GraphQL 문서만 붙여넣으세요. JSON 페이로드의 이스케이프 문자는 먼저 이스케이프를 해제해야 합니다.
들여쓰기를 바꿀 수 있나요?
아니요. 포매터는 항상 두 칸 들여쓰기를 사용하며 옵션은 없습니다. 이는 대부분의 GraphQL 도구와 문서에서 사용하는 형식과 일치합니다.
결과가 graphql 코드 펜스로 둘러싸이는 이유는 무엇인가요?
출력은 graphql로 표시된 Markdown 코드 블록으로 반환되므로 Markdown에서 구문 강조가 적용됩니다. .graphql 파일에 사용할 때는 펜스 사이의 줄을 복사하세요.
문서는 얼마나 클 수 있나요?
한 번 실행할 때 최대 5 MB까지 가능합니다. 더 큰 입력은 메시지와 함께 거부됩니다. 출력은 Code Formatter의 GraphQL 옵션과 동일합니다.