# What changed in superagent

> 21 changes in superagent 4 to 10 from its official release notes, upgrade guides and advisories: 9 breaking, 3 new APIs and options. Each one cited. Sources checked 2026-10-27. HTML: https://unstale.sh/npm/superagent/

To see which of these apply to a repository, run `npx @unstale/cli init` in it.

## superagent 10

### New APIs and options

- Adds support for the Brotli compression format. (10.0.0) — [release notes](https://github.com/forwardemail/superagent/releases/tag/v10.0.0)

## superagent 9

### Fixes and other changes

- Fixed Formidable v3 multipart form contents being mapped to the expected format. (9.0.0) — [release notes](https://github.com/forwardemail/superagent/releases/tag/v9.0.0)
- Fixed an issue with numeric identifiers. (9.0.0) — [release notes](https://github.com/forwardemail/superagent/releases/tag/v9.0.0)

## superagent 8

### Breaking changes

- IE support using ActiveXObject was dropped. (8.0.0) — [release notes](https://github.com/forwardemail/superagent/releases/tag/v8.0.0)

### Fixes and other changes

- Fixed XMLHttpRequest in Electron. (8.0.0) — [release notes](https://github.com/forwardemail/superagent/releases/tag/v8.0.0)

## superagent 7

### Fixes and other changes

- Fixed abort logic for all Node versions. (7.0.0) — [release notes](https://github.com/forwardemail/superagent/releases/tag/v7.0.0)

## superagent 6

### Fixes and other changes

- Fixed case-sensitivity handling for content-type. (6.0.0) — [release notes](https://github.com/forwardemail/superagent/releases/tag/v6.0.0)

## superagent 5

### New APIs and options

- Adds an upload timeout so developers can limit how long an upload takes. (5.0.0) — [release notes](https://github.com/forwardemail/superagent/releases/tag/v5.0.0)

### Fixes and other changes

- Fixes handling of FormData errors. (5.0.0) — [release notes](https://github.com/forwardemail/superagent/releases/tag/v5.0.0)

## superagent 4

### Breaking changes

- In Node, responses with unknown MIME types are buffered by default; use buffer(false) on requests or set superagent.buffer[yourMimeType] = false to retain old behavior with custom unbuffered parsers. (4.0.0) — [release notes](https://github.com/forwardemail/superagent/releases/tag/v4.0.0)
- end() returns undefined instead of the request; save the request in a variable if needed, or migrate to promises with then(). (4.0.0) — [release notes](https://github.com/forwardemail/superagent/releases/tag/v4.0.0)
- Calling abort().end() now throws. (4.0.0) — [release notes](https://github.com/forwardemail/superagent/releases/tag/v4.0.0)
- The promise returned by end() is rejected on all error events. (4.0.0) — [release notes](https://github.com/forwardemail/superagent/releases/tag/v4.0.0)
- Browser code now uses ES6; Browserify or Webpack bundles targeting Internet Explorer also need Babel. The pre-built node_modules/superagent.js remains ES5-compatible. (4.0.0) — [release notes](https://github.com/forwardemail/superagent/releases/tag/v4.0.0)
- Node.js v4 is no longer supported; Node.js v6 or later is required, with Node.js 10 recommended. (4.0.0) — [release notes](https://github.com/forwardemail/superagent/releases/tag/v4.0.0)
- Invalid uses of pipe() now throw. (4.0.0) — [release notes](https://github.com/forwardemail/superagent/releases/tag/v4.0.0)
- Unsupported combinations of send and field now throw. (4.0.0) — [release notes](https://github.com/forwardemail/superagent/releases/tag/v4.0.0)

### New APIs and options

- Default buffer settings can now be based on response-type. (4.0.0) — [release notes](https://github.com/forwardemail/superagent/releases/tag/v4.0.0)

### Behavior and default changes

- Backticks are left unencoded in query strings where possible. (4.0.0) — [release notes](https://github.com/forwardemail/superagent/releases/tag/v4.0.0)

### Fixes and other changes

- In Node, https.servername is set from the Host header. (4.0.0) — [release notes](https://github.com/forwardemail/superagent/releases/tag/v4.0.0)
- response.buffered now reports buffering more accurately. (4.0.0) — [release notes](https://github.com/forwardemail/superagent/releases/tag/v4.0.0)