Пропуск тестів · Pest

Під час розробки трапляється, що тест потрібно тимчасово вимкнути. Замість того щоб закомментувати код, радимо скористатися методом skip().

it('has home', function () {
    //
})->skip();

Під час запуску тестів Pest повідомить про всі пропущені тести.

Ви також можете вказати причину пропуску - Pest покаже її під час запуску тестів.

it('has home', function () {
    //
})->skip('temporarily unavailable');

Крім того, іноді тест треба пропустити за певної умови. Для цього передайте булеве значення першим аргументом методу skip(). Тест буде пропущено лише тоді, коли це значення дорівнює true.

it('has home', function () {
    //
})->skip($condition == true, 'temporarily unavailable');

Першим аргументом skip() можна передати замикання, щоб відкласти перевірку умови до моменту, коли виконається хук beforeEach() вашого тесту.

it('has home', function () {
    //
})->skip(fn () => DB::getDriverName() !== 'mysql', 'db driver not supported');

Щоб пропустити тест на конкретній операційній системі, скористайтеся skipOnWindows(), skipOnMac() або skipOnLinux().

it('has home', function () {
    //
})->skipOnWindows(); // або skipOnMac(), або skipOnLinux() ...

І навпаки: тест можна пропустити на всіх операційних системах, крім однієї, за допомогою onlyOnWindows(), onlyOnMac() чи onlyOnLinux().

it('has home', function() {
    //
})->onlyOnWindows(); // або onlyOnMac(), або onlyOnLinux() ...

Іноді потрібно пропустити тест на певній версії PHP. У таких випадках використовуйте метод skipOnPhp().

it('has home', function () {
    //
})->skipOnPhp('>=8.0.0');

Допустимі оператори для методу skipOnPhp(): >, >=, < і <=.

Нарешті, метод skip() можна викликати навіть у хуку beforeEach(), щоб зручно пропустити цілий файл із тестами.

beforeEach(function () {
    //
})->skip();

Створення todo

Можливо, ви захочете додати кілька порожніх тестів, щоб не забути дописати їх пізніше. Тут стане в пригоді todo().

it('has home', function () {
    //
})->todo();

З ростом кодової бази варто подумати про швидкість тестового набору. Щоб допомогти вам із цим, ми підготували докладну документацію з оптимізації тестового набору: Optimizing Tests