Skip to content

gaearon/flowcheck

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

26 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Why?

Use types annotations today, even if you don't actually use Flow (or TypeScript). Then strip the assertions in production.

Flowcheck comes with a built-in browserify transformer and supports sourcemaps for a seamless workflow integration.

You can even use Flowcheck as a general purpose validation library.

How it works?

Flowcheck adds asserts for each type annotation using jstransform.

If an assert fails the debugger kicks in so you can inspect the stack and quickly find out what's wrong.

Demo live

https://gcanti.github.io/flowcheck

Workflow

  1. Write your code adding type annotations
  2. (optional) enable the Flow static type checker
  3. enable Flowcheck.js and strip type annotations (with react-tools or 6to5) during development
  4. disable Flowcheck.js in production for zero overhead

Differences with flow

  • Flowcheck tuples are fixed-length arrays #227

Modules

  • a source transformer (transform.js)
  • a browserify transformer (index.js)
  • a runtime assertion library (assert.js)

The transformer adds assertions for each type annotation.

The assertion module checks the types at runtime. If an assert fails the debugger kicks in so you can inspect the stack and quickly find out what's wrong.

Tests

npm test

License

MIT

About

Runtime type checking for Flow

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • JavaScript 99.8%
  • CSS 0.2%