이 도구로 할 수 있는 일
jq-wasm을 클라이언트에서 필요할 때 로드해 jq 필터를 실행합니다.
단일 JSON은 보기 좋게 표시하고 여러 JSON 값 stream은 배열로 보여줍니다.
raw stdout, 빈 결과, 오류 세부 정보를 보존해 문자열 출력과 문법 오류를 이해하기 쉽게 합니다.
대표 사용 사례
- .[], select, map 같은 jq 표현식을 검증합니다.
- API 응답 샘플에서 필요한 필드를 추출합니다.
- shell이나 CI에 넣기 전에 jq를 실험합니다.
- raw 출력과 구조화 출력을 비교합니다.
입력 예시
Object
{ "name": "Alice" }
filter: .nameIterator
[1,2,3]
filter: .[]
Select
[{"age":20},{"age":30}]
filter: .[] | select(.age > 25)출력 예시
Error
문법 오류는 raw error detail과 함께 표시됩니다.
자주 발생하는 오류와 해결 방법
여러 줄 출력을 하나의 JSON 문서로 봄
parsed output에서 JSON stream이 배열로 표시되는지 확인합니다.
입력 JSON이 잘못됨
먼저 JSON 문법을 고친 뒤 jq를 실행합니다.
필터가 비었거나 미완성
완전한 jq 표현식을 입력하고 raw error detail을 확인합니다.
보안 및 개인정보 참고 사항
공통 개인정보 용어, 로컬 처리 모델, 외부 요청 라벨, DevTools 검증 흐름은 신뢰 센터에서 확인하세요.
- jq는 브라우저에서 필요할 때 로드되어 실행됩니다.
- 입력 JSON은 백엔드로 전송되지 않습니다.
- 공유 전 키, 이메일, 고객 데이터를 샘플에서 제거하세요.
단계별 진행 방식
- JSON과 jq 필터를 입력합니다.
- parsed output과 raw output을 확인합니다.
- 오류를 수정하거나 완성된 필터를 복사합니다.
결과 공유 전 품질 체크리스트
- 단일 값과 다중 값 모두 검증했습니다.
- 빈 출력이 의도한 결과인지 확인했습니다.
- 공유 샘플을 비식별 처리했습니다.
활용 팁
jq 플레이그라운드는 Developer Workbench의 데이터 조회 기반 기능으로 preview에서 사용할 수 있습니다.
자주 묻는 질문
raw와 parsed가 모두 있는 이유는?
jq가 여러 JSON 값을 출력할 수 있어 stdout과 구조화 표시를 함께 확인합니다.
.[] 다중 출력도 되나요?
지원합니다. JSON stream을 배열로 표시합니다.
jq-wasm이 서버 빌드에 영향을 주나요?
아니요. 브라우저 동작 시 동적으로 로드합니다.