1Tools
상태idle
전송0
수신0
경과 시간 0:00

메시지 보내기

Ctrl+Enter로 보내기

메시지 로그

아직 메시지가 없습니다. 연결하고 보내면 여기 교환 내용이 보입니다.

인코딩 & 텍스트

WebSocket 테스트 도구

WebSocket은 브라우저와 서버 사이의 지속 연결입니다. 핸드셰이크가 성공하면 추가 요청 없이 양방향으로 메시지가 흐릅니다. 이 페이지는 브라우저 기반 WebSocket 클라이언트입니다. ws:// 또는 wss:// URL을 붙여넣고 연결한 뒤 메시지를 입력하면, 도착 시각과 함께 프레임이 기록되고 다시 보낼 수 있는 히스토리에 남습니다. 설치·계정·중간 서버 없이 전부 브라우저에서 동작합니다.

할 수 있는 일

  • 몇 초 만에 연결, 설치 불필요

    ws:// 또는 wss:// URL을 붙여넣고 연결을 누르세요. 확장 프로그램, Node.js, 계정 생성이 필요 없습니다. 연결은 브라우저에서 서버로 직접 이루어지므로, 앱에서 보는 것과 같은 핸드셰이크와 오류를 확인할 수 있습니다. 프로토콜이 빠지면 필드가 자동으로 채워 줍니다.

  • JSON, 일반 텍스트, 바이너리 전송

    작성기에는 Text 탭, 입력 내용을 보기 좋게 정리하는 JSON 탭, 바이트용 Binary 탭이 있습니다. 보낸 메시지는 타임스탬프와 방향 화살표와 함께 히스토리에 남아, 정확한 페이로드를 복사·재전송하거나 서버가 돌려준 내용과 비교할 수 있습니다.

  • 모든 응답에 타임스탬프, 재생 가능

    수신 메시지는 도착 시각과 함께 로그에 쌓이며 text 또는 binary로 표시됩니다. 필터링하거나 한 항목·전체 세션을 JSON으로 복사할 수 있습니다. 서버가 JSON 오류 객체를 반환해도 원본 페이로드가 그대로 보이므로 콘솔을 뒤질 필요가 없습니다.

  • 원인을 짚어 주는 진단

    핸드셰이크가 실패하면 브라우저의 오류 문구와 쉬운 해석을 보여 줍니다. 404는 경로가 틀린 경우, 200은 WebSocket이 아닌 일반 HTTP 엔드포인트에 맞춘 경우, 차단된 ws://는 mixed content입니다. 페이지가 https인데 URL이 ws://이면 연결 전에 경고가 표시됩니다.

  • 무료·비공개·무상태

    가입도, 페이로드 업로드도, 서버 저장도 없습니다. 메시지는 브라우저와 서버 사이를 오갈 뿐입니다. 로그는 언제든 지울 수 있고, 탭을 닫으면 세션이 끝납니다.

사용 방법

  1. 01

    엔드포인트를 붙여넣고 연결합니다. wss://echo.websocket.org 또는 ws://localhost:8080/ws 같은 URL을 주소란에 입력하세요. 프로토콜을 생략하면 ws://가 붙습니다. 연결을 누르면 상태 줄이 open으로 바뀝니다.

  2. 02

    메시지를 보내고 응답을 확인합니다. 왼쪽 작성기에 입력하세요 — Text는 일반 문자열, JSON은 입력 중 서식이 잡히는 페이로드, Binary는 바이트입니다. 보내기 또는 Ctrl+Enter를 누르면, 보낸 메시지와 받은 응답이 오른쪽 로그에 시각과 방향 화살표와 함께 나타납니다.

  3. 03

    실패 원인을 읽고 고칩니다. 연결이 열리지 않으면 진단 바가 브라우저 오류의 의미와 흔한 원인을 설명합니다. 교환이 정상이면 로그에서 정확한 페이로드를 복사하거나 전체 세션을 JSON으로 복사해 테스트·버그 리포트에 붙여 넣으세요.

WebSocket 테스트에 대하여

  • WebSocket이란, 핸드셰이크는 어떻게 동작하는가

    WebSocket은 일반 HTTP 연결을 지속적인 양방향 채널로 업그레이드하는 프로토콜입니다. 클라이언트가 HTTP Upgrade 요청을 보내고 서버가 101 Switching Protocols로 응답하면, 이후 양쪽은 추가 요청·응답 주기 없이 언제든 메시지를 푸시할 수 있습니다. 서버가 클라이언트 요청에만 응답하는 일반 HTTP와의 차이입니다. WebSocket 자체에는 시간대나 단위가 없고 바이트만 옮기며, 프레임이 JSON·일반 텍스트·프로토콜 버퍼인지는 애플리케이션이 정합니다. URL 스킴도 계약의 일부입니다. ws://는 비암호화, wss://는 TLS로 감싼 동일 프로토콜이며, 핸드셰이크 위에서는 동일하게 동작합니다.

  • 브라우저에서 WebSocket 엔드포인트 테스트하기

    WebSocket 엔드포인트 테스트는 네 가지입니다. 핸드셰이크 성공 여부, 페이로드가 그대로 나가는지, 서버 응답이 돌아오고 올바른지, 문제 시 둘을 구분할 수 있는지. 이 페이지는 한 연결에 대해 네 가지를 모두 다루며, 대부분의 API 작업에 충분합니다. 대안 비용도 알아 두면 좋습니다. Postman도 WebSocket을 지원하지만 데스크톱 설치와 계정 없이는 페이로드 템플릿을 저장하기 어렵습니다. wscat은 훌륭하고 무료이지만 Node.js와 터미널이 필요해, 브라우저 버그 리포트에서 나온 페이로드를 다룰 때는 맞지 않습니다. Chrome DevTools는 항상 있지만 WebSocket 패널은 보기용이라 다시 보낼 히스토리를 유지할 수 없고, 연결 시작 전에 패널을 열어 두어야 합니다. 클라이언트가 아니라 스크래치 서버가 필요하면 이 페이지로는 안 됩니다. 직접 서버를 돌리거나 wss://echo.websocket.org 같은 공개 echo에 이 페이지를 연결하세요.

  • 실패한 핸드셰이크 읽기

    핸드셰이크가 실패하면 브라우저가 오류를 보고하고 연결은 열리지 않습니다. 흔히 보는 문구는 "Error during WebSocket handshake: Unexpected response code: 400"이며, 숫자는 서버가 101 대신 반환한 HTTP 상태입니다. 404는 보통 경로가 틀렸거나 다른 prefix에만 라우트가 등록된 경우입니다. 401·403은 보내지 않은 자격 증명을 서버가 요구하는 경우입니다. 200은 일반 HTTP 엔드포인트를 가리킨 단서입니다. WebSocket 서버는 업그레이드에 101만 답합니다. 301·302는 업그레이드 요청을 리다이렉트하려 한 것이고 브라우저는 따르지 않습니다. 502·503은 보통 서버 앞 프록시·게이트웨이 쪽입니다. 핸드셰이크 도중 연결 리셋은 협상이 끝나기 전에 소켓이 닫힌 경우입니다. 별도로, 페이지가 https인데 URL이 ws://로 시작하면 바이트가 나가기 전에 mixed content로 차단됩니다. wss://를 쓰거나 로컬 개발 시 프론트를 http로 제공하세요.

이 브라우저 클라이언트와 비교

항목1ToolsPostmanwscatChrome DevTools
설치없음 — 페이지만 열기데스크톱 앱Node.js + npmChrome 내장
계정가입 불필요템플릿 저장에 계정 필요없음없음
재생 가능한 히스토리있음 — 타임스탬프 로그에서 재전송설정 후 저장된 요청터미널 스크롤백만보기만 가능; 패널을 먼저 열어야 함
커스텀 헤더불가 — 브라우저 제한가능가능불가 — 브라우저 제한
적합한 용도빠른 브라우저 측 확인과 버그 리포트저장된 컬렉션과 팀 워크플로CLI 스크립트와 CI기존 페이지에서 프레임 관찰

무료·비공개·설치 없음

  • 설치 없음, 계정 없음

    페이지를 열고 연결하세요. 확장 프로그램, Node.js, 가입, API 키 설정이 필요 없습니다.

  • 메시지는 나와 서버 사이에만

    이 사이트에는 페이로드용 백엔드가 없습니다. 프레임은 브라우저에서 입력한 엔드포인트로만 갑니다.

  • 로그는 언제든 지우기

    메시지 히스토리는 페이지에만 있습니다. 지우거나 탭을 닫으면 사라지고 어디에도 보관되지 않습니다.

  • 한계를 솔직히

    브라우저는 커스텀 헤더를 설정하거나 프로토콜 수준 ping을 보낼 수 없습니다. 되는 것과 안 되는 것을 가장하지 않고 알려 줍니다.

FAQ

JSON 포맷터 & 검증기JSON 차이 비교텍스트 차이 비교모든 도구홈으로 돌아가기

피드백

헷갈리는 오류, 빠진 진단, 이 페이지가 더 잘 다뤄야 할 페이로드 형태를 발견했나요? 알려 주세요 — 실제 제보가 다음 FAQ와 UI 개선을 만듭니다.

피드백 보내기