Home

double-meh

double-meh is a modern, fetch-native, ESM HTTP I/O library for browsers and CLIs — a thin, DX-first layer over fetch(). Spend the effort on setup (inspectors, services, encoders) so that use stays trivial:

import io from 'double-meh';

const person = await io.get('https://api.example.com/people/42');

The name is the :// symbol — Alex Sexton's "walrus", a.k.a. a "double meh".

Search

🔍 Search this wiki — ranked, deep-linked search via wiki-search; install the bookmarklet to search in place. Fallback: GitHub wiki search.

Highlights

• The method declares the return shape. io.get(url) → parsed data; io.full.get(url) → the full response envelope; io.stream.get(url) → a ReadableStream. Options tune behavior, never the return type.
• One envelope contract — returned by io.full.* and carried by a thrown BadStatus (error.status, error.data).
• Composable services — cache and track (dedup + prefetch), both on by default for GETs, retry (verb-aware), mock — in a priority onion.
• Web-native streaming — io.stream.get for streamed responses and the io.stream.put/post/patch request/response duplexes that drop straight into a stream-chain pipeline; parsed record iteration (JSONL / json-seq) and a reconnecting SSE client on top.
• REST-correctness built in — conditional writes, idempotency keys, problem+json, content negotiation, query builders.
• Zero dependencies. ESM. Browser · Node · Bun · Deno.

Start here

• Getting started — install and your first requests.
• Core API — verbs, the callable io, io.full, io.stream, the return model.
• Requests & options — the full option reference.
• Streaming — stream, io.stream.get, the write duplexes, plus records and SSE.
• Cookbooks — practical recipes; see the sidebar (start with Basics).

Migrating from heya/io / heya/io-node? See the feature parity map.