Method of

packages/socket.io/lib/index.ts:769–815

* Looks up a namespace. * * @example * // with a simple string * const myNamespace = io.of("/my-namespace"); * * // with a regex * const dynamicNsp = io.of(/^\/dynamic-\d+$/).on("connection", (socket) => { * const namespace = socket.nsp; // newNamespace.name === "/dynamic-1

(
    name: string | RegExp | ParentNspNameMatchFn,
    fn?: (
      socket: Socket<ListenEvents, EmitEvents, ServerSideEvents, SocketData>,
    ) => void,
  )

   * @param fn optional, nsp `connection` ev handler
   */
  public of(
    name: string | RegExp | ParentNspNameMatchFn,
    fn?: (
      socket: Socket<ListenEvents, EmitEvents, ServerSideEvents, SocketData>,
    ) => void,
  ): Namespace<ListenEvents, EmitEvents, ServerSideEvents, SocketData> {
    if (typeof name === class="st">"function" || name instanceof RegExp) {
      const parentNsp = new ParentNamespace(this);
      debug(class="st">"initializing parent namespace %s", parentNsp.name);
      if (typeof name === class="st">"function") {
        this.parentNsps.set(name, parentNsp);
      } else {
        this.parentNsps.set(
          (nsp, conn, next) => next(null, (name as RegExp).test(nsp)),
          parentNsp,
        );
        this.parentNamespacesFromRegExp.set(name, parentNsp);
      }
      if (fn) {
        class="cm">// @ts-ignore
        parentNsp.on(class="st">"connect", fn);
      }
      return parentNsp;
    }

    if (String(name)[0] !== class="st">"/") name = class="st">"/" + name;

    let nsp = this._nsps.get(name);
    if (!nsp) {
      for (const [regex, parentNamespace] of this.parentNamespacesFromRegExp) {
        if (regex.test(name as string)) {
          debug(class="st">"attaching namespace %s to parent namespace %s", name, regex);
          return parentNamespace.createChild(name as string);
        }
      }

      debug(class="st">"initializing namespace %s", name);
      nsp = new Namespace(this, name);
      this._nsps.set(name, nsp);
      if (name !== class="st">"/") {
        class="cm">// @ts-ignore
        this.sockets.emitReserved(class="st">"new_namespace", nsp);
      }
    }
    if (fn) nsp.on(class="st">"connect", fn);
    return nsp;
  }

  /**
   * Closes server connection