From 2c29a37840514f686b220123ea9d0fdd9dd12976 Mon Sep 17 00:00:00 2001
From: Edgar <29460583+ej-sanmartin@users.noreply.github.com>
Date: Sun, 28 Dec 2025 21:35:21 -0500
Subject: [PATCH] Add clarifying comment explaining threads block file system
 scanning on web.

---
 editor/file_system/editor_file_system.cpp | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/editor/file_system/editor_file_system.cpp b/editor/file_system/editor_file_system.cpp
index 17c92d1b23..cdfb403f2f 100644
--- a/editor/file_system/editor_file_system.cpp
+++ b/editor/file_system/editor_file_system.cpp
@@ -3756,6 +3756,8 @@ void EditorFileSystem::remove_import_format_support_query(Ref<EditorFileSystemIm
 
 EditorFileSystem::EditorFileSystem() {
 #if defined(THREADS_ENABLED) && !defined(WEB_ENABLED)
+	// On web, threaded scanning blocks the browser's event loop, causing freezes.
+	// See GH-112072 for details.
 	use_threads = true;
 #endif