”工欲善其事,必先利其器。“—孔子《论语.录灵公》
首页 > 编程 > 了解干净的代码:处理 ⚡

了解干净的代码:处理 ⚡

发布于2024-08-25
浏览:489

Understanding Clean Code: Handling ⚡

错误处理是编写健壮可靠的软件的一个重要方面。然而,不小心可能会导致代码混乱,难以阅读和维护。

《简洁代码》第 7 章深入探讨了处理错误的技术,这些技术不会使代码混乱,强调清晰性和简单性。

在本文中,我们将探讨本章中的关键概念以及如何在 JavaScript 中应用它们以保持代码库整洁和可维护。


? 1. 使用异常而不是错误代码

干净代码的关键原则之一是优先选择异常而不是错误代码。

异常允许您将错误处理逻辑与主逻辑分开,使您的代码更具可读性。

示例:避免错误代码

function getUser(id) {
    const user = database.findUserById(id);
    if (user === null) {
        return -1;  // Error code for user not found
    }
    return user;
}

const result = getUser(123);
if (result === -1) {
    console.error('User not found');
} else {
    console.log(result);
}

在这个例子中,错误处理与主逻辑交织在一起,使其更难以理解。

示例:使用异常

function getUser(id) {
    const user = database.findUserById(id);
    if (user === null) {
        throw new Error('User not found');
    }
    return user;
}

try {
    const user = getUser(123);
    console.log(user);
} catch (error) {
    console.error(error.message);
}

通过使用异常,我们将错误处理逻辑与主逻辑分开,使代码更干净、更容易理解。


? 2. 提供有意义的信息

抛出异常时,提供有意义的错误消息来提供有关错误的上下文非常重要。

这有助于快速诊断问题,而无需深入研究代码。

示例:在错误消息中提供上下文

function getUser(id) {
    const user = database.findUserById(id);
    if (user === null) {
        throw new Error(`User with ID ${id} not found`);
    }
    return user;
}

try {
    const user = getUser(123);
    console.log(user);
} catch (error) {
    console.error(error.message);  // Outputs: User with ID 123 not found
}

描述性错误消息提供了立即理解问题所需的上下文。


? 3. 不要返回 Null

返回 null 可能会导致难以跟踪的 null 引用错误。

考虑抛出异常或使用提供默认行为的特殊情况模式,而不是返回 null。

示例:避免返回 Null

function getUser(id) {
    const user = database.findUserById(id);
    if (user === null) {
        return null;  // This can lead to null reference errors
    }
    return user;
}

const user = getUser(123);
if (user !== null) {
    console.log(user.name);
}

返回 null 需要额外的检查,并且可能会使您的代码变得混乱。

示例:引发异常或使用特殊情况

function getUser(id) {
    const user = database.findUserById(id);
    if (user === null) {
        throw new Error(`User with ID ${id} not found`);
    }
    return user;
}

// OR

class NullUser {
    get name() {
        return 'Guest';
    }
}

function getUser(id) {
    const user = database.findUserById(id);
    return user || new NullUser();
}

引发异常或使用特殊情况对象(如 NullUser)有助于避免空引用错误并保持代码干净。


? 4. 谨慎使用 Try-Catch-Finally

虽然 try-catch-finally 块对于处理异常至关重要,但过度使用它们会使您的代码变得混乱。

仅在必要时使用它们,并避免深层嵌套的块。

示例:避免过多的 Try-Catch

try {
    const data = JSON.parse(input);
    try {
        const user = getUser(data.id);
        try {
            sendEmail(user.email);
        } catch (error) {
            console.error('Failed to send email:', error.message);
        }
    } catch (error) {
        console.error('User retrieval failed:', error.message);
    }
} catch (error) {
    console.error('Invalid JSON:', error.message);
}

由于多个嵌套的 try-catch 块,此代码很难理解。

示例:重构以减少混乱

function parseInput(input) {
    try {
        return JSON.parse(input);
    } catch (error) {
        throw new Error('Invalid JSON');
    }
}

function retrieveUser(data) {
    return getUser(data.id);
}

function notifyUser(user) {
    sendEmail(user.email);
}

try {
    const data = parseInput(input);
    const user = retrieveUser(data);
    notifyUser(user);
} catch (error) {
    console.error(error.message);
}

通过将逻辑分解为单独的函数,我们减少了嵌套并提高了可读性。


? 5. 不要忽略捕获的异常

如果捕获异常,请确保正确处理。

默默地忽略异常可能会导致意外行为并使调试变得困难。

示例:不要忽略异常

try {
    const user = getUser(123);
} catch (error) {
    // Ignoring the exception
}

忽略异常可以掩盖代码中的潜在问题。

示例:处理或记录异常

try {
    const user = getUser(123);
} catch (error) {
    console.error('An error occurred:', error.message);
}

处理或记录异常可确保您了解任何问题并可以相应地解决这些问题。


⚡ 结论

有效的错误处理对于编写干净、可维护的 JavaScript 代码至关重要。

通过遵循《干净代码》中的原则,例如使用异常而不是错误代码、在错误消息中提供上下文、避免 null 返回、谨慎使用 try-catch 以及不忽略捕获的异常,您可以确保错误处理逻辑既坚固又不引人注目。

快乐编码!

版本声明 本文转载于:https://dev.to/alisamir/understanding-clean-code-handling-59ji?1如有侵犯,请联系[email protected]删除
最新教程 更多>
  • 高级 T:依赖参数、推断联合以及 Twitter 上的健康交互。
    高级 T:依赖参数、推断联合以及 Twitter 上的健康交互。
    每次我用 TypeScript 写成 Foo 时,我都会感受到失败的沉重。 在一种情况下,这种感觉特别强烈:当函数采用的参数取决于哪个 "mode" 处于活动状态时。 通过一些示例代码更清晰: type Provider = "PROVIDER A" | "PR...
    编程 发布于2024-11-07
  • 如何创建人力资源管理解决方案
    如何创建人力资源管理解决方案
    1. Understanding the Basics of Frappe and ERPNext Task 1: Install Frappe and ERPNext Goal: Get a local or cloud-based instance of ERP...
    编程 发布于2024-11-07
  • 从周五黑客到发布:对创建和发布开源项目的思考
    从周五黑客到发布:对创建和发布开源项目的思考
    从周五补丁破解到发布:对创建和发布开源项目的思考 这是针对初学者和中级开发人员的系列的一部分,通过将他们的想法作为开源项目发布或引起兴趣。 这些想法是有偏见的和个人的。计划发布更多文章。通过分享一些思考,我希望能启发你做自己的项目 思考(此) 作为 Java 开发人员学习 Go l...
    编程 发布于2024-11-07
  • 可以使用 constexpr 在编译时确定字符串长度吗?
    可以使用 constexpr 在编译时确定字符串长度吗?
    常量表达式优化:可以在编译时确定字符串长度吗?在优化代码的过程中,开发人员尝试计算使用递归函数在编译时计算字符串文字的长度。此函数逐字符计算字符串并返回长度。初始观察:该函数似乎按预期工作,在运行时返回正确的长度并生成表明计算发生在编译时的汇编代码。这就提出了一个问题:是否保证length函数会在编...
    编程 发布于2024-11-07
  • 在 Raspberry Pi 上运行 Discord 机器人
    在 Raspberry Pi 上运行 Discord 机器人
    Unsplash 上 Daniel Tafjord 的封面照片 我最近完成了一个软件工程训练营,开始研究 LeetCode 的简单问题,并觉得如果我每天都有解决问题的提醒,这将有助于让我负起责任。我决定使用按 24 小时计划运行的不和谐机器人(当然是在我值得信赖的树莓派上)来实现此操作,该机器人将执...
    编程 发布于2024-11-07
  • 解锁 JavaScript 的隐藏宝石:未充分利用的功能可提高代码质量和性能
    解锁 JavaScript 的隐藏宝石:未充分利用的功能可提高代码质量和性能
    In the ever-evolving landscape of web development, JavaScript remains a cornerstone technology powering countless large-scale web applications. While...
    编程 发布于2024-11-07
  • 为什么通过非常量指针修改“const”变量看起来有效,但实际上并没有改变它的值?
    为什么通过非常量指针修改“const”变量看起来有效,但实际上并没有改变它的值?
    通过非常量指针修改 const在 C 中,const 变量一旦初始化就无法修改。但是,在某些情况下,const 变量可能会被更改。考虑以下代码:const int e = 2; int* w = (int*)&e; // (1) *w = 5; ...
    编程 发布于2024-11-07
  • Android - 将 .aab 文件上传到 Play 商店时出错
    Android - 将 .aab 文件上传到 Play 商店时出错
    如果您遇到此错误,请按照以下步骤操作以确保与您的包名称和签名密钥保持一致: 确保 app.json 文件中的包名称与您第一次上传 .aab 文件时使用的包名称匹配。 "android": { "permissions":["CAMERA","READ_EXTERNAL_STORAGE...
    编程 发布于2024-11-07
  • 如何使用 PHP 将 HTML 转换为 PDF
    如何使用 PHP 将 HTML 转换为 PDF
    (适用于 Windows 的指南。不适用于 Mac 或 Linux) (图片来源) 在 PHP 中将 HTML 转换为 PDF 的方法不止一种。您可以使用Dompdf或Mpdf;但是,这两个库的执行方式有所不同。 注意:本文中并未包含所有解决方案。 要使用这两个库,您将需要 Composer。 ...
    编程 发布于2024-11-07
  • C++ 会拥抱垃圾收集吗?
    C++ 会拥抱垃圾收集吗?
    C 中的垃圾收集:实现和共识的问题虽然有人建议 C 最终会包含垃圾收集器,但它仍然是争论和持续发展的主题。要理解其中的原因,我们必须深入研究迄今为止阻碍其纳入的挑战和考虑因素。实现复杂性向 C 添加隐式垃圾收集是一个非-琐碎的任务。该语言的低级性质和对指针的广泛支持带来了重大的技术障碍。实施问题的范...
    编程 发布于2024-11-07
  • 如何有条件地删除 MySQL 中的列?
    如何有条件地删除 MySQL 中的列?
    使用 MySQL ALTER 进行条件列删除MySQL 中的 ALTER 命令提供了一种从表中删除列的简单方法。但是,当指定列不存在时,其传统语法 (ALTER TABLE table_name DROP COLUMN column_name) 会引发错误。对于 MySQL 版本 4.0.18,没有...
    编程 发布于2024-11-07
  • 你应该了解的现代 CSS 样式 4
    你应该了解的现代 CSS 样式 4
    TL;DR: 本博客使用代码示例来探索 Web 开发的五种最佳 CSS 样式和功能:容器查询、子网格、伪类、逻辑属性和实验室颜色空间。它们增强响应能力、简化布局并提高设计一致性。 层叠样式表 (CSS) 是一种众所周知的用于设计网页样式的语言。使用 CSS,您可以通过添加空格来自定义 HTML 元素...
    编程 发布于2024-11-07
  • 箭头函数或父作用域何时定义函数的参数?
    箭头函数或父作用域何时定义函数的参数?
    ES6 箭头函数中的参数:官方说明在 ES6 箭头函数中,arguments 关键字的行为一直是争论的话题。一些浏览器和平台(例如 Chrome、Firefox 和 Node)偏离了最初的 TC39 建议,引发了对该规范正确解释的质疑。根据官方 ES6 规范,箭头函数没有其自身的定义。自己的参数在其...
    编程 发布于2024-11-07
  • 根据您提供的内容,以下是一些采用问题格式的潜在文章标题:

* 加载数据本地内文件访问被拒绝:如何排除和修复错误? 
* 为什么要加载数据LOCA
    根据您提供的内容,以下是一些采用问题格式的潜在文章标题: * 加载数据本地内文件访问被拒绝:如何排除和修复错误? * 为什么要加载数据LOCA
    LOAD DATA LOCAL INFILE 访问被错误拒绝:不允许使用的命令当利用 MySQL 的 LOAD DATA INFILE 执行 PHP 脚本时,它可能会遇到错误“用户访问被拒绝...(使用密码:是)”。常见的解决方法是切换到 LOAD DATA LOCAL INFILE,尽管这可能会导...
    编程 发布于2024-11-07
  • 如何在 Python 中检查文本文件是否为空?
    如何在 Python 中检查文本文件是否为空?
    确定文本文件是否为空在编程领域,通常需要确定特定文件是否包含任何数据或无效。本文深入探讨了这样一个问题:“我们如何确定文本文件是否为空?”Python 作为一种多功能编程语言,为这个问题提供了一个简单的解决方案。通过利用 os.stat() 函数,我们可以检索有关文件的属性数组,包括其大小。查询答案...
    编程 发布于2024-11-07

免责声明: 提供的所有资源部分来自互联网,如果有侵犯您的版权或其他权益,请说明详细缘由并提供版权或权益证明然后发到邮箱:[email protected] 我们会第一时间内为您处理。

Copyright© 2022 湘ICP备2022001581号-3