← 返回首页

WebSocket - Web API | MDN

Toggle sidebar

Theme

OS default
Light
Dark

한국어

Remember language Learn more

WebSocket

Baseline Widely available *

This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2015년 7월.

* Some parts of this feature may have varying levels of support.

WebSocket 객체는 WebSocket 서버 연결의 생성과 관리 및 연결을 통한 데이터 송수신 API를 제공합니다.

WebSocket 객체를 생성하려면 WebSocket() 생성자를 사용하세요.

참고 : 이 기능은 Web Worker에서 사용할 수 있습니다.

EventTarget WebSocket

In this article

생성자

새로운 WebSocket 객체를 생성해 반환합니다.

속성

WebSocket.binaryType

연결에 사용되는 이진 데이터의 유형입니다.

WebSocket.bufferedAmount 읽기 전용

큐에 대기 중인 데이터의 바이트 수입니다.

WebSocket.extensions 읽기 전용

서버에서 선택한 확장입니다.

WebSocket.protocol 읽기 전용

서버에서 선택한 하위 프로토콜입니다.

WebSocket.readyState 읽기 전용

연결의 현재 상태입니다.

WebSocket.url 읽기 전용

WebSocket의 절대 URL입니다.

메서드

WebSocket.close()

연결을 닫습니다.

WebSocket.send()

전송할 데이터를 큐에 등록합니다.

이벤트

addEventListener() 메서드를 사용하거나 WebSocket 인터페이스의 oneventname 속성에 수신기를 할당해서 아래의 이벤트를 수신할 수 있습니다.

WebSocket의 연결이 닫힐 때 발생합니다. onclose 속성으로도 수신할 수 있습니다.

WebSocket의 연결이, 일부 데이터 전송의 실패 등 오류로 인해 닫힐 때 발생합니다. onerror 속성으로도 수신할 수 있습니다.

WebSocket으로 데이터를 수신했을 때 발생합니다. onmessage 속성으로도 수신할 수 있습니다.

open

WebSocket 연결이 열렸을 때 발생합니다. onopen 속성으로도 수신할 수 있습니다.

예제

js
// WebSocket 연결 생성
const socket = new WebSocket("ws://localhost:8080");

// 연결이 열리면
socket.addEventListener("open", function (event) {
  socket.send("Hello Server!");
});

// 메시지 수신
socket.addEventListener("message", function (event) {
  console.log("Message from server ", event.data);
});

명세

Specification

WebSockets
# the-websocket-interface

브라우저 호환성

Enable JavaScript to view this browser compatibility table.

같이 보기

WebSocket을 이용하여 클라이언트 애플리케이션 작성하기

Help improve MDN

Was this page helpful to you?

Yes No

Learn how to contribute

This page was last modified on 2023년 7월 30일 by MDN contributors.

View this page on GitHub • Report a problem with this content

WebSocket
생성자
1. WebSocket()
인스턴스 속성
인스턴스 메서드
1. close()
2. send()
이벤트
상속
1. EventTarget