GraphQL 포매터

언제 사용하나요?

한 줄로 작성된 GraphQL query나 mutation을 리뷰와 문서화에 적합한 형태로 정리할 때 사용합니다.

사용 방법

• GraphQL 문서를 입력합니다.
• Prettier GraphQL 파서로 정리합니다.
• 결과를 복사합니다.

입력값 안내

query, mutation, fragment 문법의 GraphQL 문자열을 입력합니다.

계산·변환 기준

Prettier GraphQL 플러그인을 사용해 중첩 필드와 인자를 일관된 줄바꿈으로 출력합니다.

사용 예시

• 쿼리 리뷰 - 긴 GraphQL 요청을 읽기 좋게 만듭니다.
• 배포 전 빠른 점검 - 입력값과 생성 결과를 확인해 개발·운영 작업 전 오류 가능성을 줄입니다.
• 문서·리뷰 보조 - 정리된 결과를 복사해 개발 문서, 이슈, 코드 리뷰 코멘트에 바로 붙여넣습니다.

예시

• query{viewer{id name}} → 여러 줄 query로 정리
• 한 줄로 붙은 query → 필드 계층별 들여쓰기가 적용된 쿼리로 정리

주의사항

• 포맷된 GraphQL은 참고용입니다. 스키마 특화 지시어나 비표준 확장 문법은 정상 포맷이 안 될 수 있습니다.
• 입력 데이터는 브라우저에서만 처리되며 서버로 전송되지 않습니다.

자주 묻는 질문

fragment도 지원하나요?

Prettier GraphQL 파서가 지원하는 문법은 함께 처리됩니다.

붙여넣은 쿼리가 외부로 전송되나요?

아니요. GraphQL 정리는 브라우저 안에서만 처리됩니다.

변수나 별칭도 정리되나요?

쿼리 변수, 별칭, 중첩 필드를 들여쓰기에 맞춰 읽기 좋게 정리합니다.

스키마(SDL)도 정리되나요?

query와 mutation 정리에 초점이 맞춰져 있으며, 타입 정의가 포함된 스키마는 일부 다르게 처리될 수 있습니다.

관련 도구

• GraphQL 변수 병합 도구 - GraphQL query와 variables JSON을 API 요청 body 형태로 병합합니다.
• JSON 포매터 - JSON 문자열을 보기 좋게 들여쓰기하거나 최소화합니다. 유효성 오류도 함께 표시합니다.
• 코드 비교 도구 - 두 코드 또는 텍스트를 줄 단위로 비교해 추가·삭제 내용을 표시합니다.
• UUID 생성기 - 암호학적으로 안전한 UUID v4를 최대 20개까지 한 번에 생성합니다.
• 비밀번호 생성기 - 길이, 문자셋, 개수를 선택해 브라우저에서 안전한 랜덤 비밀번호를 생성합니다.
• JWT 디코더 - JWT의 header와 payload를 디코딩해 JSON과 주요 클레임을 확인합니다.