unetjs 3.0.0 → 3.1.2

package/dist/cjs/unet.cjs

@@ -1,8 +1,8 @@
-/* unet.js v3.0.0 2023-12-11T11:03:52.183Z */
+/* unet.js v3.1.2 2024-02-21T08:15:43.663Z */
 
 'use strict';
 
-/* fjage.js v1.11.2 */
+/* fjage.js v1.12.1 */
 
 const isBrowser =
   typeof window !== "undefined" && typeof window.document !== "undefined";
@@ -46,21 +46,20 @@ class TCPconnector {
   /**
     * Create an TCPConnector to connect to a fjage master over TCP
    * @param {Object} opts
-   * @param {string} [opts.hostname='localhost'] - hostname/ip address of the master container to connect to
-   * @param {number} opts.port - port number of the master container to connect to
-   * @param {string} opts.pathname - path of the master container to connect to
+   * @param {string} opts.hostname - hostname/ip address of the master container to connect to
+   * @param {string} opts.port - port number of the master container to connect to
    * @param {boolean} opts.keepAlive - try to reconnect if the connection is lost
    * @param {number} [opts.reconnectTime=5000] - time before reconnection is attempted after an error
     */
   constructor(opts = {}) {
+    let host = opts.hostname;
+    let port = opts.port;
+    this._keepAlive = opts.keepAlive;
+    this._reconnectTime = opts.reconnectTime || DEFAULT_RECONNECT_TIME$1;
     this.url = new URL('tcp://localhost');
-    let host = opts.hostname || 'localhost';
-    let port = opts.port || -1;
     this.url.hostname = host;
     this.url.port = port;
     this._buf = '';
-    this._reconnectTime = opts.reconnectTime || DEFAULT_RECONNECT_TIME$1;
-    this._keepAlive = opts.keepAlive || true;
     this._firstConn = true;               // if the Gateway has managed to connect to a server before
     this._firstReConn = true;             // if the Gateway has attempted to reconnect to a server before
     this.pendingOnOpen = [];              // list of callbacks make as soon as gateway is open
@@ -232,7 +231,7 @@ class WSConnector {
    * Create an WSConnector to connect to a fjage master over WebSockets
    * @param {Object} opts
    * @param {string} opts.hostname - hostname/ip address of the master container to connect to
-   * @param {number} opts.port - port number of the master container to connect to
+   * @param {string} opts.port - port number of the master container to connect to
    * @param {string} opts.pathname - path of the master container to connect to
    * @param {boolean} opts.keepAlive - try to reconnect if the connection is lost
    * @param {number} [opts.reconnectTime=5000] - time before reconnection is attempted after an error
@@ -242,8 +241,8 @@ class WSConnector {
     this.url.hostname = opts.hostname;
     this.url.port = opts.port;
     this.url.pathname = opts.pathname;
+    this._keepAlive = opts.keepAlive;
     this._reconnectTime = opts.reconnectTime || DEFAULT_RECONNECT_TIME;
-    this._keepAlive = opts.keepAlive || true;
     this.debug = opts.debug || false;      // debug info to be logged to console?
     this._firstConn = true;               // if the Gateway has managed to connect to a server before
     this._firstReConn = true;             // if the Gateway has attempted to reconnect to a server before
@@ -502,14 +501,17 @@ class AgentID {
     msg.index = Number.isInteger(index) ? index : -1;
     const rsp = await this.owner.request(msg, timeout);
     var ret = Array.isArray(params) ? new Array(params.length).fill(null) : null;
-    if (!rsp || rsp.perf != Performative.INFORM || !rsp.param) return ret;
+    if (!rsp || rsp.perf != Performative.INFORM || !rsp.param) {
+      if (this.owner._returnNullOnFailedResponse) return ret;
+      else throw new Error(`Unable to set ${this.name}.${params} to ${values}`);
+    }
     if (Array.isArray(params)) {
       if (!rsp.values) rsp.values = {};
       if (rsp.param) rsp.values[rsp.param] = rsp.value;
       const rvals = Object.keys(rsp.values);
       return params.map( p => {
         let f = rvals.find(rv => rv.endsWith(p));
-        return f ? rsp.values[f] : null;
+        return f ? rsp.values[f] : undefined;
       });
     } else {
       return rsp.value;
@@ -540,7 +542,10 @@ class AgentID {
     msg.index = Number.isInteger(index) ? index : -1;
     const rsp = await this.owner.request(msg, timeout);
     var ret = Array.isArray(params) ? new Array(params.length).fill(null) : null;
-    if (!rsp || rsp.perf != Performative.INFORM || (params && (!rsp.param))) return ret;
+    if (!rsp || rsp.perf != Performative.INFORM || !rsp.param) {
+      if (this.owner._returnNullOnFailedResponse) return ret;
+      else throw new Error(`Unable to get ${this.name}.${params}`);
+    }
     // Request for listing of all parameters.
     if (!params) {
       if (!rsp.values) rsp.values = {};
@@ -552,7 +557,7 @@ class AgentID {
       const rvals = Object.keys(rsp.values);
       return params.map(p => {
         let f = rvals.find(rv => rv.endsWith(p));
-        return f ? rsp.values[f] : null;
+        return f ? rsp.values[f] : undefined;
       });
     } else {
       return rsp.value;
@@ -636,12 +641,17 @@ class Message {
         return null;
       }
     }
-    let qclazz = obj.clazz;
-    let clazz = qclazz.replace(/^.*\./, '');
-    let rv = MessageClass[clazz] ? new MessageClass[clazz] : new Message();
-    rv.__clazz__ = qclazz;
-    rv._inflate(obj.data);
-    return rv;
+    try {
+      let qclazz = obj.clazz;
+      let clazz = qclazz.replace(/^.*\./, '');
+      let rv = MessageClass[clazz] ? new MessageClass[clazz] : new Message();
+      rv.__clazz__ = qclazz;
+      rv._inflate(obj.data);
+      return rv;
+    } catch (err) {
+      console.warn('Error trying to deserialize JSON object : ', obj, err);
+      return null;
+    }
   }
 }
 
@@ -652,16 +662,17 @@ class Message {
  *
  * @class
  * @param {Object} opts
- * @param {string} [opts.hostname="localhost"] - hostname/ip address of the master container to connect to
- * @param {number} [opts.port=1100]          - port number of the master container to connect to
- * @param {string} [opts.pathname=""]        - path of the master container to connect to (for WebSockets)
- * @param {string} [opts.keepAlive=true]     - try to reconnect if the connection is lost
- * @param {number} [opts.queueSize=128]      - size of the queue of received messages that haven't been consumed yet
- * @param {number} [opts.timeout=1000]       - timeout for fjage level messages in ms
- * @param {string} [hostname="localhost"]    - <strike>Deprecated : hostname/ip address of the master container to connect to</strike>
- * @param {number} [port=]                   - <strike>Deprecated : port number of the master container to connect to</strike>
- * @param {string} [pathname=="/ws/"]        - <strike>Deprecated : path of the master container to connect to (for WebSockets)</strike>
- * @param {number} [timeout=1000]            - <strike>Deprecated : timeout for fjage level messages in ms</strike>
+ * @param {string}  [opts.hostname="localhost"] - hostname/ip address of the master container to connect to
+ * @param {string}  [opts.port='1100']        - port number of the master container to connect to
+ * @param {string}  [opts.pathname=""]        - path of the master container to connect to (for WebSockets)
+ * @param {boolean} [opts.keepAlive=true]     - try to reconnect if the connection is lost
+ * @param {number}  [opts.queueSize=128]      - size of the queue of received messages that haven't been consumed yet
+ * @param {number}  [opts.timeout=1000]       - timeout for fjage level messages in ms
+ * @param {boolean} [opts.returnNullOnFailedResponse=true] - return null instead of throwing an error when a parameter is not found
+ * @param {string}  [hostname="localhost"]    - <strike>Deprecated : hostname/ip address of the master container to connect to</strike>
+ * @param {number}  [port=]                   - <strike>Deprecated : port number of the master container to connect to</strike>
+ * @param {string}  [pathname=="/ws/"]        - <strike>Deprecated : path of the master container to connect to (for WebSockets)</strike>
+ * @param {number}  [timeout=1000]            - <strike>Deprecated : timeout for fjage level messages in ms</strike>
  */
 class Gateway {
 
@@ -670,13 +681,17 @@ class Gateway {
     if (typeof opts === 'string' || opts instanceof String){
       opts = {
         'hostname': opts,
-        'port' : port || gObj.location.port,
+        'port' : port,
         'pathname' : pathname,
         'timeout' : timeout
       };
       console.warn('Deprecated use of Gateway constructor');
     }
-    opts = Object.assign({}, GATEWAY_DEFAULTS, opts);
+
+    // Set defaults
+    for (var key in GATEWAY_DEFAULTS){
+      if (opts[key] == undefined || opts[key] === '') opts[key] = GATEWAY_DEFAULTS[key];
+    }
     var url = DEFAULT_URL;
     url.hostname = opts.hostname;
     url.port = opts.port;
@@ -685,7 +700,8 @@ class Gateway {
     if (existing) return existing;
     this._timeout = opts.timeout;         // timeout for fjage level messages (agentForService etc)
     this._keepAlive = opts.keepAlive;     // reconnect if connection gets closed/errored
-    this._queueSize = opts.queueSize;      // size of queue
+    this._queueSize = opts.queueSize;     // size of queue
+    this._returnNullOnFailedResponse = opts.returnNullOnFailedResponse; // null or error
     this.pending = {};                    // msgid to callback mapping for pending requests to server
     this.subscriptions = {};              // hashset for all topics that are subscribed
     this.listener = {};                   // set of callbacks that want to listen to incoming messages
@@ -1036,6 +1052,30 @@ class Gateway {
     this._update_watch();
   }
 
+  /**
+   * Gets a list of all agents in the container.
+   * @returns {Promise<AgentID[]>} - a promise which returns an array of all agent ids when resolved
+   */
+  async agents() {
+    let rq = { action: 'agents' };
+    let rsp = await this._msgTxRx(rq);
+    if (!rsp || !Array.isArray(rsp.agentIDs)) throw new Error('Unable to get agents');
+    return rsp.agentIDs.map(aid => new AgentID(aid, false, this));
+  }
+
+  /**
+   * Check if an agent with a given name exists in the container.
+   *
+   * @param {AgentID|String} agentID - the agent id to check
+   * @returns {Promise<boolean>} - a promise which returns true if the agent exists when resolved
+   */
+  async containsAgent(agentID) {
+    let rq = { action: 'containsAgent', agentID: agentID instanceof AgentID ? agentID.getName() : agentID };
+    let rsp = await this._msgTxRx(rq);
+    if (!rsp) throw new Error('Unable to check if agent exists');
+    return !!rsp.answer;
+  }
+
   /**
    * Finds an agent that provides a named service. If multiple agents are registered
    * to provide a given service, any of the agents' id may be returned.
@@ -1046,7 +1086,11 @@ class Gateway {
   async agentForService(service) {
     let rq = { action: 'agentForService', service: service };
     let rsp = await this._msgTxRx(rq);
-    if (!rsp || !rsp.agentID) return;
+    if (!rsp) {
+      if (this._returnNullOnFailedResponse) return null;
+      else throw new Error('Unable to get agent for service');
+    }
+    if (!rsp.agentID) return null;
     return new AgentID(rsp.agentID, false, this);
   }
 
@@ -1060,7 +1104,11 @@ class Gateway {
     let rq = { action: 'agentsForService', service: service };
     let rsp = await this._msgTxRx(rq);
     let aids = [];
-    if (!rsp || !Array.isArray(rsp.agentIDs)) return aids;
+    if (!rsp) {
+      if (this._returnNullOnFailedResponse) return aids;
+      else throw new Error('Unable to get agents for service');
+    }
+    if (!Array.isArray(rsp.agentIDs)) return aids;
     for (var i = 0; i < rsp.agentIDs.length; i++)
       aids.push(new AgentID(rsp.agentIDs[i], false, this));
     return aids;
@@ -1279,7 +1327,8 @@ if (isBrowser || isWebWorker){
     'pathname' : '/ws/',
     'timeout': 1000,
     'keepAlive' : true,
-    'queueSize': DEFAULT_QUEUE_SIZE
+    'queueSize': DEFAULT_QUEUE_SIZE,
+    'returnNullOnFailedResponse': true
   });
   DEFAULT_URL = new URL('ws://localhost');
   // Enable caching of Gateways
@@ -1293,7 +1342,8 @@ if (isBrowser || isWebWorker){
     'pathname': '',
     'timeout': 1000,
     'keepAlive' : true,
-    'queueSize': DEFAULT_QUEUE_SIZE
+    'queueSize': DEFAULT_QUEUE_SIZE,
+    'returnNullOnFailedResponse': true
   });
   DEFAULT_URL = new URL('tcp://localhost');
   gObj.atob = a => Buffer.from(a, 'base64').toString('binary');
@@ -1728,7 +1778,7 @@ const RxFrameNtf = UnetMessages.RxFrameNtf;
  *
  * @class UnetSocket
  * @param {string} [hostname] - hostname/ip address of the master container to connect to
- * @param {number} [port] - port number of the master container to connect to
+ * @param {string} [port] - port number of the master container to connect to
  * @param {string} [path='']  - path of the master container to connect to (for WebSockets)
  * @returns {Promise<UnetSocket>} - Promise which resolves to the UnetSocket object being constructed
  *

package/dist/esm/unet.js

@@ -1,6 +1,6 @@
-/* unet.js v3.0.0 2023-12-11T11:03:52.183Z */
+/* unet.js v3.1.2 2024-02-21T08:15:43.662Z */
 
-/* fjage.js v1.11.2 */
+/* fjage.js v1.12.1 */
 
 const isBrowser =
   typeof window !== "undefined" && typeof window.document !== "undefined";
@@ -44,21 +44,20 @@ class TCPconnector {
   /**
     * Create an TCPConnector to connect to a fjage master over TCP
    * @param {Object} opts
-   * @param {string} [opts.hostname='localhost'] - hostname/ip address of the master container to connect to
-   * @param {number} opts.port - port number of the master container to connect to
-   * @param {string} opts.pathname - path of the master container to connect to
+   * @param {string} opts.hostname - hostname/ip address of the master container to connect to
+   * @param {string} opts.port - port number of the master container to connect to
    * @param {boolean} opts.keepAlive - try to reconnect if the connection is lost
    * @param {number} [opts.reconnectTime=5000] - time before reconnection is attempted after an error
     */
   constructor(opts = {}) {
+    let host = opts.hostname;
+    let port = opts.port;
+    this._keepAlive = opts.keepAlive;
+    this._reconnectTime = opts.reconnectTime || DEFAULT_RECONNECT_TIME$1;
     this.url = new URL('tcp://localhost');
-    let host = opts.hostname || 'localhost';
-    let port = opts.port || -1;
     this.url.hostname = host;
     this.url.port = port;
     this._buf = '';
-    this._reconnectTime = opts.reconnectTime || DEFAULT_RECONNECT_TIME$1;
-    this._keepAlive = opts.keepAlive || true;
     this._firstConn = true;               // if the Gateway has managed to connect to a server before
     this._firstReConn = true;             // if the Gateway has attempted to reconnect to a server before
     this.pendingOnOpen = [];              // list of callbacks make as soon as gateway is open
@@ -230,7 +229,7 @@ class WSConnector {
    * Create an WSConnector to connect to a fjage master over WebSockets
    * @param {Object} opts
    * @param {string} opts.hostname - hostname/ip address of the master container to connect to
-   * @param {number} opts.port - port number of the master container to connect to
+   * @param {string} opts.port - port number of the master container to connect to
    * @param {string} opts.pathname - path of the master container to connect to
    * @param {boolean} opts.keepAlive - try to reconnect if the connection is lost
    * @param {number} [opts.reconnectTime=5000] - time before reconnection is attempted after an error
@@ -240,8 +239,8 @@ class WSConnector {
     this.url.hostname = opts.hostname;
     this.url.port = opts.port;
     this.url.pathname = opts.pathname;
+    this._keepAlive = opts.keepAlive;
     this._reconnectTime = opts.reconnectTime || DEFAULT_RECONNECT_TIME;
-    this._keepAlive = opts.keepAlive || true;
     this.debug = opts.debug || false;      // debug info to be logged to console?
     this._firstConn = true;               // if the Gateway has managed to connect to a server before
     this._firstReConn = true;             // if the Gateway has attempted to reconnect to a server before
@@ -500,14 +499,17 @@ class AgentID {
     msg.index = Number.isInteger(index) ? index : -1;
     const rsp = await this.owner.request(msg, timeout);
     var ret = Array.isArray(params) ? new Array(params.length).fill(null) : null;
-    if (!rsp || rsp.perf != Performative.INFORM || !rsp.param) return ret;
+    if (!rsp || rsp.perf != Performative.INFORM || !rsp.param) {
+      if (this.owner._returnNullOnFailedResponse) return ret;
+      else throw new Error(`Unable to set ${this.name}.${params} to ${values}`);
+    }
     if (Array.isArray(params)) {
       if (!rsp.values) rsp.values = {};
       if (rsp.param) rsp.values[rsp.param] = rsp.value;
       const rvals = Object.keys(rsp.values);
       return params.map( p => {
         let f = rvals.find(rv => rv.endsWith(p));
-        return f ? rsp.values[f] : null;
+        return f ? rsp.values[f] : undefined;
       });
     } else {
       return rsp.value;
@@ -538,7 +540,10 @@ class AgentID {
     msg.index = Number.isInteger(index) ? index : -1;
     const rsp = await this.owner.request(msg, timeout);
     var ret = Array.isArray(params) ? new Array(params.length).fill(null) : null;
-    if (!rsp || rsp.perf != Performative.INFORM || (params && (!rsp.param))) return ret;
+    if (!rsp || rsp.perf != Performative.INFORM || !rsp.param) {
+      if (this.owner._returnNullOnFailedResponse) return ret;
+      else throw new Error(`Unable to get ${this.name}.${params}`);
+    }
     // Request for listing of all parameters.
     if (!params) {
       if (!rsp.values) rsp.values = {};
@@ -550,7 +555,7 @@ class AgentID {
       const rvals = Object.keys(rsp.values);
       return params.map(p => {
         let f = rvals.find(rv => rv.endsWith(p));
-        return f ? rsp.values[f] : null;
+        return f ? rsp.values[f] : undefined;
       });
     } else {
       return rsp.value;
@@ -634,12 +639,17 @@ class Message {
         return null;
       }
     }
-    let qclazz = obj.clazz;
-    let clazz = qclazz.replace(/^.*\./, '');
-    let rv = MessageClass[clazz] ? new MessageClass[clazz] : new Message();
-    rv.__clazz__ = qclazz;
-    rv._inflate(obj.data);
-    return rv;
+    try {
+      let qclazz = obj.clazz;
+      let clazz = qclazz.replace(/^.*\./, '');
+      let rv = MessageClass[clazz] ? new MessageClass[clazz] : new Message();
+      rv.__clazz__ = qclazz;
+      rv._inflate(obj.data);
+      return rv;
+    } catch (err) {
+      console.warn('Error trying to deserialize JSON object : ', obj, err);
+      return null;
+    }
   }
 }
 
@@ -650,16 +660,17 @@ class Message {
  *
  * @class
  * @param {Object} opts
- * @param {string} [opts.hostname="localhost"] - hostname/ip address of the master container to connect to
- * @param {number} [opts.port=1100]          - port number of the master container to connect to
- * @param {string} [opts.pathname=""]        - path of the master container to connect to (for WebSockets)
- * @param {string} [opts.keepAlive=true]     - try to reconnect if the connection is lost
- * @param {number} [opts.queueSize=128]      - size of the queue of received messages that haven't been consumed yet
- * @param {number} [opts.timeout=1000]       - timeout for fjage level messages in ms
- * @param {string} [hostname="localhost"]    - <strike>Deprecated : hostname/ip address of the master container to connect to</strike>
- * @param {number} [port=]                   - <strike>Deprecated : port number of the master container to connect to</strike>
- * @param {string} [pathname=="/ws/"]        - <strike>Deprecated : path of the master container to connect to (for WebSockets)</strike>
- * @param {number} [timeout=1000]            - <strike>Deprecated : timeout for fjage level messages in ms</strike>
+ * @param {string}  [opts.hostname="localhost"] - hostname/ip address of the master container to connect to
+ * @param {string}  [opts.port='1100']        - port number of the master container to connect to
+ * @param {string}  [opts.pathname=""]        - path of the master container to connect to (for WebSockets)
+ * @param {boolean} [opts.keepAlive=true]     - try to reconnect if the connection is lost
+ * @param {number}  [opts.queueSize=128]      - size of the queue of received messages that haven't been consumed yet
+ * @param {number}  [opts.timeout=1000]       - timeout for fjage level messages in ms
+ * @param {boolean} [opts.returnNullOnFailedResponse=true] - return null instead of throwing an error when a parameter is not found
+ * @param {string}  [hostname="localhost"]    - <strike>Deprecated : hostname/ip address of the master container to connect to</strike>
+ * @param {number}  [port=]                   - <strike>Deprecated : port number of the master container to connect to</strike>
+ * @param {string}  [pathname=="/ws/"]        - <strike>Deprecated : path of the master container to connect to (for WebSockets)</strike>
+ * @param {number}  [timeout=1000]            - <strike>Deprecated : timeout for fjage level messages in ms</strike>
  */
 class Gateway {
 
@@ -668,13 +679,17 @@ class Gateway {
     if (typeof opts === 'string' || opts instanceof String){
       opts = {
         'hostname': opts,
-        'port' : port || gObj.location.port,
+        'port' : port,
         'pathname' : pathname,
         'timeout' : timeout
       };
       console.warn('Deprecated use of Gateway constructor');
     }
-    opts = Object.assign({}, GATEWAY_DEFAULTS, opts);
+
+    // Set defaults
+    for (var key in GATEWAY_DEFAULTS){
+      if (opts[key] == undefined || opts[key] === '') opts[key] = GATEWAY_DEFAULTS[key];
+    }
     var url = DEFAULT_URL;
     url.hostname = opts.hostname;
     url.port = opts.port;
@@ -683,7 +698,8 @@ class Gateway {
     if (existing) return existing;
     this._timeout = opts.timeout;         // timeout for fjage level messages (agentForService etc)
     this._keepAlive = opts.keepAlive;     // reconnect if connection gets closed/errored
-    this._queueSize = opts.queueSize;      // size of queue
+    this._queueSize = opts.queueSize;     // size of queue
+    this._returnNullOnFailedResponse = opts.returnNullOnFailedResponse; // null or error
     this.pending = {};                    // msgid to callback mapping for pending requests to server
     this.subscriptions = {};              // hashset for all topics that are subscribed
     this.listener = {};                   // set of callbacks that want to listen to incoming messages
@@ -1034,6 +1050,30 @@ class Gateway {
     this._update_watch();
   }
 
+  /**
+   * Gets a list of all agents in the container.
+   * @returns {Promise<AgentID[]>} - a promise which returns an array of all agent ids when resolved
+   */
+  async agents() {
+    let rq = { action: 'agents' };
+    let rsp = await this._msgTxRx(rq);
+    if (!rsp || !Array.isArray(rsp.agentIDs)) throw new Error('Unable to get agents');
+    return rsp.agentIDs.map(aid => new AgentID(aid, false, this));
+  }
+
+  /**
+   * Check if an agent with a given name exists in the container.
+   *
+   * @param {AgentID|String} agentID - the agent id to check
+   * @returns {Promise<boolean>} - a promise which returns true if the agent exists when resolved
+   */
+  async containsAgent(agentID) {
+    let rq = { action: 'containsAgent', agentID: agentID instanceof AgentID ? agentID.getName() : agentID };
+    let rsp = await this._msgTxRx(rq);
+    if (!rsp) throw new Error('Unable to check if agent exists');
+    return !!rsp.answer;
+  }
+
   /**
    * Finds an agent that provides a named service. If multiple agents are registered
    * to provide a given service, any of the agents' id may be returned.
@@ -1044,7 +1084,11 @@ class Gateway {
   async agentForService(service) {
     let rq = { action: 'agentForService', service: service };
     let rsp = await this._msgTxRx(rq);
-    if (!rsp || !rsp.agentID) return;
+    if (!rsp) {
+      if (this._returnNullOnFailedResponse) return null;
+      else throw new Error('Unable to get agent for service');
+    }
+    if (!rsp.agentID) return null;
     return new AgentID(rsp.agentID, false, this);
   }
 
@@ -1058,7 +1102,11 @@ class Gateway {
     let rq = { action: 'agentsForService', service: service };
     let rsp = await this._msgTxRx(rq);
     let aids = [];
-    if (!rsp || !Array.isArray(rsp.agentIDs)) return aids;
+    if (!rsp) {
+      if (this._returnNullOnFailedResponse) return aids;
+      else throw new Error('Unable to get agents for service');
+    }
+    if (!Array.isArray(rsp.agentIDs)) return aids;
     for (var i = 0; i < rsp.agentIDs.length; i++)
       aids.push(new AgentID(rsp.agentIDs[i], false, this));
     return aids;
@@ -1277,7 +1325,8 @@ if (isBrowser || isWebWorker){
     'pathname' : '/ws/',
     'timeout': 1000,
     'keepAlive' : true,
-    'queueSize': DEFAULT_QUEUE_SIZE
+    'queueSize': DEFAULT_QUEUE_SIZE,
+    'returnNullOnFailedResponse': true
   });
   DEFAULT_URL = new URL('ws://localhost');
   // Enable caching of Gateways
@@ -1291,7 +1340,8 @@ if (isBrowser || isWebWorker){
     'pathname': '',
     'timeout': 1000,
     'keepAlive' : true,
-    'queueSize': DEFAULT_QUEUE_SIZE
+    'queueSize': DEFAULT_QUEUE_SIZE,
+    'returnNullOnFailedResponse': true
   });
   DEFAULT_URL = new URL('tcp://localhost');
   gObj.atob = a => Buffer.from(a, 'base64').toString('binary');
@@ -1726,7 +1776,7 @@ const RxFrameNtf = UnetMessages.RxFrameNtf;
  *
  * @class UnetSocket
  * @param {string} [hostname] - hostname/ip address of the master container to connect to
- * @param {number} [port] - port number of the master container to connect to
+ * @param {string} [port] - port number of the master container to connect to
  * @param {string} [path='']  - path of the master container to connect to (for WebSockets)
  * @returns {Promise<UnetSocket>} - Promise which resolves to the UnetSocket object being constructed
  *