Method close

packages/engine.io/lib/socket.ts:559–585

* Closes the socket and underlying transport. * * @param {Boolean} discard - optional, discard the transport * @return {Socket} for chaining

(discard?: boolean)

   * @return {Socket} for chaining
   */
  public close(discard?: boolean) {
    if (
      discard &&
      (this.readyState === class="st">"open" || this.readyState === class="st">"closing")
    ) {
      return this.closeTransport(discard);
    }

    if (class="st">"open" !== this.readyState) return;

    this.readyState = class="st">"closing";

    if (this.writeBuffer.length) {
      debug(
        class="st">"there are %d remaining packets in the buffer, waiting for the 'drain' event",
        this.writeBuffer.length,
      );
      this.once(class="st">"drain", () => {
        debug(class="st">"all packets have been sent, closing the transport");
        this.closeTransport(discard);
      });
      return;
    }

    debug(class="st">"the buffer is empty, closing the transport right away");
    this.closeTransport(discard);
  }

  /**
   * Closes the underlying transport.