diff options
Diffstat (limited to 'test/test-pages/001/expected.html')
| -rw-r--r-- | test/test-pages/001/expected.html | 92 |
1 files changed, 63 insertions, 29 deletions
diff --git a/test/test-pages/001/expected.html b/test/test-pages/001/expected.html index fa8ffd2..bf3075c 100644 --- a/test/test-pages/001/expected.html +++ b/test/test-pages/001/expected.html @@ -1,24 +1,41 @@ - <section> - <p><strong>So finally you're <a href="http://fakehost/code/2013/testing-frontend-javascript-code-using-mocha-chai-and-sinon/">testing your frontend JavaScript code</a>? Great! The more you +<section><p><strong>So finally you're <a href="/code/2013/testing-frontend-javascript-code-using-mocha-chai-and-sinon/">testing your frontend JavaScript code</a>? Great! The more you write tests, the more confident you are with your code… but how much precisely? That's where <a href="http://en.wikipedia.org/wiki/Code_coverage">code coverage</a> might -help.</strong> </p> - <p>The idea behind code coverage is to record which parts of your code (functions, statements, conditionals and so on) have been executed by your test suite, to compute metrics out of these data and usually to provide tools for navigating and inspecting them.</p> - <p>Not a lot of frontend developers I know actually test their frontend code, and I can barely imagine how many of them have ever setup code coverage… Mostly because there are not many frontend-oriented tools in this area I guess.</p> - <p>Actually I've only found one which provides an adapter for <a href="http://visionmedia.github.io/mocha/">Mocha</a> and actually works…</p> - <blockquote class="twitter-tweet tw-align-center"> - <p>Drinking game for web devs: - <br/>(1) Think of a noun - <br/>(2) Google "<noun>.js" - <br/>(3) If a library with that name exists - drink</p>— Shay Friedman (@ironshay) <a href="https://twitter.com/ironshay/statuses/370525864523743232">August 22, 2013</a> </blockquote> - <p><strong><a href="http://blanketjs.org/">Blanket.js</a></strong> is an <em>easy to install, easy to configure, +help.</strong> + </p> + <p>The idea behind code coverage is to record which parts of your code (functions, + statements, conditionals and so on) have been executed by your test suite, + to compute metrics out of these data and usually to provide tools for navigating + and inspecting them.</p> + <p>Not a lot of frontend developers I know actually test their frontend code, + and I can barely imagine how many of them have ever setup code coverage… + Mostly because there are not many frontend-oriented tools in this area + I guess.</p> + <p>Actually I've only found one which provides an adapter for <a href="http://visionmedia.github.io/mocha/">Mocha</a> and + actually works…</p> + <blockquote class="twitter-tweet tw-align-center"> + <p>Drinking game for web devs: + <br></br>(1) Think of a noun + <br></br>(2) Google "<noun>.js" + <br></br>(3) If a library with that name exists - drink</p>— Shay Friedman (@ironshay) + <a href="https://twitter.com/ironshay/statuses/370525864523743232">August 22, 2013</a> + </blockquote> + <p><strong><a href="http://blanketjs.org/">Blanket.js</a></strong> is an <em>easy to install, easy to configure, and easy to use JavaScript code coverage library that works both in-browser and -with nodejs.</em> </p> - <p>Its use is dead easy, adding Blanket support to your Mocha test suite is just matter of adding this simple line to your HTML test file:</p> <pre><code><script src="vendor/blanket.js" +with nodejs.</em> + </p> + <p>Its use is dead easy, adding Blanket support to your Mocha test suite + is just matter of adding this simple line to your HTML test file:</p> +<pre><code><script src="vendor/blanket.js" data-cover-adapter="vendor/mocha-blanket.js"></script> </code></pre> - <p>Source files: <a href="https://raw.github.com/alex-seville/blanket/master/dist/qunit/blanket.min.js">blanket.js</a>, <a href="https://raw.github.com/alex-seville/blanket/master/src/adapters/mocha-blanket.js">mocha-blanket.js</a> </p> - <p>As an example, let's reuse the silly <code>Cow</code> example we used <a href="http://fakehost/code/2013/testing-frontend-javascript-code-using-mocha-chai-and-sinon/">in a previous episode</a>:</p> <pre><code>// cow.js + + <p>Source files: <a href="https://raw.github.com/alex-seville/blanket/master/dist/qunit/blanket.min.js">blanket.js</a>, + <a href="https://raw.github.com/alex-seville/blanket/master/src/adapters/mocha-blanket.js">mocha-blanket.js</a> + </p> + <p>As an example, let's reuse the silly <code>Cow</code> example we used + <a href="/code/2013/testing-frontend-javascript-code-using-mocha-chai-and-sinon/">in a previous episode</a>:</p> +<pre><code>// cow.js (function(exports) { "use strict"; @@ -36,7 +53,9 @@ with nodejs.</em> </p> }; })(this); </code></pre> - <p>And its test suite, powered by Mocha and <a href="http://chaijs.com/">Chai</a>:</p> <pre><code>var expect = chai.expect; + + <p>And its test suite, powered by Mocha and <a href="http://chaijs.com/">Chai</a>:</p> +<pre><code>var expect = chai.expect; describe("Cow", function() { describe("constructor", function() { @@ -59,7 +78,10 @@ describe("Cow", function() { }); }); </code></pre> - <p>Let's create the HTML test file for it, featuring Blanket and its adapter for Mocha:</p> <pre><code><!DOCTYPE html> + + <p>Let's create the HTML test file for it, featuring Blanket and its adapter + for Mocha:</p> +<pre><code><!DOCTYPE html> <html> <head> <meta charset="utf-8"> @@ -81,14 +103,26 @@ describe("Cow", function() { </body> </html> </code></pre> - <p><strong>Notes</strong>:</p> - <ul> - <li>Notice the <code>data-cover</code> attribute we added to the script tag loading the source of our library;</li> - <li>The HTML test file <em>must</em> be served over HTTP for the adapter to be loaded.</li> - </ul> - <p>Running the tests now gives us something like this:</p> - <p> <img alt="screenshot" src="http://fakehost/static/code/2013/blanket-coverage.png"/> </p> - <p>As you can see, the report at the bottom highlights that we haven't actually tested the case where an error is raised in case a target name is missing. We've been informed of that, nothing more, nothing less. We simply know we're missing a test here. Isn't this cool? I think so!</p> - <p>Just remember that code coverage will only <a href="http://codebetter.com/karlseguin/2008/12/09/code-coverage-use-it-wisely/">bring you numbers</a> and raw information, not actual proofs that the whole of your <em>code logic</em> has been actually covered. If you ask me, the best inputs you can get about your code logic and implementation ever are the ones issued out of <a href="http://www.extremeprogramming.org/rules/pair.html">pair programming</a> sessions and <a href="http://alexgaynor.net/2013/sep/26/effective-code-review/">code reviews</a> — but that's another story.</p> - <p><strong>So is code coverage silver bullet? No. Is it useful? Definitely. Happy testing!</strong> </p> - </section>
\ No newline at end of file + + <p><strong>Notes</strong>:</p> + <ul><li>Notice the <code>data-cover</code> attribute we added to the script tag + loading the source of our library;</li> + <li>The HTML test file <em>must</em> be served over HTTP for the adapter to + be loaded.</li> + </ul><p>Running the tests now gives us something like this:</p> + <p> + <img alt="screenshot" src="/static/code/2013/blanket-coverage.png"></img></p> + <p>As you can see, the report at the bottom highlights that we haven't actually + tested the case where an error is raised in case a target name is missing. + We've been informed of that, nothing more, nothing less. We simply know + we're missing a test here. Isn't this cool? I think so!</p> + <p>Just remember that code coverage will only <a href="http://codebetter.com/karlseguin/2008/12/09/code-coverage-use-it-wisely/">bring you numbers</a> and + raw information, not actual proofs that the whole of your <em>code logic</em> has + been actually covered. If you ask me, the best inputs you can get about + your code logic and implementation ever are the ones issued out of <a href="http://www.extremeprogramming.org/rules/pair.html">pair programming</a> +sessions + and <a href="http://alexgaynor.net/2013/sep/26/effective-code-review/">code reviews</a> — + but that's another story.</p> + <p><strong>So is code coverage silver bullet? No. Is it useful? Definitely. Happy testing!</strong> + </p> + </section>
\ No newline at end of file |