socket.c

#####致力于简单化socket连接，内置封装基础心跳包，重连等程序。开发人员只关心自己业务逻辑进行开发

快速使用

浏览器

    <script  scr="./dist/socket.c.min.js" />
    <script>
        var ws = SocketC.createConnection("ws://127.0.0.1:9999")
    </script>

webpack

命令行安装

    npm i SocketC

在文件中

    import { createConnection } from 'socket.c'

    const ws = createConnection("ws://127.0.0.1:9999")

API

createConnection(config) 创建一个webSocket连接, 并返回一个socket实例。 config参数具有以下属性

	{
		url: '', // url
		heartBeat: ['PING', 'PENG'], //心跳包字段
		heartMaxNumber: 3, //心跳包最大离线次数
		hearTinterval: 10000, //心跳包发生间隔
		sendType: 'JSON', //发送的数据格式，用于发送数据前对数据处理
		messageType: 'JSON', //消息数据格式，用于接收数据后对数据的处理
		restartMaxNumber: 3, //最大重连数
		restartTinterval: 3000
	}

closeConnection(socket) 关闭socket的连接
destroyConnection 关闭并销毁socket实例

config 可选参数

字段	类型	作用	默认值
url	string	websocket连接地址	''
heartBeat	Array	`['PING', 'PENG']` 心跳包交互字段，heartBeat[0]客户端发送字段，heartBeat[1]服务端回复字段	['PING', 'PENG']
heartMaxNumber	Number	心跳包最大离线次数，当服务端回复连续掉包次数大于此值时候会自动断开socket连接，并进行重新连接	3
hearTinterval	Number	心跳包发送间隔	10000
sendType	string	对发送后端的消息进行处理，可选值有 'STRING','JSON','BUFF'。设为STRING时候会传入数据处理为字符串在提交，设为JSON时候会对发送数据前进行校验是否为JSON，然后再转为JSON字符串进行数据到服务端。设为BUFF时候会对数据发送前进行校验是否为BUFF，然后进行数据提交	JSON
messageType	string	说明后端回复数据的类型，可选值有 'STRING','JSON','BUFF'。设为STRING时候不会进行任何处理,接收数据不为STRING将数据串化。设为JSON会接收数据进行JSON.parse处理，接收数据不为JSON字符串将过滤。设为 BUFF不会对数据进行任何处理	JSON
restartMaxNumber	number	最大重连次数	3
restartTinterval	number	重连机制间隔,单位ms	3000

socket 实例

具有以下方法

send(msg) 向服务端发送数据
subscribe(callback) 订阅服务端消息，当接收到服务端消息后进行订阅发布，回调传入参数为消息实体。返回订阅ID
unSubscribe(id) 取消订阅，id = 订阅ID
close() 手动关闭连接
destroy()

手动销毁实例

###socke t实例的生命钩子

onOpen 当连接socket成功触发的钩子
onMessage 当接收到访问端数据后触发的方法，传入参数为消息实体
onClose 当连接已超过最大重连次数或被手动关闭
onRes 当socket重新连接前触发的钩子,传如参数为实例对象
onDestroy 销毁前触发钩子

ds147000/socket.c

socket.c

快速使用

浏览器

webpack

API

config 可选参数

socket 实例