JavaScript错误处理和堆栈追踪浅析

Dalek 7年前
   <p>有时我们会忽略错误处理和堆栈追踪的一些细节, 但是这些细节对于写与测试或错误处理相关的库来说是非常有用的. 例如这周, 对于 Chai 就有一个非常棒的PR, 该PR极大地改善了我们处理堆栈的方式, 当用户的断言失败的时候, 我们会给予更多的提示信息(帮助用户进行定位).</p>    <p style="text-align:center"><img src="https://simg.open-open.com/show/e4821b86bfdf3d6e826cbee997ea70db.jpg"></p>    <p>合理地处理堆栈信息能使你清除无用的数据, 而只专注于有用的数据. 同时, 当更好地理解 Errors 对象及其相关属性之后, 能有助于你更充分地利用  Errors .</p>    <h2>(函数的)调用栈是怎么工作的</h2>    <p>在谈论错误之前, 先要了解下(函数的)调用栈的原理:</p>    <p>当有一个函数被调用的时候, 它就被压入到堆栈的顶部, 该函数运行完成之后, 又会从堆栈的顶部被移除.</p>    <p>堆栈的数据结构就是后进先出, 以 LIFO (last in, first out) 著称.</p>    <p>例如:</p>    <pre>  <code class="language-javascript">function c() {      console.log('c');  }    function b() {      console.log('b');      c();  }    function a() {      console.log('a');      b();  }    a();</code></pre>    <p>在上述的示例中, 当函数 a 运行时, 其会被添加到堆栈的顶部. 然后, 当函数  b 在函数  a 的内部被调用时, 函数  b 会被压入到堆栈的顶部. 当函数  c 在函数  b 的内部被调用时也会被压入到堆栈的顶部.</p>    <p>当函数 c 运行时, 堆栈中就包含了  a ,  b 和  c (按此顺序).</p>    <p>当函数 c 运行完毕之后, 就会从堆栈的顶部被移除, 然后函数调用的控制流就回到函数  b . 函数  b 运行完之后, 也会从堆栈的顶部被移除, 然后函数调用的控制流就回到函数  a . 最后, 函数  a 运行完成之后也会从堆栈的顶部被移除.</p>    <p>为了更好地在demo中演示堆栈的行为, 可以使用 console.trace() 在控制台输出当前的堆栈数据. 同时, 你要以从上至下的顺序阅读输出的堆栈数据.</p>    <pre>  <code class="language-javascript">function c() {      console.log('c');      console.trace();  }    function b() {      console.log('b');      c();  }    function a() {      console.log('a');      b();  }    a();</code></pre>    <p>在 Node 的 REPL 模式中运行上述代码会得到如下输出:</p>    <pre>  <code class="language-javascript">Trace      at c (repl:3:9)      at b (repl:3:1)      at a (repl:3:1)      at repl:1:1 // <-- For now feel free to ignore anything below this point, these are Node's internals      at realRunInThisContextScript (vm.js:22:35)      at sigintHandlersWrap (vm.js:98:12)      at ContextifyScript.Script.runInThisContext (vm.js:24:12)      at REPLServer.defaultEval (repl.js:313:29)      at bound (domain.js:280:14)      at REPLServer.runBound [as eval] (domain.js:293:12)</code></pre>    <p>正如所看到的, 当从函数 c 中输出时, 堆栈中包含了函数  a ,  b 以及 c .</p>    <p>如果在函数 c 运行完成之后, 在函数  b 中输出当前的堆栈数据, 就会看到函数  c 已经从堆栈的顶部被移除, 此时堆栈中仅包括函数  a 和  b .</p>    <pre>  <code class="language-javascript">function c() {      console.log('c');  }    function b() {      console.log('b');      c();      console.trace();  }    function a() {      console.log('a');      b();  }</code></pre>    <p>正如所看到的, 函数 c 运行完成之后, 已经从堆栈的顶部被移除.</p>    <pre>  <code class="language-javascript">Trace      at b (repl:4:9)      at a (repl:3:1)      at repl:1:1  // <-- For now feel free to ignore anything below this point, these are Node's internals      at realRunInThisContextScript (vm.js:22:35)      at sigintHandlersWrap (vm.js:98:12)      at ContextifyScript.Script.runInThisContext (vm.js:24:12)      at REPLServer.defaultEval (repl.js:313:29)      at bound (domain.js:280:14)      at REPLServer.runBound [as eval] (domain.js:293:12)      at REPLServer.onLine (repl.js:513:10)</code></pre>    <h2>Error对象和错误处理</h2>    <p>当程序运行出现错误时, 通常会抛出一个 Error 对象.  Error 对象可以作为用户自定义错误对象继承的原型.</p>    <p>Error.prototype 对象包含如下属性:</p>    <ul>     <li>constructor –指向实例的构造函数</li>     <li>message –错误信息</li>     <li>name –错误的名字(类型)</li>    </ul>    <p>上述是 Error.prototype 的标准属性, 此外, 不同的运行环境都有其特定的属性. 在例如 Node, Firefox, Chrome, Edge, IE 10+, Opera 以及 Safari 6+ 这样的环境中,  Error 对象具备  stack 属性, 该属性包含了错误的堆栈轨迹. 一个错误实例的堆栈轨迹包含了自构造函数之后的所有堆栈结构.</p>    <p>为了抛出一个错误, 必须使用 throw 关键字. 为了  catch 一个抛出的错误, 必须使用  try...catch 包含可能跑出错误的代码. Catch的参数是被跑出的错误实例.</p>    <p>如 Java 一样, JavaScript 也允许在 try/catch 之后使用  finally 关键字. 在处理完错误之后, 可以在  finally 语句块作一些清除工作.</p>    <p>在语法上, 你可以使用 try 语句块而其后不必跟着  catch 语句块, 但必须跟着  finally 语句块. 这意味着有三种不同的  try 语句形式:</p>    <ul>     <li>try...catch</li>     <li>try...finally</li>     <li>try...catch...finally</li>    </ul>    <p>Try语句内还可以在嵌入 try 语句:</p>    <pre>  <code class="language-javascript">try {      try {          throw new Error('Nested error.'); // The error thrown here will be caught by its own `catch` clause      } catch (nestedErr) {          console.log('Nested catch'); // This runs      }  } catch (err) {      console.log('This will not run.');  }</code></pre>    <p>也可以在 catch 或  finally 中嵌入  try 语句:</p>    <pre>  <code class="language-javascript">try {      throw new Error('First error');  } catch (err) {      console.log('First catch running');      try {          throw new Error('Second error');      } catch (nestedErr) {          console.log('Second catch running.');      }  }</code></pre>    <pre>  <code class="language-javascript">try {      console.log('The try block is running...');  } finally {      try {          throw new Error('Error inside finally.');      } catch (err) {          console.log('Caught an error inside the finally block.');      }  }</code></pre>    <p>需要重点说明一下的是在抛出错误时, 可以只抛出一个简单值而不是 Error 对象. 尽管这看起来看酷并且是允许的, 但这并不是一个推荐的做法, 尤其是对于一些需要处理他人代码的库和框架的开发者, 因为没有标准可以参考, 也无法得知会从用户那里得到什么. 你不能信任用户会抛出  Error 对象, 因为他们可能不会这么做, 而是简单的抛出一个字符串或者数值. 这也意味着很难去处理堆栈信息和其它元信息.</p>    <p>例如:</p>    <pre>  <code class="language-javascript">function runWithoutThrowing(func) {      try {          func();      } catch (e) {          console.log('There was an error, but I will not throw it.');          console.log('The error\'s message was: ' + e.message)      }  }    function funcThatThrowsError() {      throw new TypeError('I am a TypeError.');  }    runWithoutThrowing(funcThatThrowsError);</code></pre>    <p>如果用户传递给函数 runWithoutThrowing 的参数抛出了一个错误对象, 上面的代码能正常捕获错误. 然后, 如果是抛出一个字符串, 就会碰到一些问题了:</p>    <pre>  <code class="language-javascript">function runWithoutThrowing(func) {      try {          func();      } catch (e) {          console.log('There was an error, but I will not throw it.');          console.log('The error\'s message was: ' + e.message)      }  }    function funcThatThrowsString() {      throw 'I am a String.';  }    runWithoutThrowing(funcThatThrowsString);</code></pre>    <p>现在第二个 console.log 会输出undefined. 这看起来不是很重要, 但如果你需要确保  Error 对象有一个特定的属性或者用另一种方式来处理  Error 对象的特定属性(例如  Chai的throws断言 的做法), 你就得做大量的工作来确保程序的正确运行.</p>    <p>同时, 如果抛出的不是 Error 对象, 也就获取不到  stack 属性.</p>    <p>Errors 也可以被作为其它对象, 你也不必抛出它们, 这也是为什么大多数回调函数把 Errors 作为第一个参数的原因. 例如:</p>    <pre>  <code class="language-javascript">const fs = require('fs');    fs.readdir('/example/i-do-not-exist', function callback(err, dirs) {      if (err instanceof Error) {          // `readdir` will throw an error because that directory does not exist          // We will now be able to use the error object passed by it in our callback function          console.log('Error Message: ' + err.message);          console.log('See? We can use Errors without using try statements.');      } else {          console.log(dirs);      }  });</code></pre>    <p>最后, Error 对象也可以用于 rejected promise, 这使得很容易处理 rejected promise:</p>    <pre>  <code class="language-javascript">new Promise(function(resolve, reject) {      reject(new Error('The promise was rejected.'));  }).then(function() {      console.log('I am an error.');  }).catch(function(err) {      if (err instanceof Error) {          console.log('The promise was rejected with an error.');          console.log('Error Message: ' + err.message);      }  });</code></pre>    <h2>处理堆栈</h2>    <p>这一节是针对支持 Error.captureStackTrace 的运行环境, 例如Nodejs.</p>    <p>Error.captureStackTrace 的第一个参数是  object , 第二个可选参数是一个  function .  Error.captureStackTrace 会捕获堆栈信息, 并在第一个参数中创建  stack 属性来存储捕获到的堆栈信息. 如果提供了第二个参数, 该函数将作为堆栈调用的终点. 因此, 捕获到的堆栈信息将只显示该函数调用之前的信息.</p>    <p>用下面的两个demo来解释一下. 第一个, 仅将捕获到的堆栈信息存于一个普通的对象之中:</p>    <pre>  <code class="language-javascript">const myObj = {};    function c() {  }    function b() {      // Here we will store the current stack trace into myObj      Error.captureStackTrace(myObj);      c();  }    function a() {      b();  }    // First we will call these functions  a();    // Now let's see what is the stack trace stored into myObj.stack  console.log(myObj.stack);    // This will print the following stack to the console:  //    at b (repl:3:7) <-- Since it was called inside B, the B call is the last entry in the stack  //    at a (repl:2:1)  //    at repl:1:1 <-- Node internals below this line  //    at realRunInThisContextScript (vm.js:22:35)  //    at sigintHandlersWrap (vm.js:98:12)  //    at ContextifyScript.Script.runInThisContext (vm.js:24:12)  //    at REPLServer.defaultEval (repl.js:313:29)  //    at bound (domain.js:280:14)  //    at REPLServer.runBound [as eval] (domain.js:293:12)  //    at REPLServer.onLine (repl.js:513:10)</code></pre>    <p>从上面的示例可以看出, 首先调用函数 a (被压入堆栈), 然后在  a 里面调用函数  b (被压入堆栈且在 a 之上), 然后在  b 中捕获到当前的堆栈信息, 并将其存储到  myObj 中. 所以, 在控制台输出的堆栈信息中仅包含了  a 和  b 的调用信息.</p>    <p>现在, 我们给 Error.captureStackTrace 传递一个函数作为第二个参数, 看下输出信息:</p>    <pre>  <code class="language-javascript">const myObj = {};    function d() {      // Here we will store the current stack trace into myObj      // This time we will hide all the frames after `b` and `b` itself      Error.captureStackTrace(myObj, b);  }    function c() {      d();  }    function b() {      c();  }    function a() {      b();  }    // First we will call these functions  a();    // Now let's see what is the stack trace stored into myObj.stack  console.log(myObj.stack);    // This will print the following stack to the console:  //    at a (repl:2:1) <-- As you can see here we only get frames before `b` was called  //    at repl:1:1 <-- Node internals below this line  //    at realRunInThisContextScript (vm.js:22:35)  //    at sigintHandlersWrap (vm.js:98:12)  //    at ContextifyScript.Script.runInThisContext (vm.js:24:12)  //    at REPLServer.defaultEval (repl.js:313:29)  //    at bound (domain.js:280:14)  //    at REPLServer.runBound [as eval] (domain.js:293:12)  //    at REPLServer.onLine (repl.js:513:10)  //    at emitOne (events.js:101:20)</code></pre>    <p>当将函数 b 作为第二个参数传给  Error.captureStackTraceFunction 时, 输出的堆栈就只包含了函数  b 调用之前的信息(尽管  Error.captureStackTraceFunction 是在函数  d 中调用的), 这也就是为什么只在控制台输出了  a . 这样处理方式的好处就是用来隐藏一些与用户无关的内部实现细节.</p>    <h2>参考</h2>    <p><a href="/misc/goto?guid=4959740739542268936" rel="nofollow,noindex">JavaScript Errors and Stack Traces in Depth</a></p>    <p> </p>    <p>来自:http://developer.51cto.com/art/201703/534093.htm</p>    <p> </p>