diff --git a/doc/api/test.md b/doc/api/test.md
index 276cfc32b6f571..964fdc2732fe89 100644
--- a/doc/api/test.md
+++ b/doc/api/test.md
@@ -1420,6 +1420,9 @@ describe('tests', async () => {
 });
 ```
 
+**Note:** The `after` hook is guaranteed to run,
+even if tests within the suite fail.
+
 ## `beforeEach([fn][, options])`
 
 <!-- YAML
@@ -1473,6 +1476,9 @@ added:
 This function is used to create a hook running
 after each subtest of the current test.
 
+**Note:** The `afterEach` hook is guaranteed to run after every test,
+even if any of the tests fail.
+
 ```js
 describe('tests', async () => {
   afterEach(() => console.log('finished running a test'));