什么是 @theia/file-search？
@theia/file-search 是一个可以在 Theia 编辑器中搜索文件和文件夹的 npm 包。该包提供了文件搜索和文件夹搜索两种搜索方式，并支持查询参数的控制以及结果展示方式的设置。
如何安装 @theia/file-search？
首先，确保您已经安装了 Theia 编辑器，然后在命令行窗口中运行以下命令来安装 @theia/file-search：
npm install @theia/file-search
如何使用 @theia/file-search？
@theia/file-search 提供了两种搜索方式，分别是文件搜索和文件夹搜索。下面分别介绍这两种搜索方式的使用方法。
文件搜索
要使用文件搜索功能，可以使用以下代码：
-- -------------------- ---- -------
------ - ----------------- - ---- -----------------------------------------------------
------ --- ---- -----------------------------
----- ---- - --- --------- -- -------
----- ----- - -------- -- -------
----- ------ - ----- ------------------------------ -
------
-------- ---
----------- ---
--------------- ---
--------------- --
---其中，root 是搜索的根目录，可以是文件夹或文件的 URI。query 是搜索的关键字，folders 是要搜索的文件夹列表，maxResults 是最大结果数，excludePattern 是排除的文件名模式，includePattern 是包含的文件名模式。这些参数都是可选的。
最后，搜索结果会被返回给 result 变量。
文件夹搜索
要使用文件夹搜索功能，可以使用以下代码：
import { dirSearchService } from '@theia/file-search/lib/browser/dir-search-service';
import URI from '@theia/core/lib/common/uri';
const root = new URI('/'); // 设置搜索根目录
const query = 'theia'; // 设置搜索关键字
const result = await dirSearchService.search(root, query);dirSearchService.search 方法接收一个 URI 类型的 root 参数和一个字符串类型的 query 参数。最后，搜索结果会被返回给 result 变量。
结果展示
@theia/file-search 提供了多种结果展示方式，支持列表、树形结构以及面板的展示方式。下面给出一个使用列表展示搜索结果的示例代码：
-- -------------------- ---- -------
------ - ---------------- - ---- --------------------------------------------------------
------ - ---------- - ---- ------------------------------------------
------ - ------------ - ---- ------------------------------------------------------
----- ---------------- - --- -------------------- --------------
----- -------------- -------------- - -------------------
---------------------------------- -- -
----- ---- - -
------ -------------------
------------ ---------------------------------------------------------------------- ----------
---- -- -- -
-- ---------- --
-
--
----------------------------
---该示例代码使用了 Theia 自带的 QuickOpenService，将搜索结果以列表的形式展示在 Quick Open 面板中。在搜索结果中，每条搜索结果都是一个 SearchResult 类型的实例。
在循环中，我们将 SearchResult 的 label 属性作为 Quick Open 条目的标题，将 SearchResult 的 file 和 matches 属性拼接为一个字符串作为 Quick Open 条目的描述。同时，该条目还支持点击后的响应操作。
总结
通过学习本教程，我们了解了 @theia/file-search 的基本使用方法，并学会了如何在 Theia 编辑器中使用该包。同时，我们还学习了如何控制查询参数以及如何展示搜索结果。这些知识可以帮助我们更好地开发 Theia 编辑器插件，并提升我们的开发效率。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/sensics-file-search