chrome调试 JavaScript 脚本

时间  2019-11-19
标签 chrome 调试 javascript 脚本 栏目 Chrome 繁體版
原文   原文链接

随着 JavaScript 应用的复杂性逐渐提升，开发者须要有力的调试工具来帮助他们快速发现问题的缘由，而且能高效地修复它。Chrome DevTools 提供了一系列实用的工具使得调试 JavaScript 应用再也不是一件痛苦的事。javascript

在这个部分，咱们会经过调试 Google Closure hovercard demo 以及其余的动态示例来让你了解怎么去使用这些工具。css

注意：若是你是 Web 开发者而且但愿得到最新版的 DevTools，你应该使用 Chrome Canaryhtml

源面板

源面板容许你调试 JavaScript 代码。它提供了 V8 调试器的图形化接口。请经过如下步骤来使用源面板：html5

javascript-debugging-overview

源面板容许你查看正在浏览的页面上全部的脚本。面板底部的图标按钮分别提供了标准的暂停、恢复以及逐条语句运行等操做。窗口底部还有一个按钮，在出现异常时能够强制暂停。在不一样选项卡中，Sources 都是可见的，并且只要点击 show-file-navigator 就能够打开文件定位而且显示所有脚本。java

执行控制

执行控制相关的按钮就在侧面板的顶端，它们使得你可以单步执行代码。可用的按钮有：git

  • continue Continue：继续执行代码，直至遇到另外一个断点。
  • step-over Step over（逐语句）：逐行执行，以了解每一行如何操做当前的变量。当你的代码调用另外一个函数的时候，调试器不会跳到那个函数的代码中去，其焦点仍是当前的函数，而 Step into 则相反。
  • step-into Step into（逐过程）：和逐语句相似，可是点击逐过程会在函数调用时,令调试器将执行转到所调用的函数声明中去。
  • step-out Step out：当使用逐过程进入某个函数内部后，点击该按钮会跳过该函数声明的剩余部分，调试器会将执行过程移动到其父函数中。
  • tonggle breakpoint Toggle breakpoints：切换断点启用、禁用状态，同时保证各自的启用状态不会受到影响。

在源面板中，有许多相关的快捷键可用：angularjs

  • Continue：在Mac上使用 F8 或者 Command + \，其余平台上为 Ctrl+ \。
  • Step over：在Mac上为 F10 或者 Command + '，在其余平台上为 Ctrl + '。
  • Step into：在Mac上为 F11 或者 Command + ;，在其余平台上为 Ctrl + ;。
  • Step out：在Mac上为 Shift + F11 或者 Shift + Command + ;，在其余平台上为 Shift+ Ctrl + ;。
  • Next call frame：Ctrl + .。（适用于全平台）
  • Previous call frame： Ctrl + ,。（适用于全平台）

若是想要查看其余支持的快捷键，请参考 Shortcuts。github

使用断点来调试

断点是在脚本中处于某种目的而中止或者暂停代码运行的地方。在 DevTools 中使用断点能够调试 JavaScript 代码， DOM 更新以及网络调用。web

添加及删除断点

在源面板中，打开一份 JavaScript 文件用于调试。在下面的例子中，咱们调试了来自 AngularJS version of TodoMVC 中的 todoCtrl.js 文件。chrome

sources-select-todoCtrl-js

点击行号前的空格来在那一行设置断点。以后一个蓝色的标记将会出现，这说明断点已经被设置好了：

sources-view-region

你能够添加多个断点。点击其余行行号前的空格就能够继续设置断点，你所设置的所有断点都会在右边的侧栏下 Breakpoints 选项中显示出来。

断点前的复选框能够选择是否启用断点，若是断点被禁用了，那么蓝色的标签会变色。

点击断点的入口能够跳转到源文件中的对应行：

multiple-breakpoints-region

点击蓝色的标签能够删除断点。

右击蓝色标签会打开一个菜单，其中包括：Continue to Here，Remove Breakpoint，Edit Breakpoint 以及 Disable Breakpoint。

continue-to-here-region

想要设置条件断点，选择 Edit Breakpoint ，或者，右键点击行号前的空白而后选择 Add Conditional Breakpoint。在输入域中，能够输入任何可以返回 true 或者 false 的表达式。当条件返回 true 的时候，断点会中断代码的执行。

conditional-breakpoint-region

在你想要分析循环或者常常触发的回调事件的代码时，条件断点是很是有用的。

注意：有时候你可能不须要从 DevTools 接口来设置断点。此时你但愿从代码中来启动调试器，那么你可使用 debugger 关键字来实现这一操做。

使用暂停断点

当你设置了一个或多个断点的时候，返回到浏览器窗口而且与页面进行交互。在下面的例子中，咱们在 removeTodo() 方法中加入了断点。如今任何想要在 TodoMVC 应用中删除 todo 选项的行为都将触发断点：

breakpoint-paused-app

要恢复代码的运行，在 DevTools 窗口中点击 Continue continue 按钮或者使用 F8 键盘快捷键。

当脚本暂停运行的时候，你可使用右边侧栏中的 Watch Expressinos， Call Stack 以及 Scope Variables 面板。

调用栈面板

调用栈面板展现了代码到暂停处的完整执行路径，这让咱们可以深刻代码去找出致使错误的缘由。

callstack-region

若是要查看包括计时器和 XHR 事件在内的异步 JavaScript 回调函数的执行路径，请点击 Async 复选框。

enable-async-toggle

更多关于异步调用栈的信息和示例请参考 HTML5Rocks.com 网页上的 Debuggin Asynchtonous JavaScript with Chrome DevTools

将 JavaScript 文件置于黑盒中

当你把一个 JavaScript 源文件放到黑盒中时，你在调试代码的时候没法跳转到那个文件中了。你能够在你感兴趣的代码尝试一下。

blackboxing-expanded

你可使用设置面板来将脚本文件放入黑盒，或者右键点击 sources 面板中的文件而后选择 Blackbox Script。

blackboxing-dialog

更多关于黑盒的信息请参考 Blackboxing JavaScript file

控制台

DevTools 中的 consle drawer 容许你在调试器当前暂停的位置附近进行试验。点击 Esc 键在视图中打开控制台，再次按 Esc 键就会关闭该控制台。

console

动态 JavaScript 中的断点

  • 在 Sources 面板中脚本的下拉选项中找到 "dynamicScript.js" 而后在第二行设置断点。
  • 此时程序应该在断点处暂停
  • 在 DevTools 窗口中点击 Continue continue 或者按 F8 来继续执行

dynamic-script

提示：注意 dynamicScript.js 文件结尾处的 "//# sourceURL=dynamicScript.js" 这一行。这种方式能够给由 eval 函数建立的脚本命名，更多的信息会在 Source Maps 这一节中说明。只有当用户为动态的 JavaScript 文件提供了名称时才能为其设置断点。

在下一条 JavaScript 语句暂停执行

  • 点击 Pause pause 按钮
  • 将你的鼠标移动到下图中的区域
  • 你的鼠标应该停在 onMouseOver 函数上
  • 点击 Continue continue 按钮或者按 F8** 来继续执行

continue-to-resume

在出现异常处暂停

  • 点击窗口底部的 Pause on exceptions pause-gray 按钮来切换到在异常处暂停模式
  • 勾选 Pause On Caught Exceptinos 复选框
  • 程序应该在 raiseAndCatchException 函数中中止
  • 点击 Continue continue 按钮或者按 F8 来继续执行

append-child

在未捕获的异常处暂停

  • 点击 Pause on exceptions pause 按钮
  • 取消勾选 Pause On Caught Exceptions 复选框
  • 此时若捕获了异常，程序应该不会在 raiseAndCatchExcep 函数处中止
  • 此时应该在 raiseException 函数处中止
  • 点击 Continue continue 按钮或者按 F8 来继续执行

raise-exception

在 DOM 变化事件上的断点

  • 右键点击下面的 "Parent Element" 而且从文本菜单中选择 Inspect Element（审查元素）

    Parent Element
  • 右键点击 Elements 面板元素而后选择 Break on Subtree Modifications
  • 此时应该会在 appendChild 函数调用处中止
  • 点击 Continue continue 按钮或者按 F8 来继续执行

append-child-element

XHR 上的断点

  • 点击 Sources面板右侧的 XHR Breakpoints 边栏上的 Add plus 按钮
  • 在文本输入去输入 "data.txt" 而后单击回车
  • 此时应该在send 函数调用处中止
  • 右键点击新建立的断点而后选择 Remove Breakpoint
  • 点击Devtools 窗口中的 Continue continue 按钮或者按 F8 来继续执行

request-send

提示：要编辑 URL 过滤器，双击 XHR Breakpoints 边栏的 XBR 断点，具备空的 URL 过滤器的 XHR 断点会匹配任何 XHR。

JavaScript 事件监听器上的断点

  • 打开右边 Scripts 面板的 Event Listener Breakpoints 边栏
  • 展开 Mouse 选项
  • 选中 mouseout 前的复选框能够设置 mouseout 事件监听器断点

resumed

  • 将你的鼠标移动到下面的的盒子中
Hover me!
  • 此时应该在 mouseout 事件处理器处中止
  • 点击 Continue continue 按钮或者按 F8 来继续执行

continue-to-resume-1

提示：下列事件是支持的
 Keyboard：松开按键，按下按键，输入文字
 Mouse：点击，双击，鼠标键按下，鼠标键松开，鼠标悬浮，鼠标移动，鼠标从元素上离开。
 Control：从新设置大小，滚动，缩放，焦点，失焦，选择，变化，重置  Clipboard：复制，剪切，粘贴，beforecopy，beforecut，beforepaste  Load：加载，卸载，废除，出错。  DOM Mutation：DOMActivate，DOMFocusin,DOMAttrModified，DOMCharacterDataModified，DOMNodeInserted，DOMNodeInsertedIntoDocument，DOMNodeRemoved，DOMNodeRemovedFromDocument，DOMSubtreeModified，DOMContentLoaded  Device：面向设备，设备运动。

长按恢复执行

当暂停的时候，点击而且不放开恢复按钮可让 ”全部的暂停都阻塞 500 毫秒后恢复“。这会让全部的断点在半秒内都没法使用，可使用该方法进入到下一个循环中，这样就能够避免为了退出循环而不断让断点继续执行。

专业建议：当使用 DevTools 启动“刷新”的时候（焦点在 DevTools 的时候使用 Ctrl + R），所有暂停都会被禁用，直到新的页面开始加载（或者做为备用方案，直到用户按下 “Pause” 按钮）。然而，若是你从浏览器的按钮来启动刷新操做的时候（或者当焦点在 DevTools 以外的时候使用 Ctrl + R），将会命中全部剩余的断点。这实际上可对那些对页面卸载过程感兴趣的人很是有用。

long-resume

实时编辑

在创做和工做流章节中，咱们讨论了怎么经过 Source 面板来对脚本进行修改。在断点处，一样也能够经过点击主编辑面板来作出修改，而且可以实时修改脚本文件。

  • 定位到 Google Closure hovercard demo
  • 在源面板中，打开 “mouse.js” 而后使用 Ctrl/Cmd + Shift + O 来定位到 onMouseOut() 函数

houseMouseOut

  • 点击暂停按钮来暂停调试
  • 修改函数，在末尾加入 console.log('Moused out')
  • 使用 Cmd + S 或者 Ctrl + S 快捷键能够保存更改，记得确认是否保存
  • 点击 pause/resume 按钮来恢复执行
  • 当你的鼠标离开相关位置的时候，控制台会输出信息

pause-resume-mouseout

这容许你在不退出浏览器的状况下经过使用 DevTools 来保存修改的内容。

异常

让咱们如今来看一下怎么处理异常以及如何利用 Chrome 的 DevTools 使用堆栈追踪。 异常处理是对于出现的异常的响应 - 除了有些须要特定处理过程的状况 - 而且通常会改变 JavaScript 代码执行的正常流程。

注意：若是是 Web 开发者而且但愿得到最新版的 DevTools，你须要使用 Chrome Canary

追踪异常

当程序出现异常的时候，你能够打开 DevTools 控制台（Ctrl + Shift + J/Cmd + Option + J），而后你会发现有许多 JavaScript 出错信息。每条信息都指出了相应的文件名以及行号，你能够经过这些信息来定位到源代码中的相关位置。

tracking-exceptions

查看异常追踪栈

致使出错的执行路径可能会有多条，而且到底是哪一条出现了错误并不明显。只要 DevTools 窗口是打开的，控制台中出现的异常情况都会伴随着完整的 JavaScript 调用堆栈而出现。你能够展开这些控制台信息来查看堆栈信息并定位到代码中的相应位置：

exception-stack-trace

在 JavaScript 出现异常时暂停

你可能但愿下一次 JavaScript 发生异常的时候可以暂停 JavaScript 的执行并查看它的调用堆栈、范围变量以及应用程序的状态。Script 面板底部的暂停按钮（pause-gray-1）容许你在不一样的异常处模式之间切换，且该按钮具备三种状态：你能够选择在全部的异常发生时都暂停程序运行或者只是在未捕获的异常发生时暂停程序运行或者是忽视全部的异常。

pause-execution

打印堆栈信息

在 DevTools 中输出的日志信息对于理解应用程序的执行过程很是有帮助，你能够在日志信息中包括相关联的堆栈跟踪信息来使它更加有用。想要作到这一点有多种方式。

Error.stack

每一个 Error 对象都有一个名为 stack 的字符串属性，该字符串包含了堆栈跟踪信息：

error-stack

console.trace()

你可使用 concole.trace() 方法来输出当前 JavaScript 调用堆栈，这种方法能够用于检测代码：

console-trace

console.assert()

将 assertion 加入到你的代码中也是一种不错的方法。只要调用 console.assert() 方法并将错误状况做为第一个参数便可，每当表达式的计算结果为 false 时你就会看到相应的控制台记录：

console-assert

在运行时使用 window.onerror 来处理异常

Chrome 支持将一个处理函数设置为 window.onerror。每当一个 JavaScript 异常在窗口上下文中抛出而且没有被任何的 try/catch 块捕获的时候，该方法就会被调用。同时，异常信息、抛出异常的文件 URL 以及出现异常的位置在文件中的行号会按照上面的顺序做为三个参数传给该方法。你可能以为像这样设置一个可以收集未捕获异常信息而且能将其报告给服务器的错误处理器很是方便。

window-onerror

美化输出格式

若是你在阅读以及调试某些过于简化的 JavaScript 代码有麻烦的时候，有一个美化输出格式的选项可让这些过程更轻松。下面是一份简化过头的脚本文件在 DevTools 中可能显示出的样子：

pretty-print-off

若是点击左边底部的花括号 prettyprint-icon 图标，该 JavaScript 就会转换为更具可读性的格式。这种格式对调试和设置断点也至关方便。

pretty-print-on

源映射（Source Maps）

你是否指望过你的客户端代码可以保持可读性而且适合调试，甚至是你在合并以及缩小代码以后也能这样吗？那么，如今你能够感觉源映射的魔力了。

一个基于 JSON 格式的源映射建立了一种缩小后的代码和源代码之间的关系。

下面一种简单的源映射的示例：

{
    version : 3,
    file: "out.min.js",
    sourceRoot : "",
    sources: ["foo.js", "bar.js"],
    names: ["src", "maps", "are", "fun"],
    mappings: "AAgBC,SAAQ,CAAEA"
  }

源映射是指，当你为了构建产品而缩小及合并 JavaScript 文件的时候，产生拥有源文件信息的一种映射。源映射会让 DevTools 去加载你的源文件，而不是缩小后的文件。因而你可使用源文件来设置断点以及调试代码。同时，Chrome 实际运行的是缩小后的代码。这就让你感受像是在运行源文件通常。

使用源映射

使用正确的缩小器

你须要使用可以建立源映射的缩小器来缩小你的代码。Closure 编译器以及 UglifyJS 2.0 就是两款这样的工具，固然，也有其余的不少支持 CoffeeScript， SASS 等源映射的工具。具体能够参考维基百科的页面 Source maps: languages, tools and other info。

设置 DevTools

默认状况下，资源映射（Sourcemap）是启用的（Chrome 39 就是这样），若是你想仔细检查或者单独启用它，先打开 DevTools 而后点击设置图标 gear。在 Sources 选项下，查看 Enable javaScript source maps。你也能够检查 Enable CSS source maps，不过在这个例子中你并不须要这么作。

source-maps

让源映射（Source Map）可访问

若是要让 DevTools 知道某个源映射是可用的，请验证缩小后的文件最后一行的代码是否是下面这样。

//# sourceMappingURL=/path/to/file.js.map

这一行一般是由生成映射的工具添加的，而且可以让 DevTools 创建缩小后的文件和源文件之间的联系。在 CSS 中，这一行多是这样的： /# sourceMappingURL=style.css.map /.

若是你不但愿文件中有额外的注释，你可使用 JavaScript 文件中的 HTTP 头来告诉 DevTools 源文件在哪里。这须要设置或者自定义 web 服务器，而且该内容超出了本篇教程的目标。

X-SourceMap: /path/to/file.js.map

和注释相似，该代码一样告诉 DevTools 到哪里去寻找源文件并和相应 JavaScript 文件创建关联。这个头部信息也用于解决引用源映射的语言并不支持单行注释的问题。

你也应该检查你的 web 服务器是否设置好了对资源映射的支持。有些服务器，须要对每种文件都作出明确的配置，好比 Google App Engine。在这种状况下，你的源映射应该设置将 MIME 类型设置为 application/json，不过 Chrome 浏览器会接受任何类型的类容声明，好比 application/octet-stream。

请看一下 Chrome 中特别构建的 font dragr tool，当源映射启用的时候，你将会注意到 JavaScript 文件并无被编译，而且你能够看到全部被引用的 JavaScript 文件。这使用了源映射，可是后台实际运行的是编译后的代码。任何的错误、日志以及断点都会映射到开发代码中，这使得调试变得更为容易。实际上你的感受就像是你在运行开发中的代码同样。

活动中的 @sourceURL 以及 displayName

源映射声明的下列部分，并不会令你在使用 evals 函数来开发时有多轻松。

这个帮助器（@sourceURL）看起来相似于 //# sourceMappingURL 属性，而且其实是在源映射 V3 规范中说起的。在你的代码中包含下面这些特殊的注释，你能够为 eval 函数及内嵌的脚本和样式命名，这样他们在你的开发工具中显示的时候就能够拥有逻辑名称。

//# sourceURL=source.coffee

使用 sourceURL

  • 定位到 demo
  • 打开 DevTools 并找到 Sources 面板
  • 输入一个名称来为你的代码命名
  • 点击 compile 按钮
  • CoffeeScript 源文件会计算总值而且经过警告来输出
  • 若是你打开 Sources 的子面板，你将会看到一个拥有你以前输入的文件名的新文件。若是你双击该文件来查看详细内容，会发现该文件中含有初始源文件编译后的 JavaScript。在最后一行会有 // @sourceURL 注释，该注释代表了源文件是什么。这在经过语言抽象来调试时具备很大的帮助。

coffeescript

 

from: http://wiki.jikexueyuan.com/project/chrome-devtools/debugging-javascript.html

相关文章
相关标签/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公众号
   欢迎关注本站公众号,获取更多信息
联系我们 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程