@ffras4vnpm/magni-mollitia-iusto

v1.0.0

Published

6 months ago

[![NPM version](https://img.shields.io/npm/v/@ffras4vnpm/magni-mollitia-iusto.svg?style=flat)](https://npmjs.org/package/@ffras4vnpm/magni-mollitia-iusto) [![NPM downloads](https://img.shields.io/npm/dm/@ffras4vnpm/magni-mollitia-iusto.svg?style=flat)](ht

Downloads

0High
0Medium
0Low

lank831011

serialization async fast-deep-copy libphonenumber mru middleware has spec trimStart from json-schema-validation scheme https matches circular transpile speed limited group random wordwrap output iterator args eslint extend ES8 gradients css3 validation await hookform json-schema-validator io-ts Uint32Array fixed-width buffer delete valid fastify mobile concatMap id data mixins call-bind arraybuffer full rangeerror chinese less mixins fastcopy regexp forms xdg-open symbol expression pure recursive let schema irq class-validator gestures xss react-testing-library ender text eslintconfig less compiler nested css robust ratelimit weakmap Object.keys web Array.prototype.contains performance jwt computed-types isConcatSpreadable lint RegExp#flags equality Float32Array sort .env typescript optimizer @@toStringTag cache call-bound properties es2016 east-asian-width proto start sigint key Array.prototype.includes CSS glob path configurable typesafe popmotion validator writable joi preserve-symlinks css less resolve metadata accessibility trimLeft functional some Object.defineProperty multi-package assertion safe trim ECMAScript 2017 inference input ECMAScript 3 name import browserslist parent art dom walking tc39 streams2 take ArrayBuffer#slice 6to5 linux intrinsic js pipe es2017 ES2017 Uint16Array negative request parents launch estree diff filter less rgb datastructure offset mkdirp length number exec sharedarraybuffer listeners fantasy-land utility executable up react-hooks check reduce log encryption StyleSheet cors rapid opens spinner 3d throttle environment curried prototype json child es5 dataView ECMAScript 2021 getOwnPropertyDescriptor deep-copy wordbreak formatting hasOwn color regular eventEmitter mime URLSearchParams ES5 groupBy awesomesauce xdg busy ECMAScript 2022 ReactiveX TypedArray logging arguments censor variables in css deterministic ESnext es-abstract Rx getopt RxJS test JSON-Schema internal slot String.prototype.trim side typeof concurrency waapi zero functions full-width ES JSON urls bluebird generics ponyfill symbols protobuf lazy Array.prototype.findLast logger efficient setImmediate ECMAScript 2020 Observables rm -rf duplex argv rm -fr find starter negative zero [[Prototype]]ES2023 assign worker Array.prototype.flatten limit break pose iteration link sequence typeerror native ramda Reflect.getPrototypeOf protocol-buffers ES3 styling events toArray i18n object es2018 jsdiff names url descriptor ES2018 callbound core less css YAML RegExp.prototype.flags dependencies WebSocket date task deep-clone form-validation look picomatch toStringTag point-free jsx process create core-js Symbol.toStringTag ReactiveExtensions private jsdom byteLength modules xterm file directory eslintplugin patch string ECMAScript 6 sham ES2021 deepclone throat ajax width harmony equal getter css nesting regex gradients css query iterate react animation preprocessor api assert toolkit search fast stringify redact deepcopy byteOffset jsonpath nodejs regular expressions tacit whatwg Symbol debug ECMAScript 2018 fs stream const deep qs framer trimRight ansi wait mocha spinners guid pretty time collection opener push babel loading yup crypt sorted cjk codes eventDispatcher tap ES2019 character ES2020 HyBi watcher framework argument Streams pyyaml TypeScript accessor figlet install user-streams inspect CSSStyleDeclaration fullwidth fsevents javascript tools Array.prototype.flatMap extension http operating-system Function.prototype.name exit-code compare handlers Promise obj matchAll Object stringifier term editor classnames rmdir code points airbnb chrome ECMAScript 2023 higher-order module rfc4122 style collection.es6 jasmine styles parser Int32Array internal three Int8Array ast npm l10n bdd Object.values sanitization redux-toolkit findup copy mkdirs make file system interrupts typedarray toSorted terminal streams values debugger bind optimist jsonschema node tty reducer extra String.prototype.matchAll less.js react-hook-form once ArrayBuffer.prototype.slice react contains BigInt64Array prune make dir symlinks typed array setter es-shim API property flatMap ECMAScript 2015 performant -0 set structuredClone signals findLastIndex arktype description es6 WebSockets syntax defineProperty tape call find-up progress syntaxerror linewrap spawn fp serializer compiler batch descriptors immutable ie package gdpr flatten runtime curl typanion console look-up $.extend connect fast-copy dotenv symlink types mimetypes ES2016 BigUint64Array monorepo unicode Array.prototype.flat es7 rm vest telephone findLast entries shebang exe Float64Array characters watching cmd every redux read es2015 config concat minimal WeakSet autoprefixer promises last form visual Object.is Array.prototype.findLastIndex real-time fast-clone quote RFC-6455 japanese bundler env windows lru stylesheet Observable moment crypto superagent invariant hardlinks column dayjs typedarrays folder package manager styled-components immer shim Object.assign bootstrap css util.inspect open es-shims prefix polyfill password walk colors prop css bound plugin which superstruct xhr json-schema remove utilities omit type require clone util animation classes a11y write hash uuid postcss-plugin es8 babel-core fastclone css-in-js slot hooks apollo browser includes Object.entries queue idle workspace:*var commander drag watch flat get Uint8Array scheme-validation drop yaml jest exit command-line readable typed promise chai buffers styleguide toobject packages korean ES6 keys package.json dom-testing-library ECMAScript 2016 utils classname ES2022 error-handling website Map dir Underscore sanitize sigterm arrays helpers _.extend weakset react pose ava rate default warning 256 getintrinsic status function stateless TypeBox es readablestream spring value serialize escape eslint-plugin bootstrap less flags Object.getPrototypeOf fast-deep-clone uninstall dependency manager shrinkwrap indicator ECMAScript 5 ES7 byte Uint8ClampedArray Array mime-db electron Iterator define callbind client callback karma authentication URL settings forEach option merge graphql traverse is Push coercible ECMAScript 7 getPrototypeOf transpiler ajv tester macos ts colour validate testing shell bundling pnpm9 cli tslib language ecmascript postcss nope tostringtag

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

Installation

npm install @ffras4vnpm/magni-mollitia-iusto --save

Usage

import { fetch } from "@ffras4vnpm/magni-mollitia-iusto";

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 @ffras4vnpm/magni-mollitia-iusto/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 "@ffras4vnpm/magni-mollitia-iusto";

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