Install the package
Make your first request
For multi-step flows, prefer sessions after your first request.
One-off fetch() calls use an isolated request context by default.
import { fetch } from 'wreq-js';
const response = await fetch('https://httpbin.org/get', {
browser: 'chrome_142',
});
console.log(await response.json());
Use a session for multiple requests
Sessions keep a shared session context across requests:
import { createSession } from 'wreq-js';
const session = await createSession({ browser: 'chrome_142' });
// Login
await session.fetch('https://example.com/login', {
method: 'POST',
body: new URLSearchParams({ user: 'name', pass: 'secret' }),
});
// Access authenticated endpoint in the same session context
const account = await session.fetch('https://example.com/account');
console.log(await account.text());
// Clean up
await session.close();
Use a proxy
import { fetch } from 'wreq-js';
const response = await fetch('https://example.com', {
browser: 'chrome_142',
proxy: 'http://user:pass@proxy.example.com:8080',
});
What’s next?
Browser Profiles
Learn about available browser profiles and operating systems.
Sessions
Understand session management and cookie isolation.
Transport
Reuse transport settings across requests (ideal per proxy).
API Reference
Explore the full API documentation.
WebSockets
Connect to WebSocket servers with browser profile options.