exFetch (Deno)

⚖️ MIT

	Heat	Release - Latest	Release - Pre
	|	()	()

A Deno module to extend fetch.

This project is inspired from:

• Deno - Standard Library - Async
• axios (GitHub)(NPM)
• jhermsmeier/node-http-link-header (GitHub)(NPM)
• node-fetch (GitHub)(NPM)
• octokit/plugin-paginate-rest.js (GitHub)(NPM)
• octokit/plugin-retry.js (GitHub)(NPM)
• sindresorhus/got (GitHub)(NPM)
• sindresorhus/ky (GitHub)(NPM)
• superagent (GitHub)(NPM)
• thlorenz/parse-link-header (GitHub)(NPM)

🌟 Feature

• Ability to cache suitable Request-Responses to reduce network usage and response time.
• Automatically retry on failure requests, preferentially obey the response header Retry-After.
• Redirect fine control.
• Simplify URL paginate requests.

🔰 Begin

Deno

• Target Version: >= v1.35.0
• Require Permission:
  • Network (allow-net):
    • Resources Domain
• Domain/Registry:
  • Deno Land

    import ... from "https://deno.land/x/exfetch[@<Tag>]/mod.ts";

  • DenoPKG

    import ... from "https://denopkg.com/hugoalh-studio/exfetch-deno[@<Tag>]/mod.ts";

  • GitHub Raw [Require Tag]

    import ... from "https://raw.githubusercontent.com/hugoalh-studio/exfetch-deno/<Tag>/mod.ts";

  • Pax

    import ... from "https://pax.deno.dev/hugoalh-studio/exfetch-deno[@<Tag>]/mod.ts";

ℹ️ Notice: Although it is recommended to import main module with path mod.ts in general, it is also able to import part of the module with sub path if available, but do not import if:

• it’s file path has an underscore prefix (e.g.: _foo.ts, _util/bar.ts), or
• it is a benchmark or test file (e.g.: foo.bench.ts, foo.test.ts), or
• it’s symbol has an underscore prefix (e.g.: export function _baz() {}).

These elements are not considered part of the public API, thus no stability is guaranteed for them.

🧩 API (Excerpt)

ℹ️ Notice: Documentation is included inside the script file, can view it via:

• Deno CLI deno doc
• Deno Doc Land

Class

• ExFetch
• HTTPHeaderLink
• HTTPHeaderRetryAfter

Function

• exFetch
• exFetchPaginate

✍️ Example

• import { exFetchPaginate } from "https://raw.githubusercontent.com/hugoalh-studio/exfetch-deno/main/exfetch.ts";
  const responses: Response[] = await exFetchPaginate("https://api.github.com/repos/microsoft/vscode/labels?per_page=100");
  
  responses.map((response: Response) => {
    return response.ok;
  }).includes(false);
  //=> false (`false` when no broken page, otherwise `true`)
  
  const result = [];
  for (const response of responses) {
    result.push(...(await response.json()));
  }
  result;
  /*=>
  [
    {
      "id": 2339554941,
      "node_id": "MDU6TGFiZWwyMzM5NTU0OTQx",
      "url": "https://api.github.com/repos/microsoft/vscode/labels/:apple:%20si",
      "name": ":apple: si",
      "color": "e99695",
      "default": false,
      "description": "Issues related to apple silicon"
    },
    {
      "id": 421131022,
      "node_id": "MDU6TGFiZWw0MjExMzEwMjI=",
      "url": "https://api.github.com/repos/microsoft/vscode/labels/*as-designed",
      "name": "*as-designed",
      "color": "E2A1C2",
      "default": false,
      "description": "Described behavior is as designed"
    },
    {
      "id": 409283388,
      "node_id": "MDU6TGFiZWw0MDkyODMzODg=",
      "url": "https://api.github.com/repos/microsoft/vscode/labels/*caused-by-extension",
      "name": "*caused-by-extension",
      "color": "E2A1C2",
      "default": false,
      "description": "Issue identified to be caused by an extension"
    },
    {
      "id": 766755777,
      "node_id": "MDU6TGFiZWw3NjY3NTU3Nzc=",
      "url": "https://api.github.com/repos/microsoft/vscode/labels/*dev-question",
      "name": "*dev-question",
      "color": "E2A1C2",
      "default": false,
      "description": "VS Code Extension Development Question"
    },
    {
      "id": 366106217,
      "node_id": "MDU6TGFiZWwzNjYxMDYyMTc=",
      "url": "https://api.github.com/repos/microsoft/vscode/labels/*duplicate",
      "name": "*duplicate",
      "color": "E2A1C2",
      "default": false,
      "description": "Issue identified as a duplicate of another issue(s)"
    },
    ... +467
  ]
  */

🔗 Other Edition

• NodeJS