电脑在运行程序的时候,经常会遇到预期的或是非预期的错误,TypeScript 当然也不例外。这个章节要来介绍 TypeScript 的「try-catch」错误处理机制。

throw 关键字

TypeScript 的 throw 关键字,可以让 JavaScript 程序在任意位置中断运行,并抛出错误消息。这个错误消息可以是任意值(包括 undefined)。

例如:

console.log("Hello");

throw "I am an error!";

console.log("World");

以上程序,会先输出 Hello 文字到主控台,接着当程序运行到第三行时,字符串 I am an error! 就会被当作是错误消息被「抛出」。由于第三行叙述的位置并不是在「try-catch」的 try 区块下,因此被抛出的错误消息会直接被输出到主控台中,且若 JavaScript 环境是 Node.js 的话,JavaScript 程序会立刻结束运行。

try-catch

利用 try 和 catch 关键字组成两个程序叙述区块,可以将 try 区块中抛出的错误消息给「拦截」下来。当有错误消息被拦截时,JavaScript 会立刻跳去运行 catch 区块内的叙述。catch 关键字后可以用小括号 () 来填入自订的参数名称,这个参数即从 try 区块中被抛出的错误消息。若 try 区块并没有抛出错误消息,catch 区块的程序叙述就不会被运行。

例如:

console.log("Hello");

try {
    throw "I am an error!";

    console.log("This can't be executed.");
} catch (err) {
    console.log(err);
}

console.log("World");

以上程序的输出结果如下:

Hello
I am an error!
World

虽然 TypeScript 有蛮强大的类型功能,但对于 catch 关键字后小括号 () 中定义的参数名称,我们完全没有办法去限制它的类型。换句话说,这个参数的类型永远会被 TypeScript 当作 any。

try-catch-finally

我们可以在 catch 区块后再使用 finally 关键字来撰写当 try 区块或是 catch 区块运行完之后要运行的程序区块。

例如:

console.log("Hello");

try {
    throw "I am an error!";

    console.log("This can't be executed.");
} catch (err) {
    console.log(err);
} finally {
    console.log("Done!");
}

console.log("World");

以上程序的输出结果如下:

Hello
I am an error!
Done!
World

专门用来「被抛出」的对象

虽然 TypeScript 的 throw 关键字可以抛出任意值,但我们还是应该要尽量使用 JavaScript 内置的专门用来「被抛出」的对象。

RangeError

RangeError 对象可用来表示输入的数值超出范围。

例如:

try {
    const n = 1.2345;

    console.log(n.toFixed(1000));
} catch (err) {
    console.log(err instanceof RangeError);
}

以上程序会输出 true,因为数值的 toFixed 方法的第一个参数只能是 0 ~ 100 的数值,若为负数或是超过 100,就会抛出 RangeError 对象。

我们也可以自己「new」一个 RangeError 对象来抛出,RangeError 的构造器可传入一个字符串作为错误描述。如下:

function discount(price: number, percentage: number): number {
    if (percentage >= 0 && percentage <= 100) {
        return price * (1 - percentage / 100);
    } else {
        throw new RangeError("The form of the percentage needs to be from 0 to 100.");
    }
}

try {
    console.log(discount(100, 20));
    console.log(discount(100, 999));
} catch (err) {
    console.log(err);
}

以上程序的输出结果如下:

80
RangeError: The form of the percentage needs to be from 0 to 100.
    at discount (index.js:7:15)
    at Object.<anonymous> (index.js:12:17)
    at Module._compile (internal/modules/cjs/loader.js:774:30)
    at Object.Module._extensions..js (internal/modules/cjs/loader.js:785:10)
    at Module.load (internal/modules/cjs/loader.js:641:32)
    at Function.Module._load (internal/modules/cjs/loader.js:556:12)
    at Function.Module.runMain (internal/modules/cjs/loader.js:837:10)
    at internal/main/run_main_module.js:17:11

相信您应该发现了,RangeError 对象除了有输出我们传入其构造器作为参数的 The form of the percentage needs to be from 0 to 100. 字符串外,还有输出 RangeError 对象被抛出的位置,以及相关的堆栈追踪(stack trace)信息。(只不过这边输出的位置是指 JavaScript 程序的位置,并不是 TypeScript 程序。)

这就是为什么前面会提到,throw 关键字应该要尽量使用 JavaScript 内置的专门用来「被抛出」的对象啦!用这样的对象才能调试嘛~

ReferenceError

当我们在 JavaScript 中使用 JavaScript 不认识的名称时,就会抛出这个对象。当然,因为我们是用 TypeScript 来开发 JavaScript 程序,这个状况并不会很常遇到。

例如:

declare const n: number;

try {
    console.log(n);
} catch (err) {
    console.log(err instanceof ReferenceError);
}

以上程序会输出 true,因为程序第一行只是在 TypeScript 中「假声明」出 n 这个常数。所以程序第四行要访问 n 时会抛出 ReferenceError 对象。

SyntaxError

JavaScript 内置的 eval 函数有一个参数,可以将 JavaScript 代码作为字符串传入,如此一来就能够在程序运行阶段动态地产生并运行 JavaScript 代码。

例如:

try {
    const result = eval(`
        function addOne(x) {
            return x + 1;
        }
    
        addOne(1);
    `);

    console.log(result);
} catch (err) {
    console.log(err instanceof SyntaxError);
}

以上程序会输出 2。

当传进 eval 函数的字符串内的 JavaScript 的语法有错误时,就会抛出这个例外。

例如:

try {
    const result = eval(`
    function addOne(x) {
        return x + 1;
    
    
        addOne(1);
    `);

    console.log(result);
} catch (err) {
    console.log(err instanceof SyntaxError);
}

以上程序会输出 true,因为我们把 addOne 函数的结尾大括号 } 删除了。

TypeError

假如 f 是一个函数,则 f() 叙述可以调用它,但如果 f 不是一个函数,此时用 f() 尝试调用它的话,就会抛出 TypeError 对象;假如 T 是一个类别或是函数,则 new T() 叙述可以创建其对象实体,但如果 T 不是一个类别或是函数,此时用 new T() 叙述尝试创建其对象实体的话,就会抛出 TypeError 对象。当然,因为我们是用 TypeScript 来开发 JavaScript 程序,这个状况并不会很常遇到。

例如:

const T = {
    f1: 1,
    f2: "2",
};

try {
    console.log(new (T as any)());
} catch (err) {
    console.log(err instanceof TypeError);
}

以上程序会输出 true,因为对象 T 只是大括号对象,无法直接被「new」出对象实体。

URIError

JavaScript 内置的 encodeURI 和 decodeURI 函数可以用来安全地编码与解码 URI。

用法如下:

const originalURL = "https://magiclen.org/中文";

const encodedURL = encodeURI(originalURL);

console.log(encodedURL);

const decodedURL = decodeURI(encodedURL);

console.log(decodedURL);

以上程序的输出结果如下:

https://magiclen.org/%E4%B8%AD%E6%96%87
https://magiclen.org/中文

如果只是要编码或解码 URI 的其中一个部件(component),可以使用 JavaScript 内置的 encodeURIComponent 或 decodeURIComponent 函数。

用法如下:

const originalURLComponent = "中文";

const encodedURLComponent = encodeURIComponent(originalURLComponent);

console.log(encodedURLComponent);

const decodedURLComponent = decodeURIComponent(encodedURLComponent);

console.log(decodedURLComponent);

以上程序的输出结果如下:

%E4%B8%AD%E6%96%87
中文

在使用 encodeURI、decodeURI、encodeURIComponent 或 decodeURIComponent 函数时,若输入的参数有误(非正确格式的 URI),就会抛出 URIError 对象。

例如:

try {
    console.log(encodeURI("\uD800"));
} catch (err) {
    console.log(err instanceof URIError);
}

try {
    console.log(decodeURI("%"));
} catch (err) {
    console.log(err instanceof URIError);
}

try {
    console.log(encodeURIComponent("\uD800"));
} catch (err) {
    console.log(err instanceof URIError);
}

try {
    console.log(decodeURIComponent("%"));
} catch (err) {
    console.log(err instanceof URIError);
}

以上程序的输出结果如下:

true
true
true
true

虽然不是很重要,但还是提一下。JavaScript 无法编码含有未成对的 \uD800 ~ \uDFFF 字符的字符串。

而 \u 是 JavaScript 的字符表示方式,其后可以接上 2 个字节长度的 16 进制数值,作为这个字符的字符值。另外还有 \x,可以接上 1 个字节长度的 16 进制数值。

Error

上面介绍的 RangeError、ReferenceError、SyntaxError、TypeError、URIError 都继承自 Error。我们可以把任何不属于上述错误的错误都用 Error 对象来表示。

Error 的构造器可传入一个字符串作为错误描述。如下:

try {
    throw new Error("Something wrong!");
} catch (err) {
    console.log(err);
}

以上程序会输出:

Error: Something wrong!

后面还会接着数行堆栈追踪的信息,用来表示这个 Error 对象是在程序的哪个位置被创建的。

抛出 Error 相关对象时不使用 new 关键字

RangeError、ReferenceError、SyntaxError、TypeError、URIError 和 Error 除了可以被「new」出对象实体之外,也可以直接用调用函数的方式来让它们回传自己的对象实体。

例如:

try {
    throw new Error("Something wrong!");
} catch (err) {
    console.log(err);
}

可以改写成:

try {
    throw Error("Something wrong!");
} catch (err) {
    console.log(err);
}

这样就可以少打几个字啦!

总结

在这个章节中,我们学会了 TypeScript 程序的错误处理方式。下一章要来介绍 ES6 之后加入的神器──产生器(Generator)。

下一章:迭代器(Iterator)与产生器(Generator)。