Path: blob/main/website/docs/Advanced/WebsocketResource.md
1028 views
WebsocketResource
Websocket Resources are core websocket connections between a client and server.
The WebsocketResource class is returned from window.waitForResource
. It contains all properties of a Resource
in addition to an ability to subscribe to messages sent back and forth.
Properties
request
The Http Upgrade request used to create this Websocket.
Returns ResourceRequest
response
A simulation of an HTTP response pieced together from the socket headers returned during a normal HTTP upgrade.
Returns ResourceResponse
url
The Http Upgrade url.
Returns string
type
The type of resource.
Returns ResourceType=WebSocket
isRedirect
Was this request redirected
Returns boolean
data
Invalid call. Throws an Error. To subscribe to messages, see on('message', callback)
Returns Promise<Buffer>
Methods
on('message', callback: WebsocketMessage
=> any) {#on}
Called on each websocket message returned.
WebsocketMessage
contain: {#websocket-message}
message
string | Buffer
- the contents of the messagesource
server | client
- where the message originated
Returns Promise<void>
off('message', callback: WebsocketMessage
=> any) {#off}
Unsubscribe to messages.
Returns Promise<void>
once('message', callback: WebsocketMessage
=> any) {#once}
Subscribe to a single websocket message
Returns Promise<void>
addEventListener('message', callback: WebsocketMessage
=> any) {#add-event-listener}
Alias for on('message', callback')
Returns Promise<void>
removeEventListener('message', callback: WebsocketMessage
=> any) {#remove-event-listener}
Alias for off('message', callback')
Returns Promise<void>
text() {#text}
Invalid call. Throws an Error. To subscribe to messages, see on('message', callback)
Returns Promise<string>
json() {#json}
Invalid call. Throws an Error. To subscribe to messages, see on('message', callback)