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.

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 Standard
# ref-for-dom-websocket-websocket①

브라우저 호환성

BCD tables only load in the browser

같이 보기