CHANGELOG.md

CHANGELOG - throttle

6.0.1 - 2026-07-16

Fixed

• Make throttle work on GitHub Actions again: Linux throttling no longer fails with "Exclusivity flag on, cannot modify" when another tool already holds the ingress qdisc slot on the interface. GitHub-hosted Actions runners now come with an eBPF network-monitoring agent that attaches a clsact qdisc to the default interface (other eBPF-based security agents do the same), and since only one ingress/clsact qdisc can exist per device, throttle's tc qdisc add ... ingress failed and took the whole measurement run down with it. The original code path is unchanged and runs first; only when it fails does throttle fall back to attaching its redirect filters to the existing qdisc (on the clsact ingress hook when needed), with explicit filter priorities so stop removes exactly its own filters and leaves the other tool's qdisc and filters untouched. #108.

6.0.0 - 2026-03-23

Added

• Added IPv6 throttling support on macOS #94 and Linux #100.
• Apply packet loss also to the upload interface #69.

Fixed

• More robust detection of the default network interface on Linux, falling back to global IP address lookup when the default route is unavailable #104.
• Fixed README profile values for DSL and Edge to match actual code, and fixed Node.js API examples to use named imports.

Tech

• Updated ESLint to 10, Prettier to 3, and migrated to flat config #101 #103.
• Updated GitHub Actions to use actions/checkout@v4 and actions/setup-node@v4.

5.0.1 - 2024-08-26

Fixed

• Smarter ifb0 handling on Linux #93.

5.0.0 - 2022-07-02

Changed

• Dropped support for NodeJS 12 since it's unmaintaned.

Tech

• Code cleanup using eslint-plugin-unicorn.

4.0.3 - 2022-06-29

Fixed

• Fixed --version so it actually shows the version again #75.

4.0.2 - 2022-06-21

Fixed

• The E6 Module convertion in 4.0 broke version check (--version) making installs failed. PR #74 is a temporaty fix for that.

4.0.1 - 2022-06-17

Fixed

• Removed the dependecy of route. Using ip route instead and we already have ip as a requirement.

4.0.0 - 2022-04-14

Changed

• Converting the project to ES6 module. If you run Throttle by command line it will work exactly as before except that we dropped support for NodeJS 10 #67. You can read Sindre Sorhus ESM package guide.

Fixed

• Updated dev dependencies to latest versions #68

3.1.1 - 2022-04-19

Fixed

• Updated minimist dependency.

3.1.0 - 2021-12-26

Added

• Add support for setting packet loss. Add --packetLoss and set the loss in percentage.

3.0.0 - 2021-08-09

Changed

• When you run on Mac OS we changed so localhost traffic is not throttled by default. To throttle on localhost use --localhost. This makes sence if you use WebDriver to drive your browser on your local machine. And Mac OS now works the same as Linux.

2.1.2 - 2021-07-29

Fixed

• Fix breakage when multiple default routes are declared , thank you Andy Richardson for PR #62.

2.1.1 - 2021-03-19

Fixed

• A better check for missing net-tools on Linux, thank you Radu Micu for the PR #56.

2.1.0 - 2021-03-10

Added

• Added support for config files. Use --config config.json to read configuration setup from a file.

2.0.2 - 2020-09-10

Fixed

• Make the install as small as possible.

2.0.1 - 2020-08-22

Fixed

• Removed the execa dependency to make sure we have minimal dependencies #53.

2.0.0 - 2020-08-14

Changed

• You can now set one of up/down/rtt if you like as introduced by Iñaki Baz Castillo - thank you! Implemented in #46. This also remove the default profile meaning there's a change in behavior if you run throttle without any parameters. Before a default profile was used but now you get an error (you know need to set a profile or set up/down or rtt).

Added

• You can use --log to log all networks commands #45.
• Added support to add delay on for localhost on OS X. Use --rtt 100 --localhost #51.

Fixed

• Add missing await when removing the ingress if removing root fails for tc #47.
• Better error handling in the CLI #48. Make sure that the exit code is > 0 if setting the throttling fails.

Tech

• Removed configuration file for pfctl to make it easier to set up dynamic dummynet #49

1.1.0 2020-07-29

Fixed

• Updated execa to 4.0.3.
• Removed log message "using default profile"

Added

• You can log all the commands that sets up the throttling by setting LOG_THROTTLE=true #44.

1.0.3 2020-06-20

Fixed

• Updated minimist

1.0.2 2020-03-09

Fixed

• Fixed dependency tree and npm-shrinkwrap to only hold dependencies for production.

1.0.1 2020-02-03

Fixed

• Another fix to 2g to get that right, thank you Matt! #37.

1.0.0 2020-02-03

Changed

• 2g speed was updated to become more usable and follow WPT #36 - thank you Matt Hobbs for the PR.

Added

• More pre-made profiles: dsl, 3gem, 4g, lte, edge, dial, fois #36 - thank you Matt Hobbs for the PR.

0.5.4 2019-08-26

Fixed

• Another execa fix, hopefully fixing the last thing + added more tests in Travis.

0.5.3 2019-08-26

Fixed

• Over optimistic Execa upgraded caused Throttle to stop working #32.

0.5.2 2019-08-26

Fixed

• Updated dependencies #31.

0.5.1 2019-04-23

Fixed

• Calling stop on Linux throwed error see #20 and fixed by Iñaki Baz Castillo, thank you!

0.5.0 2018-12-07

Added

• Simplified profile/stop/help. You can now start with: throttle $profile and stop with throttle stop

0.4.3 2018-09-01

Fixed

• Upload throttling was wrong on Mac OS X, thank you Paul for the PR.

0.4.2 2018-05-30

Fixed

• Catching when ifb has already been setup.

0.4.1 2018-05-30

Fixed

• Another go at trying to try/catch failing settings.

0.4.0 2018-05-30

Added

• Rewrite to async/await from promises

0.3.0 2018-04-12

Fixed

• Ensure setup has completed fully before returning when starting throttling with tc.
• Always return Promises from start() and stop(), even in case of errors.
• Typo in the CLI help
• Simpler way to set connectivity with tc

0.2.0 2017-10-31

Added

• You can now see the version with --version
• You can now use pre defined profiles.

0.1.0 2017-10-13

Fixed

• Always remove filters before we try to set them.