xdescribe vs fdescribe in jasmine

Question

• fdescribe - Execute if the spec.ts file is defined with fdescribed
• xdescribe - Never execute if spec.ts file is defined with xdescribed

Is my understand is correct? and what about if am defined both xdescribe and fdescribe in two separate spec.ts file?

Answer 1

• fdescribe - focused describe. If it exists, jasmine will run only fdescribe spec and ignore other type of describe (describe and xdescribe).
• xdescribe - disabled describe. It will never be executed.

Some scenarios to gain more understanding:

Scenario 1 - describe only

describe('test1', ..)

describe('test2', ..)

describe('test3', ..)

// Specs executed:
// test1
// test2
// test3

Scenario 2 - single fdescribe

fdescribe('test1', ..)

describe('test2', ..)

describe('test3', ..)

// Specs executed:
// test1

Scenario 3 - multiple fdescribe

fdescribe('test1', ..)

fdescribe('test2', ..)

describe('test3', ..)

// Specs executed:
// test1
// test2

Scenario 4 - single xdescribe

xdescribe('test1', ..)

describe('test2', ..)

describe('test3', ..)

// Specs executed:
// test2
// test3

Scenario 4 - multiple xdescribe

xdescribe('test1', ..)

xdescribe('test2', ..)

describe('test3', ..)

// Specs executed:
// test3

Scenario 5 - fdescribe and xdescribe exists

fdescribe('test1', ..)

xdescribe('test2', ..)

describe('test3', ..)

// Specs executed:
// test1

Beside those two, Jasmine also has fit and xit with same rules.

Interestingly, Jasmine 3 will show an error when running the test if fdescribe spec exists to prevent users from inadvertently disabled other specs.

The error message:

Incomplete: fit() or fdescribe() was found

Reference:

• https://jasmine.github.io/api/3.5/global.html#fdescribe
• https://jasmine.github.io/api/3.5/global.html#xdescribe