add skip tutorial

vkarpov15 · vkarpov15 · commit ec7ae052177e · 2023-08-04T16:56:20.000-04:00
diff --git a/src/tutorials.js b/src/tutorials.js
@@ -5,6 +5,14 @@ const moment = require('moment');
 const axiosPath = require('./axiosPath');
 
 const tutorials = [
+  {
+    title: 'Using `it.skip()` in Mocha',
+    raw: './tutorials/mocha/it-skip.md',
+    url: '/tutorials/mocha/it-skip',
+    description: 'Here\'s how `it.skip()` works in Mocha',
+    tags: ['mocha'],
+    date: moment('2023-08-04')
+  },
   {
     title: 'Working with Timezones using date-fns and date-fns-tz',
     raw: './tutorials/date-fns/tz.md',
diff --git a/tutorials/mocha/it-skip.md b/tutorials/mocha/it-skip.md
@@ -0,0 +1,61 @@
+The [`it.skip()` function](https://mochajs.org/#inclusive-tests) tells Mocha to skip that particular test.
+For example, in the following code, Mocha will **not** run `test2`.
+
+```javascript
+it('test1', function() {});
+it.skip('test2', function() {});
+it('test3', function() {});
+```
+
+Running Mocha on the above file will produce the following output.
+Because test2 was skipped, Mocha will indicate that there's 1 "pending" test - "pending" tests are another word for skipped tests.
+
+```
+$ mocha ./test.js 
+
+
+  ✓ test1
+  - test2
+  ✓ test3
+
+  2 passing (4ms)
+  1 pending
+
+$ 
+```
+
+We recommend using `skip()` instead of commenting out tests.
+The benefit of using `skip()` is that Mocha can tell you when there are tests skipped via the "pending" output, whereas Mocha can't tell you when there are commented out tests.
+
+## With `describe()`
+
+`.skip()` is the inverse of [`.only()`](./run-single-test): `skip()` skips the marked test, `only()` skips every test _other than_ the marked test.
+Like `only()`, you can use `skip()` with `describe()` to skip a whole block of tests as follows.
+
+```javascript
+// Skip all tests in 'suite'
+describe.skip('suite', function() {
+  it('test1', function() {});
+  it('test2', function() {});
+});
+
+it('test3', function() {});
+```
+
+The above script produces the following output.
+
+```
+$ mocha ./test.js 
+
+
+  ✓ test3
+  suite
+    - test1
+    - test2
+
+
+  1 passing (3ms)
+  2 pending
+
+$ 
+```
