forwardemail/superagent

★ 16,650JavaScriptAudience · developerComplexity · 2/5Setup · easy

Mindmap

mindmap
  root((SuperAgent))
    What it does
      HTTP requests
      Node and browser
      Chained API
    Request features
      JSON body
      File upload
      Query params
    Syntax styles
      Callbacks
      Promises
      Async/await
    Plugins
      Caching control
      URL prefixing
      Response mocking

mindmap root((SuperAgent)) What it does HTTP requests Node and browser Chained API Request features JSON body File upload Query params Syntax styles Callbacks Promises Async/await Plugins Caching control URL prefixing Response mocking

Click or tap to explore — scroll the page freely

Things people build with this

USE CASE 1

Fetch JSON from a REST API in a Node.js backend using a clean chained syntax without the raw http module.

USE CASE 2

Upload a file from a browser form to a server endpoint using the same library that handles server-side requests.

USE CASE 3

Mock HTTP responses in unit tests using a SuperAgent plugin so tests never hit real external APIs.

Tech stack

JavaScriptNode.js

Getting it running

Difficulty · easy Time to first run · 5min

License not mentioned in the explanation.

In plain English

SuperAgent is a small library that helps JavaScript code make HTTP requests, which is how programs talk to web servers to fetch data, submit forms, send JSON, upload files, and so on. It works in two environments from a single, consistent interface: inside Node.js (server-side JavaScript) and inside web browsers. The browser-ready bundle is around 50 KB once minified and compressed. You write requests in a chained style: pick the HTTP verb you want (get, post, put, delete), set headers, attach a JSON body, add query parameters, and then either pass a callback or await the result like a promise. The same code works with old-style callbacks.then/.catch promises, or modern async/await syntax, so it fits whatever pattern a project is already using. In the browser it can be loaded with a plain script tag from common CDNs (jsdelivr or unpkg), or imported through a bundler such as browserify, webpack, or rollup. On the server it installs from npm or yarn. The library is extensible through plugins, which attach to a request with a .use() call and can do things like prevent caching, prefix URLs, mock out responses for tests, throttle requests, sign AWS requests, measure timings, or convert response payloads into different shapes. A long list of community plugins is included in the README. Someone would reach for SuperAgent when they want a single HTTP client with a friendly chained API that works the same in Node.js and the browser, rather than mixing browser fetch with a separate server-side library. It supports Node 14.18 and up, and a wide range of modern browser versions, with a recommended polyfill for older browsers lacking WeakRef or BigInt. The full README is longer than what was provided.

Copy-paste prompts

Prompt 1

Show me how to make a POST request with a JSON body and custom Authorization header using SuperAgent in Node.js.

Prompt 2

Write a SuperAgent request that uploads a file, checks for a 401 response, and retries with a refreshed auth token.

Prompt 3

Create a SuperAgent plugin that prefixes every request URL with a configurable base URL for use across an entire project.

Prompt 4

Use SuperAgent with async/await to fetch paginated data from an API and collect all pages into a single array.

Prompt 5

How do I load SuperAgent in a browser with a plain script tag and make a GET request to a public JSON API?

Open on GitHub → Explain another repo

← forwardemail on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.