feat(skip): allow to skip tests

[wellwelwel]

You can now skip tests when necessary:

import { skip } from 'poku';

skip();

You can also pass an optional message to skip method:

import { skip } from 'poku';

skip('Skipping for some reason');

Important

This will skip the entire file and it's recommended to be used at the top of the test file.

---

Examples

Imagine that a specific test doesn't work on a specific OS:

import { test, skip } from 'poku';
import { platform } from 'node:process';

const isWindows = platform === 'win32';

if (isWindows) skip('Skipping due to incompatibility with Windows');

// Runs tests normally on other operating systems
test(() => {
  // ...
});

Note

Skipped tests are considered successful tests.