@f1stnpm2/ducimus-incidunt-natus

1.0.0 • Public • Published

@f1stnpm2/ducimus-incidunt-natus 🔬💥

GitHub Actions Workflow Status types npm bundle size NPM Downloads

@f1stnpm2/ducimus-incidunt-natus is a tiny, widely-supported, zero-dependency alternative to invariant.

@f1stnpm2/ducimus-incidunt-natus - when every byte counts!

What is invariant?

An invariant function takes a value, and if the value is falsy then the invariant function will throw. If the value is truthy, then the function will not throw.

import invariant from '@f1stnpm2/ducimus-incidunt-natus';

invariant(truthyValue, 'This should not throw!');

invariant(falsyValue, 'This will throw!');
// Error('Invariant violation: This will throw!');

Why @f1stnpm2/ducimus-incidunt-natus?

The library: invariant supports passing in arguments to the invariant function in a sprintf style (condition, format, a, b, c, d, e, f). It has internal logic to execute the sprintf substitutions. The sprintf logic is not removed in production builds. @f1stnpm2/ducimus-incidunt-natus has dropped all of the code for sprintf logic and instead encourages consumers to leverage template literals for message formatting.

invariant(condition, `Hello, ${name} - how are you today?`);

Error Messages

@f1stnpm2/ducimus-incidunt-natus allows you to pass a string message, or a function that returns a string message. Using a function that returns a message is helpful when your message is expensive to create.

import invariant from '@f1stnpm2/ducimus-incidunt-natus';

invariant(condition, `Hello, ${name} - how are you today?`);

// Using a function is helpful when your message is expensive
invariant(value, () => getExpensiveMessage());

When process.env.NODE_ENV is set to production, the message will be replaced with the generic message Invariant failed.

Type narrowing

@f1stnpm2/ducimus-incidunt-natus is useful for correctly narrowing types for flow and typescript

const value: Person | null = { name: 'Alex' }; // type of value == 'Person | null'
invariant(value, 'Expected value to be a person');
// type of value has been narrowed to 'Person'

API: (condition: any, message?: string | (() => string)) => void

  • condition is required and can be anything
  • message optional string or a function that returns a string (() => string)

Installation

# yarn
yarn add @f1stnpm2/ducimus-incidunt-natus

# npm
npm install @f1stnpm2/ducimus-incidunt-natus --save

Dropping your message for kb savings!

Big idea: you will want your compiler to convert this code:

invariant(condition, 'My cool message that takes up a lot of kbs');

Into this:

if (!condition) {
  if ('production' !== process.env.NODE_ENV) {
    invariant(false, 'My cool message that takes up a lot of kbs');
  } else {
    invariant(false);
  }
}

Your bundler can then drop the code in the "production" !== process.env.NODE_ENV block for your production builds to end up with this:

if (!condition) {
  invariant(false);
}

Builds

  • We have a es (EcmaScript module) build
  • We have a cjs (CommonJS) build
  • We have a umd (Universal module definition) build in case you needed it

We expect process.env.NODE_ENV to be available at module compilation. We cache this value

That's it!

🤘

Readme

Keywords

Package Sidebar

Install

npm i @f1stnpm2/ducimus-incidunt-natus

Weekly Downloads

0

Version

1.0.0

License

MIT

Unpacked Size

22.1 kB

Total Files

10

Last publish

Collaborators

  • sinhatminh11