Deno 错误处理

错误处理的重要性

错误处理是任何编程语言中的重要组成部分。在前端开发中，错误处理尤其重要，因为它直接影响到用户体验和应用程序的稳定性。Deno 是一个现代的、安全的 JavaScript 和 TypeScript 运行时，它提供了强大的错误处理机制，使开发者能够更有效地处理运行时错误。

Deno 中的错误类型

Deno 提供了多种内置的错误类型来帮助开发者更好地处理各种情况下的错误。这些错误类型继承自 JavaScript 的原生 Error 类，并添加了一些额外的属性和方法来提供更详细的信息。

Deno.errors.NotFound

当尝试打开一个不存在的文件或目录时，会抛出这个错误。例如，当你试图读取一个不存在的文件时：

try {
    await Deno.open("non_existent_file.txt");
} catch (err) {
    if (err instanceof Deno.errors.NotFound) {
        console.log("文件未找到");
    }
}

Deno.errors.PermissionDenied

当你的代码试图执行需要权限的操作但没有获得相应权限时，会抛出这个错误。例如，如果你尝试读取一个需要特定权限才能访问的文件，而你的程序没有相应的权限，就会触发这个错误：

try {
    await Deno.open("/etc/passwd", { read: true });
} catch (err) {
    if (err instanceof Deno.errors.PermissionDenied) {
        console.log("权限不足");
    }
}

Deno.errors.BadResource

当传递给某些 API 的资源句柄无效时，会抛出这个错误。例如，如果你使用了一个已经关闭的文件描述符，就会触发这个错误：

// www.javascriptcn.com code example
let file = await Deno.open("example.txt");

// 模拟关闭文件描述符（实际操作中不会这样做）
file.rid = -1;

try {
    await Deno.write(file.rid, new TextEncoder().encode("Hello World"));
} catch (err) {
    if (err instanceof Deno.errors.BadResource) {
        console.log("无效的资源句柄");
    }
}

Deno.errors.InvalidData

当数据格式不正确或与预期不符时，会抛出这个错误。例如，当你尝试解析一个格式不正确的 JSON 字符串时，就会触发这个错误：

try {
    const data = Deno.readTextFileSync("invalid.json");
    JSON.parse(data);
} catch (err) {
    if (err instanceof Deno.errors.InvalidData) {
        console.log("数据格式不正确");
    }
}

自定义错误处理

除了使用内置的错误类型外，Deno 还允许开发者创建自己的错误类来处理特定场景下的错误。这有助于提高代码的可读性和可维护性。下面是一个简单的例子：

// www.javascriptcn.com code example
class CustomError extends Error {
    constructor(message: string) {
        super(message);
        this.name = "CustomError";
    }
}

async function processFile(filePath: string) {
    try {
        const content = await Deno.readTextFile(filePath);
        // 模拟一个业务逻辑错误
        if (content.includes("error")) {
            throw new CustomError(`文件 ${filePath} 包含错误内容`);
        }
    } catch (err) {
        console.error(err.message);
    }
}

processFile("example.txt").catch((err) => {
    console.error(err.message);
});

在这个例子中，我们定义了一个名为 CustomError 的错误类，并在文件内容包含特定字符串时抛出该错误。这样，调用者可以根据错误类型进行针对性处理。

异常捕获与日志记录

在实际应用中，良好的异常捕获和日志记录机制对于追踪问题和维护系统健康至关重要。Deno 提供了强大的异步处理能力，使得我们可以轻松地在一个地方捕获所有未处理的异常，并将其记录下来。

// www.javascriptcn.com code example
import { Logger } from "https://deno.land/x/log/mod.ts";

const logger = new Logger();

// 设置全局异常处理器
Deno.unstable.setExceptionHandlers({
    async uncaughtException(e) {
        logger.error(`捕获到未处理的异常: ${e.message}`);
    },
});

try {
    // 模拟一个可能抛出异常的操作
    await Deno.open("non_existent_file.txt");
} catch (err) {
    logger.error(`捕获到异常: ${err.message}`);
}

在这个例子中，我们首先导入了 Logger 类，并实例化了一个日志记录器。然后通过 setExceptionHandlers 方法设置了一个全局的异常处理器，用于捕获并记录所有未处理的异常。同时，在 try-catch 块中我们也捕获了可能发生的异常并进行了相应的处理。

总结

通过上述介绍，我们可以看到 Deno 在错误处理方面提供了丰富的工具和灵活的机制。无论是使用内置的错误类型，还是自定义错误类，亦或是利用异步处理能力进行全局异常捕获和日志记录，都能够帮助开发者构建更加健壮和可靠的 Web 应用程序。正确理解和运用这些功能，将极大地提升你的开发效率和代码质量。