From 3dce8b667f77c414b123be249d1ea6e98804ea4f Mon Sep 17 00:00:00 2001
From: Sean Sellek <me@seansellek.com>
Date: Tue, 3 Mar 2020 13:52:22 -0500
Subject: [PATCH] add @mocha package declaration for mocha.loadFilesAsync()
 (#42684)

* add declaration for Mocha.loadFilesAsync()

* add test for mocha.loadFilesAsync()
---
 types/mocha/index.d.ts     | 7 +++++++
 types/mocha/mocha-tests.ts | 4 ++++
 2 files changed, 11 insertions(+)

diff --git a/types/mocha/index.d.ts b/types/mocha/index.d.ts
index 8acda66560..10ee78aceb 100644
--- a/types/mocha/index.d.ts
+++ b/types/mocha/index.d.ts
@@ -231,6 +231,13 @@ declare class Mocha {
      */
     run(fn?: (failures: number) => void): Mocha.Runner;
 
+    /**
+     * Loads ESM (and CJS) test files asynchronously.
+     *
+     * @see https://mochajs.org/api/mocha#loadFilesAsync
+     */
+    loadFilesAsync(): Promise<void>;
+
     /**
      * Load registered files.
      *
diff --git a/types/mocha/mocha-tests.ts b/types/mocha/mocha-tests.ts
index b58ac5ea9f..08cc6bbd90 100644
--- a/types/mocha/mocha-tests.ts
+++ b/types/mocha/mocha-tests.ts
@@ -833,6 +833,10 @@ function test_browser_mocha_setup_all_options() {
     });
 }
 
+function testLoadFilesAsync() {
+    mocha.loadFilesAsync();
+}
+
 function test_constructor_slow_option() {
     const m: Mocha = new LocalMocha({ slow: 25 });
 }