mirror of
https://github.com/socketio/socket.io.git
synced 2026-04-30 03:00:39 -04:00
The ping-pong mechanism has been reverted (server now sends a ping and expects a pong from the client), so we cannot compute the latency like we did in previous versions. Release notes: https://github.com/socketio/engine.io-client/releases/tag/4.0.0
580 lines
18 KiB
JavaScript
580 lines
18 KiB
JavaScript
"use strict";
|
|
var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
|
|
if (k2 === undefined) k2 = k;
|
|
Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
|
|
}) : (function(o, m, k, k2) {
|
|
if (k2 === undefined) k2 = k;
|
|
o[k2] = m[k];
|
|
}));
|
|
var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
|
|
Object.defineProperty(o, "default", { enumerable: true, value: v });
|
|
}) : function(o, v) {
|
|
o["default"] = v;
|
|
});
|
|
var __importStar = (this && this.__importStar) || function (mod) {
|
|
if (mod && mod.__esModule) return mod;
|
|
var result = {};
|
|
if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
|
|
__setModuleDefault(result, mod);
|
|
return result;
|
|
};
|
|
var __importDefault = (this && this.__importDefault) || function (mod) {
|
|
return (mod && mod.__esModule) ? mod : { "default": mod };
|
|
};
|
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
exports.Manager = void 0;
|
|
const engine_io_client_1 = __importDefault(require("engine.io-client"));
|
|
const socket_1 = require("./socket");
|
|
const component_emitter_1 = __importDefault(require("component-emitter"));
|
|
const parser = __importStar(require("socket.io-parser"));
|
|
const on_1 = require("./on");
|
|
const component_bind_1 = __importDefault(require("component-bind"));
|
|
const indexof_1 = __importDefault(require("indexof"));
|
|
const backo2_1 = __importDefault(require("backo2"));
|
|
const debug = require("debug")("socket.io-client:manager");
|
|
/**
|
|
* IE6+ hasOwnProperty
|
|
*/
|
|
const has = Object.prototype.hasOwnProperty;
|
|
class Manager extends component_emitter_1.default {
|
|
/**
|
|
* `Manager` constructor.
|
|
*
|
|
* @param {String} engine instance or engine uri/opts
|
|
* @param {Object} options
|
|
* @api public
|
|
*/
|
|
constructor(uri, opts) {
|
|
super();
|
|
this.nsps = {};
|
|
this.subs = [];
|
|
this.connecting = [];
|
|
this.packetBuffer = [];
|
|
if (uri && "object" === typeof uri) {
|
|
opts = uri;
|
|
uri = undefined;
|
|
}
|
|
opts = opts || {};
|
|
opts.path = opts.path || "/socket.io";
|
|
this.opts = opts;
|
|
this.reconnection(opts.reconnection !== false);
|
|
this.reconnectionAttempts(opts.reconnectionAttempts || Infinity);
|
|
this.reconnectionDelay(opts.reconnectionDelay || 1000);
|
|
this.reconnectionDelayMax(opts.reconnectionDelayMax || 5000);
|
|
this.randomizationFactor(opts.randomizationFactor || 0.5);
|
|
this.backoff = new backo2_1.default({
|
|
min: this.reconnectionDelay(),
|
|
max: this.reconnectionDelayMax(),
|
|
jitter: this.randomizationFactor(),
|
|
});
|
|
this.timeout(null == opts.timeout ? 20000 : opts.timeout);
|
|
this.readyState = "closed";
|
|
this.uri = uri;
|
|
this.encoding = false;
|
|
const _parser = opts.parser || parser;
|
|
this.encoder = new _parser.Encoder();
|
|
this.decoder = new _parser.Decoder();
|
|
this.autoConnect = opts.autoConnect !== false;
|
|
if (this.autoConnect)
|
|
this.open();
|
|
}
|
|
/**
|
|
* Propagate given event to sockets and emit on `this`
|
|
*
|
|
* @api private
|
|
*/
|
|
emitAll(event, arg) {
|
|
super.emit(event, arg);
|
|
for (let nsp in this.nsps) {
|
|
if (has.call(this.nsps, nsp)) {
|
|
this.nsps[nsp].emit(event, arg);
|
|
}
|
|
}
|
|
}
|
|
/**
|
|
* Update `socket.id` of all sockets
|
|
*
|
|
* @api private
|
|
*/
|
|
updateSocketIds() {
|
|
for (let nsp in this.nsps) {
|
|
if (has.call(this.nsps, nsp)) {
|
|
this.nsps[nsp].id = this.generateId(nsp);
|
|
}
|
|
}
|
|
}
|
|
/**
|
|
* generate `socket.id` for the given `nsp`
|
|
*
|
|
* @param {String} nsp
|
|
* @return {String}
|
|
* @api private
|
|
*/
|
|
generateId(nsp) {
|
|
return (nsp === "/" ? "" : nsp + "#") + this.engine.id;
|
|
}
|
|
/**
|
|
* Sets the `reconnection` config.
|
|
*
|
|
* @param {Boolean} true/false if it should automatically reconnect
|
|
* @return {Manager} self or value
|
|
* @api public
|
|
*/
|
|
reconnection(v) {
|
|
if (!arguments.length)
|
|
return this._reconnection;
|
|
this._reconnection = !!v;
|
|
return this;
|
|
}
|
|
/**
|
|
* Sets the reconnection attempts config.
|
|
*
|
|
* @param {Number} max reconnection attempts before giving up
|
|
* @return {Manager} self or value
|
|
* @api public
|
|
*/
|
|
reconnectionAttempts(v) {
|
|
if (!arguments.length)
|
|
return this._reconnectionAttempts;
|
|
this._reconnectionAttempts = v;
|
|
return this;
|
|
}
|
|
/**
|
|
* Sets the delay between reconnections.
|
|
*
|
|
* @param {Number} delay
|
|
* @return {Manager} self or value
|
|
* @api public
|
|
*/
|
|
reconnectionDelay(v) {
|
|
if (!arguments.length)
|
|
return this._reconnectionDelay;
|
|
this._reconnectionDelay = v;
|
|
this.backoff && this.backoff.setMin(v);
|
|
return this;
|
|
}
|
|
randomizationFactor(v) {
|
|
if (!arguments.length)
|
|
return this._randomizationFactor;
|
|
this._randomizationFactor = v;
|
|
this.backoff && this.backoff.setJitter(v);
|
|
return this;
|
|
}
|
|
/**
|
|
* Sets the maximum delay between reconnections.
|
|
*
|
|
* @param {Number} delay
|
|
* @return {Manager} self or value
|
|
* @api public
|
|
*/
|
|
reconnectionDelayMax(v) {
|
|
if (!arguments.length)
|
|
return this._reconnectionDelayMax;
|
|
this._reconnectionDelayMax = v;
|
|
this.backoff && this.backoff.setMax(v);
|
|
return this;
|
|
}
|
|
/**
|
|
* Sets the connection timeout. `false` to disable
|
|
*
|
|
* @return {Manager} self or value
|
|
* @api public
|
|
*/
|
|
timeout(v) {
|
|
if (!arguments.length)
|
|
return this._timeout;
|
|
this._timeout = v;
|
|
return this;
|
|
}
|
|
/**
|
|
* Starts trying to reconnect if reconnection is enabled and we have not
|
|
* started reconnecting yet
|
|
*
|
|
* @api private
|
|
*/
|
|
maybeReconnectOnOpen() {
|
|
// Only try to reconnect if it's the first time we're connecting
|
|
if (!this.reconnecting &&
|
|
this._reconnection &&
|
|
this.backoff.attempts === 0) {
|
|
// keeps reconnection from firing twice for the same reconnection loop
|
|
this.reconnect();
|
|
}
|
|
}
|
|
/**
|
|
* Sets the current transport `socket`.
|
|
*
|
|
* @param {Function} optional, callback
|
|
* @return {Manager} self
|
|
* @api public
|
|
*/
|
|
open(fn, opts) {
|
|
debug("readyState %s", this.readyState);
|
|
if (~this.readyState.indexOf("open"))
|
|
return this;
|
|
debug("opening %s", this.uri);
|
|
this.engine = engine_io_client_1.default(this.uri, this.opts);
|
|
const socket = this.engine;
|
|
const self = this;
|
|
this.readyState = "opening";
|
|
this.skipReconnect = false;
|
|
// emit `open`
|
|
const openSub = on_1.on(socket, "open", function () {
|
|
self.onopen();
|
|
fn && fn();
|
|
});
|
|
// emit `connect_error`
|
|
const errorSub = on_1.on(socket, "error", function (data) {
|
|
debug("connect_error");
|
|
self.cleanup();
|
|
self.readyState = "closed";
|
|
self.emitAll("connect_error", data);
|
|
if (fn) {
|
|
const err = new Error("Connection error");
|
|
// err.data = data;
|
|
fn(err);
|
|
}
|
|
else {
|
|
// Only do this if there is no fn to handle the error
|
|
self.maybeReconnectOnOpen();
|
|
}
|
|
});
|
|
// emit `connect_timeout`
|
|
if (false !== this._timeout) {
|
|
const timeout = this._timeout;
|
|
debug("connect attempt will timeout after %d", timeout);
|
|
if (timeout === 0) {
|
|
openSub.destroy(); // prevents a race condition with the 'open' event
|
|
}
|
|
// set timer
|
|
const timer = setTimeout(function () {
|
|
debug("connect attempt timed out after %d", timeout);
|
|
openSub.destroy();
|
|
socket.close();
|
|
socket.emit("error", "timeout");
|
|
self.emitAll("connect_timeout", timeout);
|
|
}, timeout);
|
|
this.subs.push({
|
|
destroy: function () {
|
|
clearTimeout(timer);
|
|
},
|
|
});
|
|
}
|
|
this.subs.push(openSub);
|
|
this.subs.push(errorSub);
|
|
return this;
|
|
}
|
|
connect(fn, opts) {
|
|
debug("readyState %s", this.readyState);
|
|
if (~this.readyState.indexOf("open"))
|
|
return this;
|
|
debug("opening %s", this.uri);
|
|
this.engine = engine_io_client_1.default(this.uri, this.opts);
|
|
const socket = this.engine;
|
|
const self = this;
|
|
this.readyState = "opening";
|
|
this.skipReconnect = false;
|
|
// emit `open`
|
|
const openSub = on_1.on(socket, "open", function () {
|
|
self.onopen();
|
|
fn && fn();
|
|
});
|
|
// emit `connect_error`
|
|
const errorSub = on_1.on(socket, "error", function (data) {
|
|
debug("connect_error");
|
|
self.cleanup();
|
|
self.readyState = "closed";
|
|
self.emitAll("connect_error", data);
|
|
if (fn) {
|
|
const err = new Error("Connection error");
|
|
// err.data = data;
|
|
fn(err);
|
|
}
|
|
else {
|
|
// Only do this if there is no fn to handle the error
|
|
self.maybeReconnectOnOpen();
|
|
}
|
|
});
|
|
// emit `connect_timeout`
|
|
if (false !== this._timeout) {
|
|
const timeout = this._timeout;
|
|
debug("connect attempt will timeout after %d", timeout);
|
|
if (timeout === 0) {
|
|
openSub.destroy(); // prevents a race condition with the 'open' event
|
|
}
|
|
// set timer
|
|
const timer = setTimeout(function () {
|
|
debug("connect attempt timed out after %d", timeout);
|
|
openSub.destroy();
|
|
socket.close();
|
|
socket.emit("error", "timeout");
|
|
self.emitAll("connect_timeout", timeout);
|
|
}, timeout);
|
|
this.subs.push({
|
|
destroy: function () {
|
|
clearTimeout(timer);
|
|
},
|
|
});
|
|
}
|
|
this.subs.push(openSub);
|
|
this.subs.push(errorSub);
|
|
return this;
|
|
}
|
|
/**
|
|
* Called upon transport open.
|
|
*
|
|
* @api private
|
|
*/
|
|
onopen() {
|
|
debug("open");
|
|
// clear old subs
|
|
this.cleanup();
|
|
// mark as open
|
|
this.readyState = "open";
|
|
super.emit("open");
|
|
// add new subs
|
|
const socket = this.engine;
|
|
this.subs.push(on_1.on(socket, "data", component_bind_1.default(this, "ondata")));
|
|
this.subs.push(on_1.on(socket, "ping", component_bind_1.default(this, "onping")));
|
|
this.subs.push(on_1.on(socket, "error", component_bind_1.default(this, "onerror")));
|
|
this.subs.push(on_1.on(socket, "close", component_bind_1.default(this, "onclose")));
|
|
this.subs.push(on_1.on(this.decoder, "decoded", component_bind_1.default(this, "ondecoded")));
|
|
}
|
|
/**
|
|
* Called upon a ping.
|
|
*
|
|
* @api private
|
|
*/
|
|
onping() {
|
|
this.emitAll("ping");
|
|
}
|
|
/**
|
|
* Called with data.
|
|
*
|
|
* @api private
|
|
*/
|
|
ondata(data) {
|
|
this.decoder.add(data);
|
|
}
|
|
/**
|
|
* Called when parser fully decodes a packet.
|
|
*
|
|
* @api private
|
|
*/
|
|
ondecoded(packet) {
|
|
super.emit("packet", packet);
|
|
}
|
|
/**
|
|
* Called upon socket error.
|
|
*
|
|
* @api private
|
|
*/
|
|
onerror(err) {
|
|
debug("error", err);
|
|
this.emitAll("error", err);
|
|
}
|
|
/**
|
|
* Creates a new socket for the given `nsp`.
|
|
*
|
|
* @return {Socket}
|
|
* @api public
|
|
*/
|
|
socket(nsp, opts) {
|
|
let socket = this.nsps[nsp];
|
|
if (!socket) {
|
|
socket = new socket_1.Socket(this, nsp, opts);
|
|
this.nsps[nsp] = socket;
|
|
var self = this;
|
|
socket.on("connecting", onConnecting);
|
|
socket.on("connect", function () {
|
|
socket.id = self.generateId(nsp);
|
|
});
|
|
if (this.autoConnect) {
|
|
// manually call here since connecting event is fired before listening
|
|
onConnecting();
|
|
}
|
|
}
|
|
function onConnecting() {
|
|
if (!~indexof_1.default(self.connecting, socket)) {
|
|
self.connecting.push(socket);
|
|
}
|
|
}
|
|
return socket;
|
|
}
|
|
/**
|
|
* Called upon a socket close.
|
|
*
|
|
* @param {Socket} socket
|
|
*/
|
|
destroy(socket) {
|
|
const index = indexof_1.default(this.connecting, socket);
|
|
if (~index)
|
|
this.connecting.splice(index, 1);
|
|
if (this.connecting.length)
|
|
return;
|
|
this.close();
|
|
}
|
|
/**
|
|
* Writes a packet.
|
|
*
|
|
* @param {Object} packet
|
|
* @api private
|
|
*/
|
|
packet(packet) {
|
|
debug("writing packet %j", packet);
|
|
if (packet.query && packet.type === 0)
|
|
packet.nsp += "?" + packet.query;
|
|
if (!this.encoding) {
|
|
// encode, then write to engine with result
|
|
this.encoding = true;
|
|
const encodedPackets = this.encoder.encode(packet);
|
|
for (let i = 0; i < encodedPackets.length; i++) {
|
|
this.engine.write(encodedPackets[i], packet.options);
|
|
}
|
|
this.encoding = false;
|
|
this.processPacketQueue();
|
|
}
|
|
else {
|
|
// add packet to the queue
|
|
this.packetBuffer.push(packet);
|
|
}
|
|
}
|
|
/**
|
|
* If packet buffer is non-empty, begins encoding the
|
|
* next packet in line.
|
|
*
|
|
* @api private
|
|
*/
|
|
processPacketQueue() {
|
|
if (this.packetBuffer.length > 0 && !this.encoding) {
|
|
const pack = this.packetBuffer.shift();
|
|
this.packet(pack);
|
|
}
|
|
}
|
|
/**
|
|
* Clean up transport subscriptions and packet buffer.
|
|
*
|
|
* @api private
|
|
*/
|
|
cleanup() {
|
|
debug("cleanup");
|
|
const subsLength = this.subs.length;
|
|
for (let i = 0; i < subsLength; i++) {
|
|
const sub = this.subs.shift();
|
|
sub.destroy();
|
|
}
|
|
this.packetBuffer = [];
|
|
this.encoding = false;
|
|
this.decoder.destroy();
|
|
}
|
|
/**
|
|
* Close the current socket.
|
|
*
|
|
* @api private
|
|
*/
|
|
close() {
|
|
debug("disconnect");
|
|
this.skipReconnect = true;
|
|
this.reconnecting = false;
|
|
if ("opening" === this.readyState) {
|
|
// `onclose` will not fire because
|
|
// an open event never happened
|
|
this.cleanup();
|
|
}
|
|
this.backoff.reset();
|
|
this.readyState = "closed";
|
|
if (this.engine)
|
|
this.engine.close();
|
|
}
|
|
disconnect() {
|
|
debug("disconnect");
|
|
this.skipReconnect = true;
|
|
this.reconnecting = false;
|
|
if ("opening" === this.readyState) {
|
|
// `onclose` will not fire because
|
|
// an open event never happened
|
|
this.cleanup();
|
|
}
|
|
this.backoff.reset();
|
|
this.readyState = "closed";
|
|
if (this.engine)
|
|
this.engine.close();
|
|
}
|
|
/**
|
|
* Called upon engine close.
|
|
*
|
|
* @api private
|
|
*/
|
|
onclose(reason) {
|
|
debug("onclose");
|
|
this.cleanup();
|
|
this.backoff.reset();
|
|
this.readyState = "closed";
|
|
super.emit("close", reason);
|
|
if (this._reconnection && !this.skipReconnect) {
|
|
this.reconnect();
|
|
}
|
|
}
|
|
/**
|
|
* Attempt a reconnection.
|
|
*
|
|
* @api private
|
|
*/
|
|
reconnect() {
|
|
if (this.reconnecting || this.skipReconnect)
|
|
return this;
|
|
const self = this;
|
|
if (this.backoff.attempts >= this._reconnectionAttempts) {
|
|
debug("reconnect failed");
|
|
this.backoff.reset();
|
|
this.emitAll("reconnect_failed");
|
|
this.reconnecting = false;
|
|
}
|
|
else {
|
|
const delay = this.backoff.duration();
|
|
debug("will wait %dms before reconnect attempt", delay);
|
|
this.reconnecting = true;
|
|
const timer = setTimeout(function () {
|
|
if (self.skipReconnect)
|
|
return;
|
|
debug("attempting reconnect");
|
|
self.emitAll("reconnect_attempt", self.backoff.attempts);
|
|
self.emitAll("reconnecting", self.backoff.attempts);
|
|
// check again for the case socket closed in above events
|
|
if (self.skipReconnect)
|
|
return;
|
|
self.open(function (err) {
|
|
if (err) {
|
|
debug("reconnect attempt error");
|
|
self.reconnecting = false;
|
|
self.reconnect();
|
|
self.emitAll("reconnect_error", err.data);
|
|
}
|
|
else {
|
|
debug("reconnect success");
|
|
self.onreconnect();
|
|
}
|
|
});
|
|
}, delay);
|
|
this.subs.push({
|
|
destroy: function () {
|
|
clearTimeout(timer);
|
|
},
|
|
});
|
|
}
|
|
}
|
|
/**
|
|
* Called upon successful reconnect.
|
|
*
|
|
* @api private
|
|
*/
|
|
onreconnect() {
|
|
const attempt = this.backoff.attempts;
|
|
this.reconnecting = false;
|
|
this.backoff.reset();
|
|
this.updateSocketIds();
|
|
this.emitAll("reconnect", attempt);
|
|
}
|
|
}
|
|
exports.Manager = Manager;
|