Skip to main content

​
getProfiles()

Get a list of all available browser profile labels.

​
Signature

function getProfiles(): BrowserProfile[]

​
Returns

Array of profile names that can be used with the browser option.

​
Example

import { getProfiles } from 'wreq-js';

const profiles = getProfiles();
console.log(profiles);
// Example output: ['chrome_142', 'firefox_139', 'safari_18', ...]

​
Using a random profile

import { fetch, getProfiles } from 'wreq-js';

const profiles = getProfiles();
const randomProfile = profiles[Math.floor(Math.random() * profiles.length)];

const response = await fetch('https://example.com', {
  browser: randomProfile,
});

​
getOperatingSystems()

Get a list of all available operating systems for emulation.

​
Signature

function getOperatingSystems(): EmulationOS[]

​
Returns

Array of OS names that can be used with the os option.

​
Example

import { getOperatingSystems } from 'wreq-js';

const systems = getOperatingSystems();
console.log(systems);
// Example output: ['windows', 'macos', 'linux', 'android', 'ios']

​
Combining browser and OS

import { fetch, getProfiles, getOperatingSystems } from 'wreq-js';

// Chrome on Windows
const response = await fetch('https://example.com', {
  browser: 'chrome_142',
  os: 'windows',
});

// Safari on iOS
const mobileResponse = await fetch('https://example.com', {
  browser: 'safari_18',
  os: 'ios',
});

​
Headers

The Headers class for working with HTTP headers.

​
Constructor

declare class Headers {
  constructor(init?: HeadersInit);
}

​
Methods

  • append(name, value): add a header value
  • delete(name): remove a header
  • get(name): get a header value
  • has(name): check if header exists
  • set(name, value): set a header value
  • entries(): iterate over header entries
  • keys(): iterate over header names
  • values(): iterate over header values

​
Example

import { fetch, Headers } from 'wreq-js';

const headers = new Headers();
headers.set('Authorization', 'Bearer token');
headers.set('Content-Type', 'application/json');

const response = await fetch('https://api.example.com', {
  browser: 'chrome_142',
  headers,
});

​
Response

The Response class representing HTTP responses.

​
Properties

  • status: HTTP status code
  • statusText: HTTP status text
  • headers: response headers
  • ok: true if status is 200-299
  • url: final URL after redirects
  • redirected: true if the response is the result of a redirect
  • body: ReadableStream<Uint8Array> or null
  • bodyUsed: true if body has been read
  • contentLength: content length from headers, or null
  • cookies: parsed response cookies as Record<string, string | string[]>

​
Methods

  • json(): parse body as JSON
  • text(): get body as string
  • arrayBuffer(): get body as ArrayBuffer
  • blob(): get body as Blob
  • formData(): parse body as FormData
  • clone(): clone the response