fetch (core_fetch)

You can use a native fetch to get some data. It's very useful to go around CORS. The core_fetch method is inspired from the Browser and NodeJS ones.

Method

export default function core_fetch: (
  url: string,
  options?: {
    headers?: Record<string, string>;
    method?: "GET" | "POST" | "PUT" | "DELETE";
    body?: string | Uint8Array;
  }
) => Promise<{
    url: string;
    headers: Record<string, string>;
    method: "GET" | "POST" | "PUT" | "DELETE";
    statusCode: number;
    statusMessage: string;
    body: Uint8Array;
  }>;
export default function core_fetch: (
  url: string,
  options?: {
    headers?: Record<string, string>;
    method?: "GET" | "POST" | "PUT" | "DELETE";
    body?: string | Uint8Array;
    encoding: "utf8";
  }
) => Promise<{
    url: string;
    headers: Record<string, string>;
    method: "GET" | "POST" | "PUT" | "DELETE";
    statusCode: number;
    statusMessage: string;
    body: string;
  }>;

export function core_fetch2(request: Request): Promise<Response>;
export function core_fetch2(url: string | URL, options?: RequestInit): Promise<Response>;

Request on MDN

Response on MDN

Example

import fs from "fs";
import core_fetch, { core_fetch2 } from "core_fetch";

// define a data file to cache some information
const cacheFile = "data/cache.json";

// if the file exists return it directly
if(await fs.exists(cacheFile))
  return fs.readFile(cacheFile, { encoding: "utf8" });

// fetch an api that block CORS request
const data = await core_fetch("https://api.com", { encoding: "utf8" });

// make it a JS object
const json = JSON.parse(data);

// cache it for later and/or offline use
await fs.writeFile(cacheFile, json);

// stream the response
const response = await core_fetch2("https://stream.com");
const reader = response.body.getReader();
let finished = false;
while(!finished) {
  const { done, value } = await reader.read();
  console.log(value);
  finished = done;
}

return json;