WebSocket()

Baseline Widely available *

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

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

WebSocket() 생성자는 새로운 WebSocket 객체를 반환합니다.

구문

js
new WebSocket(url);
new WebSocket(url, protocols);

매개변수

url

연결할 URL입니다. WebSocket 서버가 응답할 URL이어야 합니다.

protocols Optional

하나의 프로토콜 문자열, 또는 프로토콜 문자열로 구성된 배열입니다. 하나의 서버가 다수의 WebSocket 하위 프로토콜을 구현할 수 있도록, 사용할 하위 프로토콜을 가리키기 위한 값입니다. (예를 들어, 지정한 protocol에 따라 하나의 서버로 서로 다른 유형의 상호작용을 처리하길 바랄 때 사용할 수 있습니다)

생략할 때의 기본 값은 빈 배열, 즉 [] 입니다.

예외

SyntaxError DOMException

아래의 경우 발생합니다.

  • url을 파싱할 수 없음
  • url의 스킴이 ws와 wss 중 하나가 아님
  • url에 프래그먼트가 있음
  • protocols 배열의 값들이 고유하지 않거나, WebSocket Protocol 명세가 정의한 Sec-WebSocket-Protocol의 필드 값을 구성하는 요소들의 요구사항에 맞지 않음

명세

Specification
WebSockets
# ref-for-dom-websocket-websocket①

브라우저 호환성

같이 보기