Jest – Painless JavaScript Testing

http://facebook.github.io/jest/index.html

by vjeux • 12 years ago

168 51 12 years ago

facebook.github.io

chenglou• 12 years ago

Shorter feedback loop is always great. Running tests in parallel is a non-brainer.

Leveraging Jasmine is great too. Glad to see it's not reinventing the wheel!

Here's another interesting part, on dependency injection: http://facebook.github.io/jest/docs/common-js-testing.html#c...

caiob• 12 years ago

It's great that they're improving an existing/familiar tool like Jasmine. Also, I love the way they treat CommonJS modules.

nawitus2• 12 years ago

I would've built Jest on top of Mocha. It's a slightly better testing framework, especially when it comes to async tests.

joshuacc• 12 years ago

In what way? Jasmine 2.0 introduced Mocha-style done() for async tests.

vjeux3• 12 years ago

Mock functions are a really powerful tool. They let you test asynchronous functions in an entirely synchronous way. Because of that, Jest doesn't need to provide special support for asynchronous testing

http://facebook.github.io/jest/docs/tutorial.html#content

jeffmo9• 12 years ago

At some point I'd like to add support for using mocha within Jest as well.

Right now we use jasmine internally, so I was pretty focused on getting it running with that. However, it is (quite intentionally) built such that the 'jasmine' parts are pretty isolated similar to a plug-in; So it should be possible to build plug-ins for other frameworks like Mocha as well at some point.

pajtai• 12 years ago

Wish all it was was a mocking library... w/o the testing built in.

That way you could use it easily with Mocha (and should, etc).

jeffmo9• 12 years ago

(Hi, I'm the fb eng who wrote Jest)

Yea, I'd really like to add support for other testing frameworks as well.

glenjamin• 12 years ago

This looks really neat, having to re-specify the interface of the collaborators is generally a bunch of boilerplate you don't want to need!

Did you consider building on top of Sinon.JS and only having jest do the require/detect/build-mock part? Your mock API seems very similar.

waterfowl• 12 years ago

this is awesome. thank you for your work.

skeeterbug2• 12 years ago

Any plans to support AMD or just commonjs?

chadhietala2• 12 years ago

You might want to look at http://www.venusjs.org/ to get some ideas for supporting multiple testing frameworks. It uses an annotation approach kind of how you include files for tests. The automatic mocking is pretty awesome though.

jestar_jokin• 12 years ago

Have you looked at JsMockito?

TimJRobinson• 12 years ago

I use sinon (function mocking) and proxyquire (mock requires) for mocking with mocha and they work well.

polskibus• 12 years ago

Resharper added jasmine support in v.7 as far as I remember. I wonder if Jest would work with Resharper out of the box, would be helpful in .NET world to have the Jest runner integrated with VS.

spicyj2• 12 years ago

As someone who's become a React core contributor since React was released a year ago and had the opportunity to work with a handful of people from the Facebook frontend team, I want to say that I'm really impressed with the quality of the JavaScript libraries that Facebook has released. React is the obvious big one, but other smaller projects like regenerator and jstransform are awesome too. I'm excited to see Jest join the party.

Congrats guys. :)

rmrfrmrf• 12 years ago

Wow, Facebook has been rocking the house lately with their JS contributions. Great work and thank you!

nlh3• 12 years ago

Sorry for the dumb question, but as a JS (and JS testing) newbie, could someone explain how Jest is different from Jasmine (from which it's built on) or, say, from Mocha?

vjeux3• 12 years ago

Jasmine provides you with the testing primitives such as describe(), it(), expect(value).toEqual(other): http://facebook.github.io/jest/docs/api.html#globally-inject...

Jest adds multiple layers on-top:

- A mock library (also called stubs) in order to create fake functions and assert that they are called as you want: http://facebook.github.io/jest/docs/mock-functions.html#cont...

- A way to provide an alternate implementation for dependencies using require(): http://facebook.github.io/jest/docs/common-js-testing.html#c...

- It inspects the shape of your dependencies and return a mocked version of them: http://facebook.github.io/jest/docs/automatic-mocking.html#c...

- Finally, it works in node instead of the browser and uses jsdom to let you test code related to the DOM. (It also runs tests in parallel)

jeffmo9• 12 years ago

jinx!

nlh3• 12 years ago

Many thanks! (to both of you ;)

kumar303• 12 years ago

Can someone copy/paste this into the docs? :) It was really helpful, thanks.

jeffmo9• 12 years ago

jasmine and mocha are test frameworks (they're the things that supply your describe() and it() functions), but they don't really supply you with everything you need to get set up to run tests.

jest is a test runner that includes a few additional things to try to make all aspects of writing and running tests a little easier...such as:

* Searches for tests to find + execute so that you can put tests near the modules they are testing

* Runs tests in parallel processes so that your test runs finish sooner

* Replace's node's built-in require() function with a custom one that acts almost entirely the same -- except (by default) it returns mocked versions of modules (rather than the real things) when your tests run

* Gives you a fake DOM implementation (using jsdom) so that you can test code that depends on DOM APIs on the command line without having to boot up a browser

nlh3• 12 years ago

Fantastic. Great answer and now much clearer to me. Thanks! (both of you ;)

tieTYT• 12 years ago

Nice. When will there be a grunt plugin for it? I'm using the qunit plugin right now and I notice that it's 10x slower to run than viewing it in the browser. This 10 second feedback loop is driving me crazy.

jeffmo9• 12 years ago

BTW, I've updated the main page of the site to give some more context here -- thanks for asking the question!

elwell• 12 years ago

I wonder if they are using CoffeeScript anywhere at Facebook?

http://facebook.github.io/jest/docs/tutorial-coffeescript.ht...

vjeux3• 12 years ago

We're not using CoffeeScript inside of Facebook. But we are using many ES6 features that make JS look a lot like CoffeeScript such as classes, arrow functions, rest arguments, destructuring assignment ... I figured that CoffeeScript would be a good example to show that Jest supports languages that transpile to JS :)

skeeterbug2• 12 years ago

Curious - What are you using to transpile your ES6? Traceur?

jamesgpearce• 12 years ago

Actually our recent shortcuts-for-framer project happens to use CoffeeScript, but this is very much an outlier. https://github.com/facebook/shortcuts-for-framer

peteratt2• 12 years ago

Might be a silly question, but has anyone tried Jest along with AngularJS and survived to tell the story? Mocking stuff has always been one of my biggest pain points when testing on Angular and I'm really itching to try this! Congrats folks at Facebook.

rquantz• 12 years ago

Agreed on that count. Have you come up with any good solutions for angular? I always feel like my tests end up with too much boilerplate.

camus22• 12 years ago

Explain me how mocking is difficult with Angular? when Angular has a mocking framework.

peteratt2• 12 years ago

Where did I say "difficult"? I said "pain point", which is different. In my experience, same as your sibling comment, you end up having a lot of boilerplate and it's just convoluted. Mocking out stuff should be simpler, in my opinion. How about auto-generating Jasmine spies, for example?

yazaddaruvala2• 12 years ago

Is it just me, or does having the background tinted red make you anxious too?

spicyj2• 12 years ago

I toned it down a little bit -- hope that helps. :)

saraid216• 12 years ago

What it really needs is a GIF of Harley Quinn dancing in the background.

(This is a joke. Please don't do it.)

yazaddaruvala2• 12 years ago

Yeah it does. Thanks

etrinh• 12 years ago

This looks cool. Manual mocking has always been, if not a pain, a major annoyance.

On a side note, I got a good chuckle from the "Bobby Tables" XKCD reference[1] in the Jest tutorial[2].

[1] http://xkcd.com/327/ [2]: http://facebook.github.io/jest/docs/tutorial.html

camus22• 12 years ago

I think auto mocking modules is the most horrible trick a testing framework can pull.

So because you're too lazy to write modules with a minimum of sane dependency injection,you hack require (which is not dependency injection) to mock dependencies?

This is actually the most awfull anti pattern i've seen in javascript land yet.Unfortunatly, it's becoming the "way to go" for most developpers. Instead of making your modules pluggable and decoupled,you negates everything testing is for,you just dont write testable code.

ericclemmons• 12 years ago

This isn't so bad. Before DI got popular in PHP via Symfony2, we used Zend_Registry. "require" is pretty much the same thing in this context.

oldmanjay• 12 years ago

what is the effective difference between mocking an injected dependency and a located one?

Cthulhu_• 12 years ago

Looks interesting: the test suite for our current AngularJS project is slowly slowing down, in part because there's just more tests, but the major performance bottlenecks are:

* No parallelisation, even if test suites are all independent * DOM tests, which cause a lot of GC pauses * (probably) PhantomJS startup and initialisation (not measured)

I've done a simple optimization where my tests get split in the middle and run in two separate terminals (during development, continuous testing), but it's kinda iffy.

Jest – Painless JavaScript Testing

Related Stories