npm i grab-url          # ~5 kB gzipped, zero dependencies, no install scripts

GRAB: Generate Request to API from Browser

GRAB is the FBEST Request Manager: Functionally Brilliant, Elegantly Simple Tool — One Function, no dependencies, minimalist syntax, more features than alternatives

Requests & Data

Send anything, get back parsed data — no boilerplate per content type.

• Auto-JSON Convert: Pass parameters and get response or error in JSON, handling other data types as is.
• Auto-Unzip: Automatically extracts ZIP responses into { data: { filename: content } } using archiver-web. Set unzip: false to disable. Import from grab-url/full — see Slim by default.
• DOM Parsing: Automatically parses HTML responses. Pass parseDOM: "selector" for CSS selector extraction or parseDOM: false to disable. Uses linkedom. Import from grab-url/full — see Slim by default.
• Request Stategies: 🎯 Examples show common stategies like debounce, repeat, proxy, unit tests, interceptors, file upload, etc
• Runtime Support: 🛡️ Runtime support & behavior contract lists what each runtime (browsers, Node, Bun, Deno, Workers, SSR) needs, what CI verifies there, the GrabError codes and plugin lifecycle, and the known quirks

Reliability & Traffic Control

Keep flaky networks and click-happy users from cascading into your API.

• Cancel Duplicates: Prevent this request if one is ongoing to same path & params, or cancel the ongoing request.
• Timeout & Retry: Customizable request timeout, default 30s, and auto-retry on error
• Regrab On Error: Regrab on timeout error, or on window refocus, or on network change, or on stale data.
• Rate Limiting: Built-in rate limiting to prevent multi-click cascading responses, require to wait seconds between requests.
• Repeat: Repeat request this many times, or repeat every X seconds to poll for updates.

Performance & UI State

Fewer round trips, and loading state your components can bind to directly.

• isLoading Status: Sets .isLoading=true on the pre-initialized response object so you can show a "Loading..." in any framework
• Frontend Cache: Set cache headers and retrieve from frontend memory for repeat requests to static data.
• Pagination Infinite Scroll: Built-in pagination for infinite scroll to auto-load and merge next result page, with scroll position recovery.
• Loading Icons: Import from grab-url/icons to get enhanced animated loading icons, including the quantum sphere — an interactive 3D orbital loader for React and Svelte that re-rolls its own colors and collapses each ring you hover: import QuantumOrbital from 'grab-url/icons/quantum-sphere'.

Testing & Debugging

See every request, fake the ones you don't have yet, and assert on the rest.

• Mock Server Support: Configure window.grab.mock for development and testing environments
• DevTools: Ctrl+Alt+I overlays webpage with devtools showing all requests and responses, timing, and JSON structure.
• Debug Logging: Adds global log() and prints colored JSON structure, response, timing for requests in test.
• Request History: Stores all request and response data in global grab.log object

Setup & Integration

Drop it into any stack, any runtime, or generate a whole client from a spec.

• Agent Skill Install the skill into any agent (Claude, Cursor, Gemini, Codex, Antigravity, etc.) with one command: npx skills add vtempest/GRAB-URL@use-grab-request. Or copy SKILL.md into ~/.claude/skills/use-grab-request/SKILL.md.
• Globals: Adds to window in browser or global in Node.js so you only import once: grab(), log(), grab.log, grab.mock, grab.defaults
• Base URL Based on Environment: Configure grab.defaults.baseURL once at the top, overide with SERVER_API_URL in .env.
• Framework Agnostic: Alternatives like TanStack work only in component initialization and depend on React & others.
• OpenAPI SDKs: Generate a typed client from any OpenAPI spec with Hey API and have it send requests with grab instead of axios: npx api2client ./openapi.yaml ./src/client. Every endpoint gets caching, retries, rate limiting, dedupe and mocks.

Slim by default

import grab from "grab-url" gives you the slim build: about 5 kB gzipped, zero dependencies, nothing lazily reachable that you did not ask for. That is every feature above except the two that need a heavy library — ZIP extraction and HTML/DOM parsing.

Those two live one subpath away:

import grab from "grab-url";        // default — ~5 kB gzipped
import grab from "grab-url/full";   // + `unzip` and `parseDOM`

grab-url/full adds linkedom (~174 kB) and the archive extractor, both behind lazy imports, so they download only when a response actually needs one of them. grab-url/slim still resolves, as an alias of the default — it is the identical module, so a stub on grab.mock registered through either specifier is visible to the other.

The CLI is its own package, grab-url-cli. Installing the library runs no install script and pulls nothing down.

The three packages

Package	Gives you	Pick it when
grab-url	grab(), log(), plus grab-url/animations (~25 tree-shakable SVG spinners) and grab-url/icons/quantum-sphere (a 3D React/Svelte loader)	You want the request client and the loading UI
grab-api.js	grab() and log() — the same core, same /full subpath, nothing else	You only want the request client
grab-url-cli	the grab-url / grab / g commands	You want the terminal downloader

grab-url and grab-api.js are built from the same source, so install one, not both — a project holding both ends up with two grab() modules, two grab.mock registries and two caches, and a stub registered on one is invisible to the other.

Examples

CLI File Downloader — npm i -g grab-url-cli, or just npx grab-url (no install)

npx grab-url https://releases.ubuntu.com/24.04.2/ubuntu-24.04.2-live-server-amd64.iso

# 700+ media sites are detected by domain and pulled with yt-dlp, which
# installing grab-url-cli fetches for you
npx grab-url "https://www.youtube.com/watch?v=VIDEO_ID"
npx grab-url https://soundcloud.com/artist/track -a mp3

# SFTP, torrents and magnet links (needs aria2c installed)
npx grab-url sftp://user@host/srv/backup.tar.gz --password hunter2
npx grab-url "magnet:?xt=urn:btih:HASH" -d ./downloads

# Archive a page into ./<Page Title>/ - article, cite, transcript and any video
# (needs `npm i -g extract-webpage`; the video step needs yt-dlp)
npx grab-url https://example.com/article --page

# Detach and keep going in the background; Ctrl+C on any transfer offers the same
npx grab-url https://example.com/big.iso --background
npx grab-url --jobs

import grab from 'grab-url';

let res = $state({}) as {
  results: Array<{title:string}>,
  isLoading: boolean,
  error: string,
};

await grab('search', {
  response: res,
  query: "search words",
  post: true
})

grab('user').then(log)

// Auto-extract ZIP files
const zipData = await grab('https://example.com/archive.zip', { 
  unzip: true 
})
// { data: { "file1.txt": "content...", "file2.js": "..." } }

// Parse HTML and extract elements
const title = await grab('https://example.com', { 
  parseDOM: 'h1' 
})
// { data: "Page Title" }

//in svelte component
{#if res.results}
    {res.results}
{:else if res.isLoading}
    ...
{:else if res.error}
    {res.error}
{/if}

 //Setup Mock testing server, response is object or function
 window.grab.mock["search"] = {
   response: (params) => {
     return { results: [{title:`Result about ${params.query}`}] };
   },
   method: "POST"
 };

 //set defaults for all requests
 grab("", {
   setDefaults: true,
   baseURL: "http://localhost:8080",
   timeout: 30,
   debug: true,
   rateLimit: 1,
   cache: true,
   cancelOngoingIfNew: true,
 });

 grab.defaults.baseURL = "http://localhost:8080/api/";

Screenshots

Animated SVG Loading Icons with Customizable Colors

Quantum Sphere Loader — live demo

Screencast_20251208_051849.mp4

Set Types for Tooltips on Request & Response

Debug Colorized log(JSON)

Comparison of HTTP Request Libraries

Feature	GRAB	Axios	TanStack Query	SWR	Alova	SuperAgent	Apisauce	Ky
Size	✅ 4KB	❌ 13KB	❌ 39KB	✅ 4.2KB	✅ 4KB	❌ 19KB	❌ 15KB (with axios)	✅ 4KB
Zero Dependencies	✅ Yes	❌ No	❌ No	❌ No	✅ Yes	❌ No	❌ Needs Axios	✅ Yes
isLoading State Handling	✅ Auto-managed	❌ Manual	✅ Yes	✅ Yes	✅ Yes	❌ Manual	❌ Manual	❌ Manual
Auto JSON Handling	✅ Automatic	✅ Configurable	❌ Manual	❌ Manual	✅ Automatic	✅ Automatic	✅ Automatic	✅ Automatic
Request Deduplication	✅ Built-in	❌ No	✅ Yes	✅ Yes	✅ Yes	❌ No	❌ No	❌ No
Caching	✅ Multi-level	❌ No	✅ Advanced	✅ Advanced	✅ Multi-level	❌ No	❌ No	❌ No
Mock Testing	✅ Easy setup	❌ Needs MSW/etc	❌ Needs MSW/etc	❌ Needs MSW/etc	⚠️ Basic	❌ Needs separate lib	❌ Needs separate lib	❌ Needs MSW/etc
Rate Limiting	✅ Built-in	❌ Manual	❌ Manual	❌ Manual	⚠️ Basic	❌ Manual	❌ Manual	❌ Manual
Automatic Retry	✅ Configurable	⚠️ Via interceptors	✅ Built-in	✅ Built-in	✅ Built-in	✅ Built-in	❌ Manual	✅ Built-in
Request Cancellation	✅ Auto + manual	✅ Manual	✅ Automatic	✅ Automatic	✅ Manual	✅ Manual	✅ Manual	✅ Manual
Pagination Support	✅ Infinite scroll	❌ Manual	✅ Advanced	⚠️ Basic	✅ Built-in	❌ Manual	❌ Manual	❌ Manual
Interceptors	✅ Advanced	✅ Advanced	⚠️ Limited	⚠️ Limited	✅ Advanced	✅ Plugins	✅ Transforms	✅ Hooks system
Debug Logging	✅ Colored output	⚠️ Basic	✅ DevTools	✅ DevTools	⚠️ Basic	⚠️ Basic	⚠️ Basic	⚠️ Basic
Request History	✅ Built-in	❌ Manual	✅ DevTools	✅ DevTools	❌ Manual	❌ Manual	❌ Manual	❌ Manual
Easy Syntax	✅ Minimal	⚠️ Medium	❌ High	❌ High	⚠️ Medium	⚠️ Medium	✅ Low	✅ Minimal

Stop trying to make fetch happen! *

Why fetch things when you can just GRAB?

Debugging requests is a bitch. Make the switch!

🌟 Star this repo so it will grow and get updates!