Websocket packets
This library is used to create/validate the websocket packets used by AdonisJs.
If you are writing a Javascript client, this is the library you must use. When writing client libraries for other platforms, simply follow the docs and the code to create your implementations.

Installation
Node/Webpack
npm i --save @adonisjs/websocket-packet
const wsp = require('@adonisjs/websocket-packet')
import wsp from '@adonisjs/websocket-packet'
console.log(wsp.codes)
wsp.isJoinPacket(packet)
CDN
<script src="https://unpkg.com/@adonisjs/websocket-packet"></script>
<script type="text/javascript">
console.log(adonis.wsp.codes)
console.log(adonis.wsp.isJoinPacket(packet))
</script>
Constants
- codes :
Object
Packet codes. The actual packet will have the numbers
- fns
Fns to be exported
Functions
- isJoinPacket(packet) ⇒
Boolean
Validates if packet code is a JOIN
code.
- isLeavePacket(packet) ⇒
Boolean
Validates if packet code is a LEAVE
code.
- isOpenPacket(packet) ⇒
Boolean
Validates if packet code is a OPEN
code.
- isJoinAckPacket(packet) ⇒
Boolean
Validates if packet code is a JOIN_ACK
code.
- isJoinErrorPacket(packet) ⇒
Boolean
Validates if packet code is a JOIN_ERROR
code.
- isLeaveAckPacket(packet) ⇒
Boolean
Validates if packet code is a LEAVE_ACK
code.
- isLeaveErrorPacket(packet) ⇒
Boolean
Validates if packet code is a LEAVE_ERROR
code.
- isEventPacket(packet) ⇒
Boolean
Validates if packet code is a EVENT
code.
- isPingPacket(packet) ⇒
Boolean
Validates if packet code is a PING
code.
- isPongPacket(packet) ⇒
Boolean
Validates if packet code is a PONG
code.
- hasTopic(packet) ⇒
Boolean
Finding if a packet has a topic.
- isValidJoinPacket() ⇒
Boolean
Makes sure packet is a valid join packet. Do call isJoinPacket
before calling this method.
- isValidLeavePacket() ⇒
Boolean
Makes sure packet is a valid leave packet. Do call isLeavePacket
before calling this method.
- isValidEventPacket() ⇒
Boolean
Makes sure packet is a valid event packet. Do call isEventPacket
before calling this method.
- joinPacket(topic) ⇒
Object
Makes a join packet
- leavePacket(topic) ⇒
Object
Makes a leave packet
- joinAckPacket(topic) ⇒
Object
Makes join acknowledge packet
- joinErrorPacket(topic, message) ⇒
Object
Makes join error packet
- leaveAckPacket(topic) ⇒
Object
Makes leave packet
- leaveErrorPacket(topic, message) ⇒
Object
Makes leave error packet
- eventPacket(topic, event, data) ⇒
Object
Makes the event packet
- pingPacket() ⇒
Object
Makes ping packet
- pongPacket() ⇒
Object
Makes pong packet
codes : Object
Packet codes. The actual packet will have the numbers
Kind: global constant
Example
{
OPEN: 0,
JOIN: 1,
LEAVE: 2,
JOIN_ACK: 3,
JOIN_ERROR: 4,
LEAVE_ACK: 5,
LEAVE_ERROR: 6,
EVENT: 7,
PING: 8,
PONG: 9
}
fns
Fns to be exported
Kind: global constant
isJoinPacket(packet) ⇒ Boolean
Validates if packet code is a JOIN
code.
Kind: global function
isLeavePacket(packet) ⇒ Boolean
Validates if packet code is a LEAVE
code.
Kind: global function
isOpenPacket(packet) ⇒ Boolean
Validates if packet code is a OPEN
code.
Kind: global function
isJoinAckPacket(packet) ⇒ Boolean
Validates if packet code is a JOIN_ACK
code.
Kind: global function
isJoinErrorPacket(packet) ⇒ Boolean
Validates if packet code is a JOIN_ERROR
code.
Kind: global function
isLeaveAckPacket(packet) ⇒ Boolean
Validates if packet code is a LEAVE_ACK
code.
Kind: global function
isLeaveErrorPacket(packet) ⇒ Boolean
Validates if packet code is a LEAVE_ERROR
code.
Kind: global function
isEventPacket(packet) ⇒ Boolean
Validates if packet code is a EVENT
code.
Kind: global function
isPingPacket(packet) ⇒ Boolean
Validates if packet code is a PING
code.
Kind: global function
isPongPacket(packet) ⇒ Boolean
Validates if packet code is a PONG
code.
Kind: global function
hasTopic(packet) ⇒ Boolean
Finding if a packet has a topic.
Kind: global function
isValidJoinPacket() ⇒ Boolean
Makes sure packet is a valid join packet. Do call isJoinPacket
before calling this method.
Kind: global function
isValidLeavePacket() ⇒ Boolean
Makes sure packet is a valid leave packet. Do call isLeavePacket
before calling this method.
Kind: global function
isValidEventPacket() ⇒ Boolean
Makes sure packet is a valid event packet. Do call isEventPacket
before calling this method.
Kind: global function
joinPacket(topic) ⇒ Object
Makes a join packet
Kind: global function
Throws:
Error
If topic is not defined or not a string
leavePacket(topic) ⇒ Object
Makes a leave packet
Kind: global function
Throws:
Error
If topic is not defined or not a string
joinAckPacket(topic) ⇒ Object
Makes join acknowledge packet
Kind: global function
Throws:
Error
If topic is not defined or is not a string
joinErrorPacket(topic, message) ⇒ Object
Makes join error packet
Kind: global function
Throws:
Error
If topic is not defined or not a stringError
If message is not defined or not a string
Param | Type |
---|
topic | String |
message | String |
leaveAckPacket(topic) ⇒ Object
Makes leave packet
Kind: global function
Throws:
Error
If topic is not defined or not a string
leaveErrorPacket(topic, message) ⇒ Object
Makes leave error packet
Kind: global function
Throws:
Error
If topic is not defined or not a stringError
If message is not defined or not a string
Param | Type |
---|
topic | String |
message | String |
eventPacket(topic, event, data) ⇒ Object
Makes the event packet
Kind: global function
Throws:
Error
If topic is not defined or not a stringError
If event is not definedError
If data is not defined
Param | Type |
---|
topic | String |
event | String |
data | Mixed |
pingPacket() ⇒ Object
Makes ping packet
Kind: global function
pongPacket() ⇒ Object
Makes pong packet
Kind: global function