SYNCERのロゴ
アイキャッチ画像

WebSocket.protocol - サーバー側が許可するサブプロトコル

protocolは、WebSocketのプロパティです。ソケット通信しているサーバー側が許可する、下位プロトコルの情報を返すプロパティです。

概要

名前
protocol
所属
WebSocket
IDL
readonly attribute DOMString protocol;
仕様書
https://html.spec.whatwg.org/multipage/web-sockets.html#dom-websocket-protocol

説明

ソケット通信先のサーバーが許可するプロトコルを表す文字列。具体的には、レスポンスヘッダーのSec-WebSocket-Protocolの値を反映します。下位プロトコルは、オブジェクトを作成する時の第2引数で指定できます。許可するプロトコルがない場合、空の文字列が返ります。

Sec-WebSocket-Protocol: syncer, chat
var ws = new WebSocket( "wss://socket.syncer.jp/connect", "chat" ) ;

デモ

WebSocket.protocolのデモです。「接続」のボタンをクリックして通信中に、「取得」をクリックしてみて下さい。ただし、デモのサーバーで許可しているプロトコルがないため、空の文字列が返ります。

<!-- このコードは編集できます。 -->

<!DOCTYPE html>
<html>
<head>
<style>
	div#result { white-space: pre-wrap }
</style>
</head>
<body>
	<p>
		<button id="hoge">接続</button>
		<button id="fuga">切断</button>
		<button id="piyo">取得</button>
	</p>
<hr>
	<div id="result"></div>
<script>
var ws = null ;
var element1 = document.getElementById( "hoge" ) ;
var element2 = document.getElementById( "fuga" ) ;
var element3 = document.getElementById( "piyo" ) ;

// 接続
element1.onclick = function () {
	if ( ws && ws.readyState === 1 ) return false ;

	ws = new WebSocket( "wss://socket.syncer.jp/connect" ) ;

	ws.onopen = function() {
		ws.onmessage = function( message ) {
			logUpdate( message.data ) ;
		}

		ws.onclose = function() {
			logUpdate( "通信を切断しました。" ) ;
		}
	}
}

// 切断
element2.onclick = function () {
	if ( ws && ws.readyState === 1 ) ws.close() ;
}

// 取得
element3.onclick = function () {
	var value = ws.protocol ;
	logUpdate( value, true ) ;
}

var logUpdate = function ( text, noDate ) {
	var resultElement = document.getElementById( "result" ) ;
	resultElement.textContent = text + ( noDate ? "" : "(" + new Date().toLocaleString() + ")" ) + "\n" + resultElement.textContent ;
}
</script>
</body>
</html>

サポート状況

ChromeFirefoxSafariEdgeIEOperaiOS SafariAndroid
15+ 11+ 6.0+ 10+ 15+ 6.0+ 4.4+
  • Twitterでシェア
  • Facebookでシェア
  • Google+でシェア
  • はてなブックマークでシェア
  • pocketに保存
  • LINEでシェア
更新履歴
2017年10月4日 (水)
コンテンツを公開しました。