Skip to content

Removing support for Node 18 and other upcoming breaking changesΒ #2359

Closed

Description

@zimeg

πŸ‘‹ Hello! This issue announces support for Node 18 is being removed within a few months to add support and develop with changes from more recent Node versions. Ongoing changes and discussion can be followed along here!

πŸ“† Timeline

As overview for what's ahead, the following timeline might be useful:

  • Upstream Node 18 reaches EOL: 2025-03-27.
  • Notice of removing support: 2025-09-03.
  • Development releases shared: 2025-10-03 or sooner.
  • Public release of new package versions: 2025-12-02 or later.
  • Previous versions become unsupported: 2026-01-01 or later.

References

πŸ‘Ύ Planned changes

Breaking changes planned for this next major version follow.

Supported Node version

The Node 18 release will no longer be supported or used in testing. Future development will use features from the latest releases for the following versions:

  • Node 20 - "Maintenace": What we use in testing.
  • Node 22 - "Active": What we use in testing.
  • Node 24 - "Current": What we will recommend applications use.

Using the fetch API to send requests

The axios package has been used to send requests with both the @slack/web-api and @slack/webhook packages. We'll look to replace this with the undici package to align with the Node implementation. Related: #1525 #1761.

Using request and response in installation callbacks

The installer handler callback arguments from @slack/oauth are changing to Request and Response objects as a more compatible standard. For: #2270.

Unnesting responses from the filesUploadV2 method

The shape of responses from the filesUploadV2 method of @slack/web-api will be flattened to return file indicies at the top of the response. From: #1803.

Converting code samples and examples to ECMAScript modules

Examples documented for these packages will use ECMAScript modules.

Removing deprecated features

These next major versions will remove deprecated features from packages.

Removing unsupported packages from the main branch

The @slack/client, @slack/events-api, and @slack/interactive-messages packages are being removed from the main branch after being EOL for a handful of years.

Converting test runners to default scaffoldings

Recent Node updates introduced a test runner for setting up and asserting cases. We can perhaps use this to reduce updates from dependencies. Similar: #2304 #2348 #2349 #2350 #2351 #2352.

πŸ‘οΈβ€πŸ—¨οΈ Future changes

A few open issues address breaking changes to @slack/types that might not be included in this set of changes and might involve coordinating changes with @slack/bolt in upcoming releases. Follows: #1768 #1816 #1904 #1905.

πŸ“ Notes

Super open to discussing the scope of these changes and considerations of all kind!

For sometime soon I'm hoping we can start developing against supported Node versions in sample apps and begin testing in CI πŸš€

Activity

  1. added theissue type on Sep 4, 2025
  2. pinned this issue on Sep 4, 2025
  3. github-actions commented on Nov 10, 2025

    @github-actions
    Contributor

    πŸ‘‹ It looks like this issue has been open for 30 days with no activity. We'll mark this as stale for now, and wait 10 days for an update or for further comment before closing this issue out. If you think this issue needs to be prioritized, please comment to get the thread going again! Maintainers also review issues marked as stale on a regular basis and comment or adjust status if the issue needs to be reprioritized.

  4. benmccann commented on Mar 8, 2026

    @benmccann

    Looks like this is now planned: #2359

  5. WilliamBergamin commented on Nov 10, 2026

    @WilliamBergamin
    Contributor

    πŸŽ‰ The majors planned here shipped on 2026-07-14: @slack/web-api@8.0.0, @slack/webhook@8.0.0, @slack/oauth@4.0.0, @slack/socket-mode@3.0.0, @slack/types@3.0.0, @slack/logger@5.0.0, @slack/cli-hooks@2.0.0, and @slack/cli-test@5.0.0.

    What landed:

    • Node 20+ is required across these packages, and CI tests Node 20 through 26.
    • axios is gone: @slack/web-api and @slack/webhook now send requests with fetch (replace axios with fetchΒ #1525).
    • @slack/client, @slack/events-api, and @slack/interactive-messages were removed from main.
    • Tests run on the built-in Node test runner in every package.

    A few items didn't make this round and are tracked in their own issues:

    @slack/rtm-api stays on 7.x for now, since it serves legacy apps only.

    Closing this one out since the release it announced has shipped. Thanks everyone for the input along the way! πŸš€

  6. unpinned this issue on Nov 10, 2026
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

    auto-triage-skipdiscussionM-T: An issue where more input is needed to reach a decisionpkg:cli-hooksapplies to `@slack/cli-hooks`pkg:cli-testapplies to `@slack/cli-test`pkg:loggerapplies to `@slack/logger`pkg:oauthapplies to `@slack/oauth`pkg:rtm-apiapplies to `@slack/rtm-api`pkg:socket-modeapplies to `@slack/socket-mode`pkg:typesapplies to `@slack/types`pkg:web-apiapplies to `@slack/web-api`pkg:webhookapplies to `@slack/webhook`semver:major

    Type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions