The WebSocket()
constructor returns a new WebSocket
object.
WebSocket()
Syntax
new WebSocket(url) new WebSocket(url, protocols)
Parameters
-
url
-
The URL to which to connect; this should be the URL to which the WebSocket server will respond.
-
protocols
Optional -
Either a single protocol string or an array of protocol strings. These strings are used to indicate sub-protocols, so that a single server can implement multiple WebSocket sub-protocols (for example, you might want one server to be able to handle different types of interactions depending on the specified
protocol
).If it is omitted, an empty array is used by default, i.e.
[]
.
Exceptions
-
SyntaxError
DOMException
-
Thrown if:
Specifications
Specification |
---|
WebSockets Standard # ref-for-dom-websocket-websocket① |
Browser compatibility
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | |
WebSocket |
4
|
12
|
11
7-11
|
10
|
12.1
|
5
|
4.4
|
18
|
14
7-14
|
12.1
|
4.2
|
1.0
|
See also
- RFC 6455 (the WebSocket Protocol specification)
© 2005–2021 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/WebSocket/WebSocket