Update examples to use AVA 6

Co-authored-by: Sindre Sorhus <[email protected]>
Co-authored-by: Mark Wubben <[email protected]>

Author: 3 people

.gitignore

@@ -5,3 +5,4 @@
 /test-tap/**/node_modules/
 /test/**/fixtures/**/node_modules/*/
 /examples/**/node_modules/
+/examples/**/package-lock.json

docs/05-command-line.md

@@ -144,16 +144,6 @@ test('moo will also run', t => {
 test.only('boo will run but not exclusively', t => {
 	t.pass();
 });
-
-// Won't run, no title
-test(function (t) {
-	t.fail();
-});
-
-// Won't run, no explicit title
-test(function foo(t) {
-	t.fail();
-});
 ```
 
 ## Running tests at specific line numbers

docs/recipes/endpoint-testing.md

@@ -4,21 +4,23 @@ Translations: [Español](https://github.com/avajs/ava-docs/blob/main/es_ES/docs/
 
 [![Open in StackBlitz](https://developer.stackblitz.com/img/open_in_stackblitz.svg)](https://stackblitz.com/github/avajs/ava/tree/main/examples/endpoint-testing?file=test.js&terminal=test&view=editor)
 
-AVA doesn't have a built-in method for testing endpoints, but you can use any HTTP client of your choosing, for example [`got`](https://github.com/sindresorhus/got). You'll also need to start an HTTP server, preferably on a unique port so that you can run tests in parallel. For that we recommend [`test-listen`](https://github.com/zeit/test-listen).
+AVA doesn't have a built-in method for testing endpoints, but you can use any HTTP client of your choosing, for example [`ky`](https://github.com/sindresorhus/ky). You'll also need to start an HTTP server, preferably on a unique port so that you can run tests in parallel. For that we recommend [`async-listen`](https://github.com/vercel/async-listen).
 
 Since tests run concurrently, it's best to create a fresh server instance at least for each test file, but perhaps even for each test. This can be accomplished with `test.before()` and `test.beforeEach()` hooks and `t.context`. If you start your server using a `test.before()` hook you should make sure to execute your tests serially.
 
 Check out the example below:
 
 ```js
-import http from 'node:http';
+import {createServer} from 'node:http';
+
+import {listen} from 'async-listen';
 import test from 'ava';
-import got from 'got';
-import listen from 'test-listen';
-import app from '../app';
+import ky, {HTTPError} from 'ky';
+
+import app from './app.js';
 
 test.before(async t => {
-	t.context.server = http.createServer(app);
+	t.context.server = createServer(app);
 	t.context.prefixUrl = await listen(t.context.server);
 });
 
@@ -27,9 +29,17 @@ test.after.always(t => {
 });
 
 test.serial('get /user', async t => {
-	const {email} = await got('user', {prefixUrl: t.context.prefixUrl}).json();
+	const {email} = await ky('user', {prefixUrl: t.context.prefixUrl}).json();
+
 	t.is(email, '[email protected]');
 });
+
+test.serial('404', async t => {
+	await t.throwsAsync(
+		ky('password', {prefixUrl: t.context.prefixUrl}),
+		{message: /Request failed with status code 404 Not Found/, instanceOf: HTTPError},
+	);
+});
 ```
 
 Other libraries you may find useful:

examples/endpoint-testing/app.js

@@ -1,13 +1,9 @@
-'use strict';
-
-const app = (request, response) => {
+export default function app(request, response) {
 	if (request.url === '/user') {
 		response.setHeader('Content-Type', 'application/json');
 		response.end(JSON.stringify({email: '[email protected]'}));
 	} else {
 		response.writeHead('404');
 		response.end();
 	}
-};
-
-module.exports = app;
+}

examples/endpoint-testing/package.json

@@ -1,12 +1,13 @@
 {
 	"name": "ava-endpoint-testing",
 	"description": "Example for endpoint testing",
+	"type": "module",
 	"scripts": {
-		"test": "ava"
+		"test": "ava test.js"
 	},
 	"devDependencies": {
-		"ava": "^3.15.0",
-		"got": "^11.8.2",
-		"test-listen": "^1.1.0"
+		"ava": "^6",
+		"ky": "^1.4.0",
+		"async-listen": "^3.0.1"
 	}
 }

examples/endpoint-testing/test.js

@@ -1,14 +1,13 @@
-'use strict';
-const http = require('node:http');
+import {createServer} from 'node:http';
 
-const test = require('ava');
-const got = require('got');
-const listen = require('test-listen');
+import {listen} from 'async-listen';
+import test from 'ava';
+import ky, {HTTPError} from 'ky';
 
-const app = require('./app.js');
+import app from './app.js';
 
 test.before(async t => {
-	t.context.server = http.createServer(app);
+	t.context.server = createServer(app);
 	t.context.prefixUrl = await listen(t.context.server);
 });
 
@@ -17,7 +16,14 @@ test.after.always(t => {
 });
 
 test.serial('get /user', async t => {
-	const {email} = await got('user', {prefixUrl: t.context.prefixUrl}).json();
+	const {email} = await ky('user', {prefixUrl: t.context.prefixUrl}).json();
 
 	t.is(email, '[email protected]');
 });
+
+test.serial('404', async t => {
+	await t.throwsAsync(
+		ky('password', {prefixUrl: t.context.prefixUrl}),
+		{message: /Request failed with status code 404 Not Found/, instanceOf: HTTPError},
+	);
+});

examples/macros/index.js

@@ -1 +1,3 @@
-exports.sum = (a, b) => a + b;
+export function sum(a, b) {
+	return a + b;
+}

examples/macros/package.json

@@ -1,10 +1,11 @@
 {
 	"name": "ava-macros",
 	"description": "Example for reusing test logic through macros",
+	"type": "module",
 	"scripts": {
-		"test": "ava"
+		"test": "ava test.js"
 	},
 	"devDependencies": {
-		"ava": "^3.15.0"
+		"ava": "^6"
 	}
 }

examples/macros/test.js

@@ -1,12 +1,13 @@
-const test = require('ava');
+import test from 'ava';
 
-const {sum} = require('./index.js');
+import {sum} from './index.js';
 
-function macro(t, a, b, expected) {
-	t.is(sum(a, b), expected);
-}
-
-macro.title = (providedTitle, a, b, expected) => `${providedTitle ?? ''} ${a}+${b} = ${expected}`.trim();
+const macro = test.macro({
+	exec(t, a, b, expected) {
+		t.is(sum(a, b), expected);
+	},
+	title: (providedTitle, a, b, expected) => `${providedTitle ?? ''} ${a}+${b} = ${expected}`.trim(),
+});
 
 test(macro, 2, 2, 4);
 test(macro, 3, 3, 6);

examples/matching-titles/package.json

@@ -1,10 +1,11 @@
 {
 	"name": "ava-matching-titles",
 	"description": "Example for running tests with matching titles",
+	"type": "module",
 	"scripts": {
-		"test": "ava --match='*oo*'"
+		"test": "ava test.js --match='*oo*'"
 	},
 	"devDependencies": {
-		"ava": "^3.15.0"
+		"ava": "^6"
 	}
 }