Add StackBlitz example for test timeouts

Author: SamVerschueren

docs/07-test-timeouts.md

@@ -2,6 +2,8 @@
 
 Translations: [Français](https://github.com/avajs/ava-docs/blob/master/fr_FR/docs/07-test-timeouts.md)
 
+[![Open in StackBlitz](https://developer.stackblitz.com/img/open_in_stackblitz.svg)](https://stackblitz.com/github/avajs/ava/tree/main/examples/timeouts?file=test.js&terminal=test&view=editor)
+
 Timeouts in AVA behave differently than in other test frameworks. AVA resets a timer after each test, forcing tests to quit if no new test results were received within the specified timeout. This can be used to handle stalled tests.
 
 The default timeout is 10 seconds.

examples/timeouts/index.js

@@ -0,0 +1,42 @@
+'use strict';
+
+const delay = ms => {
+	return new Promise(resolve => {
+		setTimeout(resolve, ms);
+	});
+};
+
+exports.fetchUsers = async () => {
+	await delay(50);
+
+	return [
+		{
+			id: 1,
+			firstName: 'Ava',
+			name: 'Rocks',
+			email: '[email protected]'
+		}
+	];
+};
+
+exports.fetchPosts = async userId => {
+	await delay(200);
+
+	return [
+		{
+			id: 1,
+			userId,
+			message: 'AVA Rocks 🚀'
+		}
+	];
+};
+
+exports.createPost = async message => {
+	await delay(3000);
+
+	return {
+		id: 2,
+		userId: 1,
+		message
+	};
+};

examples/timeouts/package.json

@@ -0,0 +1,10 @@
+{
+	"name": "ava-timeouts",
+	"description": "Example for test timeouts",
+	"scripts": {
+		"test": "ava --timeout=2s --verbose"
+	},
+	"devDependencies": {
+		"ava": "^3.15.0"
+	}
+}

examples/timeouts/readme.md

@@ -0,0 +1,5 @@
+# Test timeouts
+
+> Example for [test timeouts](https://github.com/avajs/ava/blob/main/docs/07-test-timeouts.md)
+
+[![Open in StackBlitz](https://developer.stackblitz.com/img/open_in_stackblitz.svg)](https://stackblitz.com/github/avajs/ava/tree/main/examples/timeouts?file=test.js&terminal=test&view=editor)

examples/timeouts/test.js

@@ -0,0 +1,43 @@
+'use strict';
+const test = require('ava');
+
+const {fetchUsers, fetchPosts, createPost} = require('.');
+
+test('retrieve users', async t => {
+	t.timeout(100);
+
+	const users = await fetchUsers();
+
+	t.deepEqual(users, [
+		{
+			id: 1,
+			firstName: 'Ava',
+			name: 'Rocks',
+			email: '[email protected]'
+		}
+	]);
+});
+
+test('retrieve posts', async t => {
+	t.timeout(100, 'retrieving posts is too slow');
+
+	const posts = await fetchPosts(1);
+
+	t.deepEqual(posts, [
+		{
+			id: 1,
+			userId: 1,
+			message: 'AVA Rocks 🚀'
+		}
+	]);
+});
+
+test('create post', async t => {
+	const post = await createPost('I love 🦄 and 🌈');
+
+	t.deepEqual(post, {
+		id: 2,
+		userId: 1,
+		message: 'I love 🦄 and 🌈'
+	});
+});