Skip to content

"Basic CRUD application" can't be started with Angular client #5567

Open

Description

@bubokko

Describe the bug
When trying to run npm start in the angular-client folder on Basic CRUD application example, the error is being thrown:

✘ [ERROR] TS2552: Cannot find name 'MapIterator'. Did you mean 'Iterator'? [plugin angular-compiler]

    node_modules/engine.io-client/build/esm/globals.node.d.ts:17:19:
      17 │     get cookies(): MapIterator<[string, Cookie]>;

To Reproduce

Just run npm start.

Socket.IO server version: 4.0.1

Socket.IO client version: 4.7.2

Platform:

  • Device: MacBook Pro M2
  • OS: macOS 26.6.2

Activity

  1. added
    to triageWaiting to be triaged by a member of the team
    on Oct 5, 2026
  2. RagedPanda commented on Oct 21, 2026

    @RagedPanda

    This is a TypeScript version mismatch, not anything wrong with the example code itself.

    engine.io-client@6.6.7 (published Sep 25) changed cookies() in globals.node.d.ts to return MapIterator<...>. That type only exists in TypeScript's lib from 5.6 onwards. The angular-client example pins typescript: ~5.2.2 (Angular 17), and since socket.io-client depends on engine.io-client: ~6.6.1, a fresh npm install pulls in 6.6.7 and the compiler can't find the type.

    Two ways to get it running:

    1. Skip type-checking of .d.ts files (quickest). In tsconfig.json:

    "compilerOptions": {
      "skipLibCheck": true,
      ...
    }

    2. Pin engine.io-client to the previous patch in package.json, then reinstall:

    "overrides": {
      "engine.io-client": "6.6.6"
    }

    Bumping TypeScript to 5.6+ would also fix it, but Angular 17 doesn't support that version, so you'd need to upgrade Angular as well. Not worth it just to run the example.

    It might also be worth fixing on the engine.io side: a patch release that needs TS 5.6 will hit anyone on an older toolchain. IterableIterator<[string, Cookie]> would keep working on older TS versions.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    to triageWaiting to be triaged by a member of the team

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions