> ## Documentation Index
> Fetch the complete documentation index at: https://wreq.sqdsh.win/llms.txt
> Use this file to discover all available pages before exploring further.
# Quickstart
> Get started with wreq-js.
## Install the package
```bash npm theme={null}
npm install wreq-js
```
```bash yarn theme={null}
yarn add wreq-js
```
```bash pnpm theme={null}
pnpm add wreq-js
```
```bash bun theme={null}
bun add wreq-js
```
## 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.
```typescript theme={null}
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:
```typescript theme={null}
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
```typescript theme={null}
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?
Learn about available browser profiles and operating systems.
Understand session management and cookie isolation.
Reuse transport settings across requests (ideal per proxy).
Explore the full API documentation.
Connect to WebSocket servers with browser profile options.