前端测试框架Jest系列教程 -- Global Functions（全局函数）
写在前面：
Jest中定义了很多全局性的Function供我们使用，我们不必再去引用别的包来去实现类似的功能，下面将列举Jest中实现的全局函数。
Jest Global Functions
afterAll(fn, timeout)
从字面意思就可以理解到它是在所有测试运行完之后才会执行的，如果你的测试中包含promise，则将会等待promise被验证之后被执行。
你还可以提供一个timeout的参数(以毫秒为单位)，用于指定在终止前等待的时间。注意:默认的超时是5秒。
如果您想要清理一些跨测试共享的全局设置状态，这通常是有用的。
const globalDatabase = makeGlobalDatabase(); function cleanUpDatabase(db) { db.cleanUp(); } afterAll(() => { cleanUpDatabase(globalDatabase); }); test('can find things', () => { return globalDatabase.find('thing', {}, results => { expect(results.length).toBeGreaterThan(0); }); }); test('can insert a thing', () => { return globalDatabase.insert('thing', makeThing(), response => { expect(response.success).toBeTruthy(); }); });
在这里，afterAll确保在所有测试运行后调用cleanUpDatabase。
如果在描述块内部，它在描述块的末尾运行。
如果你想在每次测试之后运行一些清理，而不是在所有测试之后，使用afterEach代替。
afterEach(fn, timeout)
在该文件中的每一个测试完成后运行一个函数。如果函数返回一个promise，Jest会等待该promise在继续之前解决。
你还可以提供一个超时(以毫秒为单位)，用于指定在终止前等待的时间。注意:默认的超时是5秒。
如果您想清除每个测试创建的临时状态，这通常是有用的。
const globalDatabase = makeGlobalDatabase(); function cleanUpDatabase(db) { db.cleanUp(); } afterEach(() => { cleanUpDatabase(globalDatabase); }); test('can find things', () => { return globalDatabase.find('thing', {}, results => { expect(results.length).toBeGreaterThan(0); }); }); test('can insert a thing', () => { return globalDatabase.insert('thing', makeThing(), response => { expect(response.success).toBeTruthy(); }); });
在这里，afterEach确保在每次测试运行后调用cleanUpDatabase。
如果每个都在一个描述块内，它只在这个描述块内的测试之后运行。
如果你只想在运行完所有测试之后运行一些清理工作，那么使用afterAll代替。
beforeAll(fn, timeout)
在该文件运行的任何测试之前运行一个函数。如果函数返回一个承诺，则Jest会等待在运行测试之前解决这个问题。
你还可以提供一个超时(以毫秒为单位)，用于指定在终止前等待的时间。注意:默认的超时是5秒。
如果你想设置一些将被许多测试使用的全局状态，这通常是有用的。
const globalDatabase = makeGlobalDatabase(); beforeAll(() => { // Clears the database and adds some testing data. // Jest will wait for this promise to resolve before running tests. return globalDatabase.clear().then(() => { return globalDatabase.insert({testData: 'foo'}); }); }); // Since we only set up the database once in this example, it's important // that our tests don't modify it. test('can find things', () => { return globalDatabase.find('thing', {}, results => { expect(results.length).toBeGreaterThan(0); }); });
在这里，beforeAll确保在测试运行之前建立数据库。
如果设置是同步的，那么你可以在没有以前的情况下这样做。关键是Jest将等待一个promise来解决，因此你也可以拥有异步设置。
如果beforeAll在一个描述块中，它在描述块的开始处运行。 如果你想在每次测试之前运行一些东西，而不是在任何测试之前运行，那么请在每个测试之前使用。
beforeEach(fn, timeout)
在该文件运行的每个测试之前运行一个函数。如果函数返回一个promise，Jest将等待该承诺在运行测试之前解决。
你还可以提供一个超时(以毫秒为单位)，用于指定在终止前等待的时间。注意:默认的超时是5秒。
如果你想要重置一些将被许多测试所使用的全局状态，这通常是有用的。
const globalDatabase = makeGlobalDatabase(); beforeEach(() => { // Clears the database and adds some testing data. // Jest will wait for this promise to resolve before running tests. return globalDatabase.clear().then(() => { return globalDatabase.insert({testData: 'foo'}); }); }); test('can find things', () => { return globalDatabase.find('thing', {}, results => { expect(results.length).toBeGreaterThan(0); }); }); test('can insert a thing', () => { return globalDatabase.insert('thing', makeThing(), response => { expect(response.success).toBeTruthy(); }); });
在此之前，每个测试都要重置数据库。
如果在一个描述块内部，它运行在描述块中的每个测试。
如果你只需要运行一些设置代码，在任何测试运行之前，就使用之前的所有代码。
describe(name, fn)
describe(name, fn)创建一个块，在一个“测试套件”中，将几个相关的测试组合在一起。
const myBeverage = { delicious: true, sour: false, }; describe('my beverage', () => { test('is delicious', () => { expect(myBeverage.delicious).toBeTruthy(); }); test('is not sour', () => { expect(myBeverage.sour).toBeFalsy(); }); });
这不是必需的——你可以直接在顶层编写测试块。但是，如果您希望将测试组织成组，那么这就很方便了。
const binaryStringToNumber = binString => { if (!/^[01]+$/.test(binString)) { throw new CustomError('Not a binary number.'); } return parseInt(binString, 2); }; describe('binaryStringToNumber', () => { describe('given an invalid binary string', () => { test('composed of non-numbers throws CustomError', () => { expect(() => binaryStringToNumber('abc')).toThrowError(CustomError); }); test('with extra whitespace throws CustomError', () => { expect(() => binaryStringToNumber(' 100')).toThrowError(CustomError); }); }); describe('given a valid binary string', () => { test('returns the correct number', () => { expect(binaryStringToNumber('100')).toBe(4); }); }); });
describe.only(name, fn)
如果你只想运行一次模块测试的话你可以使用 only
describe.only('my beverage', () => {
test('is delicious', () => {
expect(myBeverage.delicious).toBeTruthy();
});
test('is not sour', () => {
expect(myBeverage.sour).toBeFalsy();
});
});
describe('my other beverage', () => {
// ... will be skipped
});
describe.skip(name, fn) describe 等价于 xdescribe
你可以使用skip 跳过某一个测试
describe('my beverage', () => {
test('is delicious', () => {
expect(myBeverage.delicious).toBeTruthy();
});
test('is not sour', () => {
expect(myBeverage.sour).toBeFalsy();
});
});
describe.skip('my other beverage', () => {
// ... will be skipped
});
使用跳过通常只是一种比较简单的替代方法，如果不想运行则可以暂时将大量的测试注释掉。
require.requireActual(moduleName)
返回实际的模块而不是模拟，绕过所有检查模块是否应该接收模拟实现。
require.requireMock(moduleName)
返回一个模拟模块，而不是实际的模块，绕过所有检查模块是否正常。
test(name, fn, timeout) 等价于 it(name, fn, timeout)
在测试文件中，您所需要的是运行测试的测试方法。例如，假设有一个函数inchesOfRain()应该是零。你的整个测试可以是:
test('did not rain', () => {
expect(inchesOfRain()).toBe(0);
});
第一个参数是测试名称;第二个参数是包含测试期望的函数。第三个参数(可选)是超时(以毫秒为单位)，用于指定在中止前等待多长时间。注意:默认的超时是5秒。
注意:如果测试返回了一个promise，Jest会在测试完成之前等待promise。Jest还将等待，如果你为测试函数提供一个参数，通常称为done。当你想要测试回调时，这将非常方便。请参见如何在此测试异步代码。
例如，假设fetchBeverageList()返回一个承诺，该承诺将解析到其中有lemon的列表。你可以用:
test('has lemon in it', () => {
return fetchBeverageList().then(list => {
expect(list).toContain('lemon');
});
});
即使对测试的调用会立即返回，测试也不会完成，直到promise解决。
test.only(name, fn, timeout)等同于 it.only(name, fn, timeout) or fit(name, fn, timeout)
在调试大型代码库时，通常只希望运行一个子集的测试。您可以使用。只指定哪些测试是您想要运行的。
您还可以提供一个超时(以毫秒为单位)，用于指定在终止前等待的时间。注意:默认的超时是5秒。
test.only('it is raining', () => {
expect(inchesOfRain()).toBeGreaterThan(0);
});
test('it is not snowing', () => {
expect(inchesOfSnow()).toBe(0);
});
只有“it is raining”测试才会运行，因为它是用test运行的。
通常你不会使用测试来检查代码。只有在源代码控制中——您将仅用于调试，并在修复了故障测试后删除它。
test.skip(name, fn)等同于it.skip(name, fn) or xit(name, fn) or xtest(name, fn)
当您维护一个大型的代码库时，您可能有时会发现由于某种原因而临时中断的测试。
如果您想跳过这个测试，但是您不想仅仅删除这个代码，您可以使用skip指定一些测试来跳过。
test('it is raining', () => {
expect(inchesOfRain()).toBeGreaterThan(0);
});
test.skip('it is not snowing', () => {
expect(inchesOfSnow()).toBe(0);
});
只有“it is raining”测试运行，因为另一个测试运行test . skip。 您可以简单地对测试进行注释，但是使用skip会更好一些，因为它将保持缩进和语法突出。
写在最后：
本文介绍了一些Jest中的全局函数，可以在任意地方方便的使用。
系列教程：
1. 前端测试框架Jest系列教程 -- Matchers（匹配器）
2.前端测试框架Jest系列教程 -- Asynchronous(测试异步代码)
