Warn Developers Lacking a Global afterEach Function Instead of Throwing Errors

src/__tests__/auto-cleanup-global-env.js

@@ -0,0 +1,23 @@
+beforeEach(jest.restoreAllMocks)
+
+test('Testing Utilities with global access to `afterEach()` will not log warnings', () => {
+  jest.spyOn(console, 'warn')
+  global.afterEach = () => {}
+
+  require('..')
+  expect(console.warn).not.toHaveBeenCalled()
+})
+
+test('Testing Utilities lacking a global `afterEach` function will log a warning ONCE', () => {
+  delete global.afterEach
+  const warn = jest.spyOn(console, 'warn')
+
+  require('..')
+  jest.resetModules()
+  require('..')
+
+  expect(warn).toHaveBeenCalledTimes(1)
+  expect(warn.mock.calls[0][0]).toMatchInlineSnapshot(
+    `The current test runner does not support afterEach/teardown hooks. This means we won't be able to run automatic cleanup and you should be calling cleanup() manually.`,
+  )
+})

src/index.js

@@ -5,13 +5,11 @@ import {cleanup} from './render'
 // This ensures that tests run in isolation from each other.
 // If you don't like this, set the VTL_SKIP_AUTO_CLEANUP variable to 'true'.
 if (typeof afterEach === 'function' && !process.env.VTL_SKIP_AUTO_CLEANUP) {
-  afterEach(() => {
-    cleanup()
-  })
-} else if (process.env.VITEST === 'true') {
-  throw new Error(
-    "You are using vitest without globals, this way we can't run cleanup after each test.\n" +
-      "See https://testing-library.com/docs/vue-testing-library/setup for details or set the VTL_SKIP_AUTO_CLEANUP variable to 'true'",
+  afterEach(cleanup)
+} else if (!process.env.VTL_AFTEREACH_WARNING_LOGGED) {
+  process.env.VTL_AFTEREACH_WARNING_LOGGED = true
+  console.warn(
+    `The current test runner does not support afterEach/teardown hooks. This means we won't be able to run automatic cleanup and you should be calling cleanup() manually.`,
   )
 }