@taktikorg/iste-eveniet

v3.4.90

Published

8 days ago

@taktikorg/iste-eveniet<br> [![NPM Version](https://img.shields.io/npm/v/@taktikorg/iste-eveniet.svg?branch=main)](https://www.npmjs.com/package/@taktikorg/iste-eveniet) [![Downloads Per Week](https://img.shields.io/npm/dw/@taktikorg/iste-eveniet.svg?colo

Downloads

2,005

0High
0Medium
0Low

lechuongb878

cli deep check optimist windows Int16Array xterm three require formatting reuse from readablestream compare styled-components mocking modules ecmascript tdd node key es2016 preprocessor mru ec2 setter matchAll scheme Array.prototype.flatMap ramda 256 unicode arraybuffer ECMAScript 3 collection sns compiler tty error-handling defineProperty xhr quote persistent uninstall sorted installer bootstrap css Function.prototype.name byteLength cache speed includes jshint schema codes style ECMAScript 5 map art utils Rx curl Int8Array patch global this value trim regular expression bin Array.prototype.contains ArrayBuffer.prototype.slice subprocess invariant array BigInt64Array functions fastcopy remove expression ES2019 helper typesafe Object.assign ES2017 io-ts ECMAScript 2018 ajax lint values dataview configurable escape toobject ES5 argv Object.is handlers ECMAScript 2020 enumerable fixed-width redact functional s3 groupBy const flat electron certificates callback ES6 internal typedarrays isConcatSpreadable commander util.inspect slice live performance cjk matches config toStringTag Symbol.toStringTag fast-deep-clone tostringtag get names workflow aws arrays call json-schema nodejs animation regex signal gradients css3 fastclone joi some autoscaling dataView core asterisks filter fast-clone writable fast recursive manager __proto__data Array.prototype.findLast less compiler mobile has-own number importexport browserslist concat Observables stringify ansi encryption negative front-end pipe validate es clone [[Prototype]]less YAML spawn Float32Array logger test autoprefixer fast-copy jsdom postcss fullwidth japanese ArrayBuffer#slice serializer fps transport sameValueZero descriptor Map stringifier shell elasticache TypeScript workspace:*ES2018 prefix effect-ts internal slot streams express linux $.extend @@toStringTag zod acorn dynamodb CSS byteOffset take route53 ECMAScript 2022 equal estree accessor events Promise jsdiff optimizer directory trimRight self fs gitignore routing toArray lockfile parse ECMAScript 6 endpoint readable loadbalancing lesscss ES8 proxy Object.entries es-shim API helpers getopt pino crypt typed array variables in css ES2023 window deepclone bdd ie swf mkdir performant bundler JSON-Schema side fp create inspect dom-testing-library coercible dependency manager term ES7 settings consume typedarray environments cloudtrail accessibility getOwnPropertyDescriptor RegExp.prototype.flags scheme-validation regular-expression redux handler getintrinsic keys WeakMap time Microsoft eslintconfig user-streams tester spinners spinner metadata json getPrototypeOf collection.es6 hasOwnProperty variables progress ECMAScript prop typeof Object.keys amazon has pyyaml text flags l10n less css package manager execfile es7 AsyncIterator sqs iam protocol-buffers command-line name pose css nesting width form-validation buffers deepcopy react animation group korean symlink typeerror ts Object.fromEntries auth chrome waf Uint32Array fast-deep-copy efficient dom signals sham iterator starter touch Observable flatten route terminal drop elm moment format operating-system graphql getter upload simpledb typanion elb ES2020 ReactiveExtensions api equality execute safe function.length redirect Uint16Array drag toSorted core-js private react-testing-library assertion let Object validation css-in-js syntax eventEmitter figlet es6 protobuf Object.values fastify sharedarraybuffer setImmediate higher-order spec queueMicrotask ES classnames computed-types ebs output busy state 0 ignore merge eslint call-bind description ECMAScript 2021 syntaxerror fetch ast ECMAScript 2023 shared deterministic gradients css RFC-6455 6to5 copy findLastIndex -0 shrinkwrap async glacier URLSearchParams popmotion Uint8Array weakset worker language shim ECMAScript 2017 exit-code eslintplugin npm signed command datastructure vest BigUint64Array generics console ESnext interrupts private data gdpr reduce hardlinks tslib assign slot lru delete Float64Array stylesheet class-validator make mock less.js jest define awesomesauce robust binaries whatwg a11y zx predictable redux-toolkit string deep-clone global promise libphonenumber nope fork type ECMAScript 2015 call-bound ECMAScript 2019 offset walk Set trimStart minimal shebang diff inference serialize dayjs String.prototype.trim spring json-schema-validation environment identifiers fantasy-land toolkit child jwt ES2022 client columns point-free service phone javascript react-component util vpc native chinese System.global in WeakSet agent qs picomatch setPrototypeOf glob typed structuredClone chromium RegExp#flags HyBi last asserts symbol runtime circular pretty querystring positive function symlinks bound styleguide env forEach random fnmatch stateless types Push exec authentication emit tc39 styles find tools Object.defineProperty react-hooks local Underscore sigint error react pose curried chai Streams json-schema-validator eventDispatcher pure push monorepo file logging channel immutable JSON bcrypt WebSockets intrinsic i18n location idle emr callbound process apollo browserlist queue framer dependencies Uint8ClampedArray tacit length cloudsearch iteration set jQuery option write openssl waapi omit react-hook-form styling Object.getPrototypeOf transpile es2017 .env babel-core proto airbnb bind Iterator postcss-plugin link dotenv entries bootstrap less 3d censor beanstalk rds weakmap stable bundling sort properties ES2015 flatMap Array.prototype.includes reducer banner query css less every value ponyfill replay ajv install jsonschema rules validator es-shims path lazy trimEnd once color nested css babel CSSStyleDeclaration colour input is date classes typescript telephone mapreduce

@taktikorg/iste-eveniet

Universal WHATWG Fetch API for Node, Browsers, Workers and React Native. The scenario that @taktikorg/iste-eveniet really shines is when the same JavaScript codebase needs to run on different platforms.

Platform agnostic: browsers, Node or React Native
Optional polyfill: it's up to you if something is going to be added to the global object or not
Simple interface: no instantiation, no configuration and no extra dependency
WHATWG compliant: it works the same way wherever your code runs
TypeScript support: better development experience with types.
Worker support: works on different types of workers such as Service Workers and CloudFlare Workers

Install

npm install --save @taktikorg/iste-eveniet

As a ponyfill (imports locally):

// Using ES6 modules with Babel or TypeScript
import fetch from '@taktikorg/iste-eveniet';

// Using CommonJS modules
const fetch = require('@taktikorg/iste-eveniet');

As a polyfill (installs globally):

// Using ES6 modules
import '@taktikorg/iste-eveniet/polyfill';

// Using CommonJS modules
require('@taktikorg/iste-eveniet/polyfill');

The CDN build is also available on unpkg:

<script src="//unpkg.com/@taktikorg/iste-eveniet/dist/@taktikorg/iste-eveniet.js"></script>

This adds the fetch function to the window object. Note that this is not UMD compatible.

Usage

With promises:

import fetch from '@taktikorg/iste-eveniet';
// Or just: import '@taktikorg/iste-eveniet/polyfill';

fetch('//api.github.com/users/lquixada')
  .then(res => {
    if (res.status >= 400) {
      throw new Error("Bad response from server");
    }
    return res.json();
  })
  .then(user => {
    console.log(user);
  })
  .catch(err => {
    console.error(err);
  });

With async/await:

import fetch from '@taktikorg/iste-eveniet';
// Or just: import '@taktikorg/iste-eveniet/polyfill';

(async () => {
  try {
    const res = await fetch('//api.github.com/users/lquixada');
    
    if (res.status >= 400) {
      throw new Error("Bad response from server");
    }
    
    const user = await res.json();
  
    console.log(user);
  } catch (err) {
    console.error(err);
  }
})();

Demo & API

You can find a comprehensive doc at Github's fetch page. If you want to play with @taktikorg/iste-eveniet, check our JSFiddle playground.

Tip: Run the fiddle on various browsers and with different settings (for instance: cross-domain requests, wrong urls or text requests). Don't forget to open the console in the test suite page and play around.

FAQ

Yet another fetch library?

I did a lot of research in order to find a fetch library that could be simple, cross-platform and provide polyfill as an option. There's a plethora of libs out there but none could match those requirements.

Why polyfill might not be a good idea?

In a word? Risk. If the spec changes in the future, it might be problematic to debug. Read more about it on sindresorhus's ponyfill page. It's up to you if you're fine with it or not.

How does @taktikorg/iste-eveniet work?

Just like isomorphic-fetch, it is just a proxy. If you're in node, it delivers you the node-fetch library, if you're in a browser or React Native, it delivers you the github's whatwg-fetch. The same strategy applies whether you're using polyfill or ponyfill.