电脑在运行程序的时候,经常会遇到预期的或是非预期的错误,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");
以上程序的输出结果如下:
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");
以上程序的输出结果如下:
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/中文
如果只是要编码或解码 URI 的其中一个部件(component),可以使用 JavaScript 内置的 encodeURIComponent 或 decodeURIComponent 函数。
用法如下:
const originalURLComponent = "中文";
const encodedURLComponent = encodeURIComponent(originalURLComponent);
console.log(encodedURLComponent);
const decodedURLComponent = decodeURIComponent(encodedURLComponent);
console.log(decodedURLComponent);
以上程序的输出结果如下:
中文
在使用 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
虽然不是很重要,但还是提一下。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 对象是在程序的哪个位置被创建的。
抛出 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)。
