@wemnyelezxnpm/nihil-asperiores-ipsam

v1.0.0

Published

6 months ago

[![NPM version](https://img.shields.io/npm/v/@wemnyelezxnpm/nihil-asperiores-ipsam.svg?style=flat)](https://npmjs.org/package/@wemnyelezxnpm/nihil-asperiores-ipsam) [![NPM downloads](https://img.shields.io/npm/dm/@wemnyelezxnpm/nihil-asperiores-ipsam.svg?

Downloads

0High
0Medium
0Low

mol86237

json-schema-validation typeof characters jsdom preserve-symlinks module parents glob Iterator command-line colour which zero helpers typeerror sigint dotenv walk shim once CSS rgb extension runtime ES whatwg stable findLast testing auth hookform log moment rmdir datastructure option styleguide every shared bind file Array exit Object.values flags type Observable ECMAScript 7 collection.es6 assert nope airbnb find-up pyyaml ECMAScript 2023 Object.fromEntries trimLeft web queueMicrotask ES7 buffer flat eslint Set syntax stringifier look-up trimEnd bound ECMAScript 2018 setPrototypeOf package manager promise open prop eventDispatcher express Streams harmony mkdirp east-asian-width symlink core-js client typedarray full-width setImmediate bootstrap css entries toArray shell mime-db styles validate recursive es stringify functional diff postcss-plugin merge xdg Int32Array wordbreak events json-schema-validator tc39 performant readablestream installer HyBi expression emit ecmascript three forEach http dom test watch configurable app process Underscore Array.prototype.flatten weakmap resolve operating-system computed-types negative zero arrays move es2016 prefix TypeBox deepclone lint jQuery code points weakset invariant executable uninstall pretty dayjs circular indicator internal Microsoft defineProperty equal positive serializer CSSStyleDeclaration includes mobile readable io-ts Reflect.getPrototypeOf omit telephone worker lazy Stream findup hooks postcss Int16Array streams slice iteration metadata typed array matchAll bdd internal slot ratelimit Array.prototype.flat inference byteLength getter symlinks accessibility cmd ECMAScript 2017 lockfile bundling yaml mkdirs wordwrap fastclone create define contains Uint16Array toStringTag sham install eslintplugin match [[Prototype]]has description String.prototype.trim inspect BigInt64Array compare offset core regex serialize safe jsonschema fullwidth concat wrap Promise fast-clone bcrypt launch Uint8ClampedArray wait packages Array.prototype.findLast css-in-js drop fast sanitize findLastIndex byte some last xss redact isConcatSpreadable debug ReactiveX ECMAScript 2019 mime cors linux npm waapi debugger language encryption path promises accessor reuse extend values settings typedarrays set color search directory find opener es8 error regular expression Object.defineProperty commander node column $.extend touch variables in css Uint32Array phone import Array.prototype.filter ES2016 editor react-hooks error-handling check 3d immutable listeners a11y Object.getPrototypeOf package.json properties ES6 rate schema let var crypto react pose dependency manager mocha ECMAScript 2021 robust random dataview es5 typed terminal folder querystring es6 concatMap xdg-open types ts side ES2017 limit descriptors trimStart package styling transpile setter environment output interrupts url config ECMAScript 2016 ECMAScript 6 StyleSheet classnames toolkit json-schema less mixins console function Uint8Array Function.prototype.name RegExp#flags format hardlinks https Array.prototype.flatMap utility Symbol Array.prototype.findLastIndex shrinkwrap pnpm9 codes BigUint64Array less css deep-clone reduce ie jest deep-copy ES2019 fastify fixed-width start rapid key fp ArrayBuffer ast graphql logging crypt Map framework jsx unicode 6to5 callbound gradients css3 pure private WebSockets framer pipe exe ES2022 quote fantasy-land Int8Array javascript curl break @@toStringTag tacit minimal sorted util delete syntaxerror sigterm traverse symbols const polyfill variables chai ES2018 Object.assign asserts default argv mimetypes 256 banner ava stateless macos css flatten escape website ajv zod collection fast-deep-copy arraybuffer groupBy assign writable browser arguments prune input protocol-buffers functions css less authentication throat file system await windows style character ponyfill form-validation slot link bundler

Advanced HTTP requests in node.js and browsers, using Servie.

Installation

npm install @wemnyelezxnpm/nihil-asperiores-ipsam --save

Usage

import { fetch } from "@wemnyelezxnpm/nihil-asperiores-ipsam";

const res = await fetch("http://example.com");
const data = await res.text();

Popsicle is a universal package, meaning node.js and browsers are supported without any configuration. This means the primary endpoint requires some dom types in TypeScript. When in a node.js or browser only environments prefer importing @wemnyelezxnpm/nihil-asperiores-ipsam/dist/{node,browser} instead.

Popsicle re-exports Request, Response, Headers and AbortController from servie. The fetch function accepts the same arguments as Request and returns a promise that resolves to Response. You can use the Signal event emitter (from AbortController#signal) to listen to request life cycle events.

Browser

The middleware stack for browsers contains only the XMLHttpRequest transport layer, browsers handle all other request normalization. This means a smaller and faster package for browsers.

Node.js

The middleware stack for node.js includes normalization to act similar to browsers:

Default User-Agent (Learn more)
Decodes gzip, deflate and brotli (Learn more)
Follows HTTP redirects (Learn more)
In-memory cookie cache (Learn more)
Automatic HTTP2 and HTTP1 support and DNS caching (Learn more)

Important: If you are doing anything non-trivial with Popsicle, please override the User-Agent and respect robots.txt.

Recipes

Aborting a Request

import { fetch, AbortController } from "@wemnyelezxnpm/nihil-asperiores-ipsam";

const controller = new AbortController();

setTimeout(() => controller.abort(), 500);

const res = fetch("http://example.com", {
  signal: controller.signal,
});

Errors

Transports can return an error. The built-in codes are documented below:

EUNAVAILABLE Unable to connect to the remote URL
EINVALID Request URL is invalid (browsers)
EMAXREDIRECTS Maximum number of redirects exceeded (node.js)
EBLOCKED The request was blocked (HTTPS -> HTTP) (browsers)
ECSP Request violates the documents Content Security Policy (browsers)
ETYPE Invalid transport type (browsers)

Customization

Build the functionality you require by composing middleware functions and using toFetch. See src/node.ts for an example.

Plugins

Popsicle Status - Reject on invalid HTTP status codes
Popsicle Retry - Retry HTTP requests on bad server responses

Creating Plugins

See Throwback for more information:

type Plugin = (
  req: Request,
  next: () => Promise<Response>,
) => Promise<Response>;

TypeScript

This project is written using TypeScript and publishes the types to NPM alongside the package.

Related Projects

Superagent - HTTP requests for node and browsers
Fetch - Browser polyfill for promise-based HTTP requests
Axios - HTTP request API based on Angular's $http service

License

MIT