Deno 是一个由 Node.js 的创始人 Ryan Dahl 所开发的 JavaScript 运行时，它的目标是为了提供更好的安全性和可维护性。与 Node.js 不同的是，Deno 具有更好的类型检查和模块管理支持，也提供了一个通过标准化的工具链进行构建的体系结构。
在本文中，我们将讨论如何在 Deno 中编写可维护的应用程序。我们会探讨一些最佳实践，包括代码组织、单元测试、错误处理和文档编写，这些实践将有助于您编写更具可读性、可维护性和扩展性的代码。
代码组织
一个好的应用程序应该有良好的文件和文件夹组织结构。以下是一个建议的组织结构：
-- -------------------- ---- ------- ----- --- ------- - --- ------------ - --- ----------------- --- ------------ - --- ----------------- - --- ----------------- --- ------- - --- ------------ - --- ------------ --- ------- - --- ------------- - --- ------------- --- --------- - --- -------------- - --- -------------- --- ---------
在这个结构中，我们将应用程序分为不同的部分，每个部分都是可以独立测试和扩展的。src 目录保存应用程序代码文件。routes 目录包含应用的路由，controllers 目录包含路由控制器，services 目录包含服务逻辑，models 目录包含数据库模型和枚举值等等。通过将代码代码分成这些部分，我们使代码更具可读性和可维护性。
单元测试
测试是代码可维护性的关键组成部分，这是因为测试可以及早发现和防止功能性问题。在 Deno 中，我们可以使用任何测试库来编写测试。例如：我们可以使用 Deno 自带的 assert 模块，也可以使用第三方库 Deno.test，它与 Node.js 中的 Mocha 或 Jest 类似。
以下是一个简单的示例，展示了如何使用 Deno.test 来编写同步测试：
-- -------------------- ---- ------- ------ - ------------ - ---- ------------------------------------------- --------------- ------- ---------- -- -- - -------------------------------- --- -- --------------------- --- -------- ------------------ -------- ------ - ------ - - -- -
对于异步测试，我们可以使用 async 关键字来编写异步测试用例。以下是一个简单的示例，展示了如何使用 async/await 语法来编写异步测试：
-- -------------------- ---- ------- ------ - ------ - ---- ------------------------------------------- --------------- ----- ------- ---------- ----- -- -- - ----- ------ - ----- ------------------------ ------------- --- --- --- ----- -------- ----------------------- -------- --------------- - ------ --- ----------------- -- ------------- -- --------- - --- ------ -
在上述示例中，我们使用了 Deno 自带的 assert 模块。这个模块提供了许多常用的断言函数，包括 assertEquals、assertStringContains 等等。
错误处理
异常处理也是编写可维护代码的关键。当代码出现异常时，应该通过记录日志或提示错误消息来提供有用的信息。在 Deno 中，我们可以使用 console 模块来输出日志和错误信息。
以下是一个简单的示例，展示了如何使用 try/catch 语句和 console 模块来处理错误：
try {
await exampleFunctionThatMayThrowAnError();
} catch (error) {
console.error("An error occurred:", error.message);
}该示例仅仅是给出了一种错误处理的基本示例，你可以将错误处理放在选择器过程中或者单独的 errorHandling.ts 中。
文档编写
良好的文档可以使应用程序易于阅读和维护。在 Deno 中，我们可以使用 JSDoc 来为每个功能编写注释。可以将 JSDoc 的注释放在函数顶部，以说明该函数的参数，返回值以及其他相关信息。
以下是一个简单的示例，展示了如何使用 JSDoc 来编写函数文档注释：
-- -------------------- ---- ------- --- - --- --- -------- - ------ -------- - - --- ----- ------- - ------ -------- - - --- ------ ------- - ------- -------- --- --- -- --- -------- -- -------- ------------- ------- -- -------- ------ - ------ - - -- -
在上面的示例中，我们使用了 JSDoc 注释，说明了函数的参数和返回值。
结论
通过以上最佳实践，我们可以编写可读性高、可维护性高的 JavaScript/Deno 应用程序。当然，这只是我们建议使用的模式，你也可以通过不同的方案来解决不同的问题。但无论你选择什么样的方案书写可维护的，读起来可以直观的代码是最重要的。
以上仅仅是一份前端类的技术文章，仅仅只是观点表达，如果涉及专业问题，建议前往专业场所提问。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/66ee88b96fbf96019723bda3