网站最合适的字体大小大连装修公司

当前位置： 首页 > news >正文

网站最合适的字体大小,大连装修公司,门户网站开发技术服务合同,中体建设集团门户登录本文由体验技术团队屈金雄原创。 Node.js 是一个开源的、跨平台的 JavaScript 运行时环境#xff0c;它允许开发者在服务器端运行 JavaScript 代码。Node.js 是基于 Chrome V8引擎构建的#xff0c;专为高性能、高并发的网络应用而设计#xff0c;广泛应用于构建服务器端应…本文由体验技术团队屈金雄原创。 Node.js 是一个开源的、跨平台的 JavaScript 运行时环境它允许开发者在服务器端运行 JavaScript 代码。Node.js 是基于 Chrome V8引擎构建的专为高性能、高并发的网络应用而设计广泛应用于构建服务器端应用程序、网络应用、命令行工具等。 本系列将分为9篇文章为大家介绍 Node.js 技术原理从调试能力分析到内置模块新增从性能分析工具 perf_hooks 的用法到 Chrome DevTools 的性能问题剖析再到 ABI 稳定的理解、基于 V8 封装 JavaScript 运行时、模块加载方式探究、内置模块外置以及 Node.js addon 的全面解读等主题每一篇都干货满满。 本文内容为本系列第1篇以下为正文内容。 inspector 是什么 直接取官方文档中对 inspector 的定义 The node:inspector module provides an API for interacting with the V8 inspector. 翻译过来就是inspector 模块提供了一组用于和 V8 inspector 交互的 API 。 解读 node inspector 是 Node.js 内置模块node inspector 仅提供与 V8 inspector 交互的能力其本身并没有调试能力Node.js 调试能力来自 V8 inspector Node.js 调试原理 调试的目的是通过观察运行时数据来定位问题。Node.js 的运行时数据由 V8 引擎管理为了实现调试功能V8封装了一套 api 供外部查看运行时数据这套 api 名字就是 V8 inspector运行时是一个 websocket 服务。V8 inspector 由于调试协议不同不能直接与 Chrome DevTools 交互于是 Node.js 提供了 inspector 模块运行时也会启动一个 websocket 服务用于适配。 如图所示进入 Node.js 调试模式前主线程需要创建一个 debugger server websocket 服务即时通讯服务也即 node inspector 用来实现 debugger client例如 vscode 调试器或 Chrome DevTools 与 V8 inspector 通信V8 inspector 再获取 Node.js 服务的数据最终实现单步调试等功能。 经过封装与简化后launch 模式启动调试时我们甚至感知不到 debugger server 了但是它一定是存在的。 深入分析 – inspect 参数 分析过程中我对相关源码做了粗读除了源码本身还参考了这篇文章:https://theanarkh.github.io/understand-nodejs/chapter24-Inspector/#11 本文使用的 Node.js 源码是 18.20.2 如上图所示表示的是 Node.js 调试模式启动过程大部分节点都是中文表述函数名。 当我们用 node –inspect test.js 启动一个 js 脚本时程序会启动 debugger server一个 websocket 服务。如上图所示相关逻辑都在初始化 inspector 部分蓝色节点接下来细看一下这部分代码。 下图的起始节点 server.Start() 函数就是上图的末端节点 server.Start()。
图中每一个节点都对应一个函数。无需理解所有节点我们重点关注着色的几个节点。 1.第一个蓝色节点 当我们运行 node –inspect test.js 命令可以看到如下打印打印的内容 Node.js 开发者一定都很熟悉。 Debugger listening on ws://127.0.0.1:9229/43b86c7c-e538-4d5c-98ba-3f5196d8e986 For help, see: https://nodejs.org/en/docs/inspector// 这一行是Node开发者写的业务代码的打印 Server running at http://127.0.0.1:3000/这个蓝色节点已经是启动代码执行的最后一步了第一个橙色节点之后的部分在处理连接请求也就是说当代码走到第一个蓝色节点时已经成功启动了一个 websocket 服务。 通过前面的代码还能看出这个 websocket 服务在新起的子线程上运行正因如此调试程序才可以在主线程出现异常而崩溃的情况下记录发送异常信息数据。 2.第一个橙色节点 注意这个节点代表一个回调函数这个函数在服务启动时并没有执行。 它的执行是由 debugger client例如 vscode 调试器或 Chrome DevTools 发起的 http 请求触发的这次是client发起的第一次请求。 这次请求对 vscode 调试器来说就是它的 attach 模式 launch模式是把启动和连接操作合并了对Chrome DevTools 来说感觉上应该是通过轮询连接的这个点暂时就不再深入研究了。 3.第二个橙色节点 client 紧接着会发第二次请求未确认请求头会携带 upgrade websocket 信息。这时会触发第二个橙色节点处的回调函数当识别到是升级请求时debugger server 才真正升级为 websocket 服务。 4.第二个蓝色节点 升级完成后控制台会打印“Debugger attached.”这也是我们调试时常见的控制台打印信息。 接下来debugger server 就可以正常处理业务请求了。 5.特别关注一下红色节点 这里的代码就可以看出debugger client 与 debugger server 建立连接的过程中debugger server 与 V8 inspector 建立了连接。 其实整个初始化 inspector启动 debugger server 的过程是一套完整 websocket 实现可以作为一个整体来看待。早期 Socket.io 模块是内置在 Node.js 中的。 – inspect-brk 参数 –inspect-brk 命令可以在用户代码启动前中断相当于在用户代码的第一行打了个断点。 如下图所示我们用 node –inspect-brk test.js 命令启动服务。可以看到只有 debugger server 启动成功的提示没有 node 服务启动成功的提示。这是因为在执行用户代码前停住了。 这个命令在我们想要研究或调试 node 代码启动又不知道研究对象启动入口位置时比较有用 启动 debugger server 后我们用连接上这时可以看到执行停在了业务代码的第一行而这一行我们并没有设置断点如下图所示。
– inspect-wait 参数 这是 node 20 版本新增的启动参数用于等待调试器连接后再执行代码。这样就可以从执行一开始就开始调试。 Node.js 三种常见的调试方式 本节的介绍没有像其他网络教程那样手把手step by step 地写清楚操作步骤是因为有讲调试原理。 初学者理解本节的前提是先看懂调试原理。 一、vscode 调试 vscode 调试是 Node.js 开发者最推荐的调试方式因为可以一键启动调试模式可以不用像 Chrome DevTools 调试那样起额外的窗口。 vscode 调试 Node.js 分为 launch 和 attach 两种模式这里先介绍一下 launch 模式。 launch 模式调试 Node.js 1.创建一个 Node.js 服务就是 test.js 文件内容如下 const { createServer } require(node:http);const hostname 127.0.0.1; const port 3000;const server createServer((req, res) { res.statusCode 200; res.setHeader(Content-Type, text/plain);res.end(Hello World); });server.listen(port, hostname, async () {console.log(Server running at http://\({hostname}:\){port}/); });2.在 Node.js 服务入口文件所在的目录点击 create a launch.json file 按钮然后选择 Node.js 选项这是选择调试器vscode 会自动创建一个 launch.json 文件。 launch.json 文件内容如下本场景就直接用自动生成的不需要作任何改动。 configurations 下的 request 字段表示的就是我们前面提到的调试模式默认使用 launch 模式name 表示这一套配置的名称默认名称是 Launch Program下一步会用到该名称program 表示项目启动的入口文件。更多调试配置参考 vscode官网 {// Use IntelliSense to learn about possible attributes. // Hover to view descriptions of existing attributes. // For more information, visit: https://go.microsoft.com/fwlink/?linkid830387 version: 0.2.0, configurations: [{type: node,request: launch,name: Launch Program,skipFiles: [// node_internals/],program: ${workspaceFolder}\test.js}] }如果用如上文件屏蔽12行设置了不跳过内部代码还可以调试到Node.js的JS源码。 如下图所示打断点并选择 Launch Program然后点击绿色三角启动调试。 attach 模式调试 Node.js 顾名思义这个模式不会触发 Node.js 和 debugger server 的启动只会作为 debugger client 附加到已经启动的 Node.js 服务和debugger server 上。如果能理解前面讲的调试原理这里就很好理解了。 1.首先我们要运行 node –inspect test.js这是在启动 debugger server。 同时启动的还有 node 服务也就是图中的 http://127.0.0.1:3000。 2.在 launch.json 文件中添加 attach 模式配置 port 字段表示要连接到的 debugger server 的端口号也就是我们上一步的 9229。 address 字段表示 debugger server 的地址也就是上一步的 ws://127.0.0.1debugger server 在本地的话可以省略该配置。 {// Use IntelliSense to learn about possible attributes. // Hover to view descriptions of existing attributes. // For more information, visit: https://go.microsoft.com/fwlink/?linkid830387 version: 0.2.0, configurations: [{type: node,request: launch,name: Launch Program,skipFiles: [node_internals/],program: ${workspaceFolder}\test.js},{type: node,request: attach,name: Attach Program,port: 9229,// address: localhost,},] }3.上一步添加完 Attach Program 配置后多了一个启动选项如下图所示。选择 Attach Program然后点击绿色三角按钮启动调试即可连接上第一步启动的 debugger server。 远程调试 attach模式本地调试不常用通常用于远程调试。目前vscode官方提供了两种远程调试方案 使用远程开发扩展包官方推荐 这个方案不仅能远程调试还能用于远程开发比如我们有时可能需要在本地Windows机器上编辑远程的Linux服务器上的项目。但是要安装一系列插件有些复杂 attach模式连接远程 debugger server 在前文的attach模式配置中加一个address字段填上远程debugger server的IP地址即可。 二、Chrome DevTools 调试 当我们理解了 Node.js 调试原理Chrome DevTools 调试就变得手到擒来。 1.首先我们还是要运行 node –inspect test.js这是在启动 debugger server。 同时启动的还有 node 服务也就是图中的 http://127.0.0.1:3000 2.接下来再打开 chrome 控制台就能看见 Node.js 的图标。注意没有启动 debugger server 的时候图标是不会出现的。点击它就可以打开 Chrome DevTools。 3.首次打开 DevTools 时需要在 Connection tab 页配置准备连接的 debugger server。 可以看到 DevTools 自带了两个地址如果是 debugger server 是在本地启动并且使用的是默认的 9229 端口就不需要添加连接地址了。 4.DevTools 连接 debugger server 之前有过介绍vscode 连接 debugger server 需要用 attach 模式启动调试。 DevTools 这边在完成配置后不需要任何操作就能自动连上 debugger server。大概是因为 DevTools 会轮询所配置的地址。 连接成功后会触发node服务打印“Debugger attached.”提示语。 5.开始调试 我们切到 Sources tab 页发现已经有了要调试的代码。在需要的位置打断点再触发断点即可调试。 例如下图中断点位置的代码是请求处理代码我们只需要访问一下 http://127.0.0.1:3000 这个地址即可触发断点。 三、命令行调试 命令行调试是没有客户端之前的方式现在一般不用但是如果需要在不方便使用前面介绍的两种方式的情况下例如需要在服务器本地调试可以用命令行调试。 我们把命令的双横杠去掉也就是运行 node inspect test.js 命令结果如下图所示 我们进入到了Node.js的命令行调试模式具体的用法参考官方文档的 Debug部分。 接下来贴一些常用命令用法 步进# cont, c继续执行next, n下一步steps 进入方法内部out, o退出当前方法pause暂停正在运行的代码类似开发者工具中的暂停按钮 断点# setBreakpoint(), sb()在当前行设置断点setBreakpoint(line), sb(line)在特定行设置断点setBreakpoint(‘fn()’), sb(…)在函数主体的第一个语句上设置断点setBreakpoint(‘script.js’, 1), sb(…)在第一行设置断点 script.jssetBreakpoint(‘script.js’, 1, ‘num 4’), sb(…)在第一行设置条件断点script.js仅当num 4 计算结果为trueclearBreakpoint(‘script.js’, 1), cb(…)清除script.js 第一行的断点 信息# backtrace, bt打印当前调用栈 list(5)列出脚本源代码以及 5 行上下文前后 5 行 watch(expr)将表达式添加到观察列表注意表达式需用引号括起来如watch(“test2”) unwatch(expr)从观察列表中删除表达式 unwatch(index)从观察列表中删除特定索引处的表达式 watchers列出所有观察者及其值每个断点上自动列出 repl打开调试器的 repl在调试脚本的上下文中查看数据或表达式 exec expr, p expr在调试脚本的上下文中执行表达式并打印其值 profile启动 CPU profiling session profileEnd停止当前 CPU profiling session profiles列出所有已完成的 CPU profiling session profiles[n].save(filepath ‘node.cpuprofile’)将 CPU profiling session以 JSON 格式保存到磁盘 takeHeapSnapshot(filepath ‘node.heapsnapshot’)获取堆快照并以 JSON 格式保存到磁盘
注意一下repl命令可以进入断点所在上下文方便地查看数据或表达式 inspector 模块的 API Node.js 的 inspector 模块提供了一组 API用于在运行时与 V8 引擎进行交互调试和分析 Node.js 应用程序。 这些 API 使开发者可以通过编程方式启动调试会话、设置断点、执行调试命令、收集性能数据等。 这里仅详细介绍两个方法 1.inspector.Session 类的 post 方法可以向 v8 inspector 发送消息指令获取各种信息。v8 inspector 能识别的指令可以在 Chrome DevTools Protocol 中查看 贴一份官网的示例对该类的能力可见一斑。 import { Session } fromnode:inspector/promises; import fs fromnode:fs; const session newSession(); session.connect();await session.post(Profiler.enable); await session.post(Profiler.start); // Invoke business logic under measurement here…// some time later… const { profile } await session.post(Profiler.stop);// Write profile to disk, upload, etc. fs.writeFileSync(./profile.cpuprofile, JSON.stringify(profile));2.inspector.open方法可以在节点启动后以编程方式启动debugger server。 vscode有个通过进程idattach到没有用–inspect模式启动的node服务的能力大概就是通过该接口实现的暂未确认。 下一节我们将讲解如何在Node.js中新增一个内置模块请大家持续关注本系列内容学习完本系列你将获得 提升调试与性能优化能力深入理解模块化与扩展机制探索底层技术与定制化能力 关于OpenTiny 欢迎加入 OpenTiny 开源社区。添加微信小助手opentiny-official 一起参与交流前端技术 OpenTiny 官网https://opentiny.design/ OpenTiny 代码仓库https://github.com/opentiny/ TinyVue 源码https://github.com/opentiny/tiny-vue TinyEngine 源码 https://github.com/opentiny/tiny-engine 欢迎进入代码仓库 StarTinyEngine、TinyVue、TinyNG、TinyCLI 如果你也想要共建可以进入代码仓库找到 good first issue标签一起参与开源贡献~