教程CLI【免费下载链接】learnyounodeLearn You The Node.js For Much Win! An intro to Node.js via a set of self-guided workshops.项目地址https://gitcode.com/gh_mirrors/le/learnyounode点击查看免费下载导读本篇技术指南围绕 learnyounode 项目中的filtered_ls过滤文件列表练习展开讲解如何编写一个接收「目录路径」与「文件扩展名」两个命令行参数、并以异步 I/O 方式输出过滤后文件列表的 Node.js 程序。读完本文你将掌握fs.readdir()回调式异步 API 的正确用法、path.extname()扩展名解析技巧以及 learnyounode 如何通过包装 fs 模块自动校验「是否使用异步 API」的底层机制为后续make_it_modular模块化重构等练习打下基础。练习目标按扩展名过滤目录文件filtered_ls是 learnyounode 的第三个练习紧随my_first_io与my_first_async_io之后其核心任务来自 exercises/filtered_ls/problem.fr.md编写一个程序打印出指定目录下的文件列表并依据文件的扩展名进行过滤。程序运行时需要接收两个命令行参数第一个参数目录路径例如/chemin/du/dossier/即/path/to/dir/第二个参数用于过滤的扩展名例如txt。过滤规则十分明确若第二个参数是txt则只输出文件名以.txt结尾的文件。这里有一个容易被忽视的细节——第二个参数不会自带开头的.因此你必须在程序中自行拼接例如. process.argv[3]这一点在英文原文problem.md中也有同样的强调。同时还有两条硬性约束输出格式过滤后的文件名必须在控制台逐行打印每个文件占一行必须使用异步 I/O不允许使用fs.readdirSync之类的同步方法这是本练习在验证环节会强制检查的关键点。注意process.argv数组的前两个元素被 Node 保留用于系统信息Node 可执行文件路径与脚本路径所以程序的第一个参数是process.argv[2]第二个参数是process.argv[3]——这是本练习隐含的重要知识点。核心 API 与提示fs.readdir()异步读取目录练习提示给出了本任务的核心 API——fs.readdir()。该方法接收一个路径作为第一个参数、一个回调函数作为第二个参数回调签名如下function callback (err, list) { /* ... */ }其中list是一个字符串数组元素为目录下的文件名不含路径前缀。err则在读取失败时携带错误对象成功时为null。值得指出的是fs.readdir()并不递归遍历子目录它只返回给定目录直接包含的文件与子目录名称而本练习的场景恰好只需要第一层文件因此用它做过滤十分合适。fs模块的完整离线文档已随仓库提供可直接在浏览器中打开阅读docs-nodejs/fs.html。path.extname()提取文件扩展名练习提示还推荐使用 Node 内置的path模块尤其是extname方法。path.extname(learnyounode.txt)会返回.txt对于无扩展名的文件如Makefile则返回空字符串。结合「第二个参数不带点」的约束标准写法就是if (path.extname(file) . process.argv[3]) { /* 命中过滤条件 */ }path模块的离线文档同样随仓库提供docs-nodejs/path.html。官方参考答案逐行拆解仓库中提供了官方解法位于 exercises/filtered_ls/solution/solution.js全文仅 15 行use strict const fs require(fs) const path require(path) const folder process.argv[2] const ext . process.argv[3] fs.readdir(folder, function (err, files) { if (err) return console.error(err) files.forEach(function (file) { if (path.extname(file) ext) { console.log(file) } }) })其思路可归纳为四个步骤取参并预处理扩展名folder取process.argv[2]ext在process.argv[3]前手动拼接.规避「参数不带点」的坑异步读取目录调用fs.readdir(folder, callback)错误先行回调内先判err有错即console.error(err)并提前返回避免在空files上继续操作逐项过滤并打印用path.extname(file) ext判断扩展名是否匹配命中则console.log(file)天然实现「每行一个文件」。官方解法选择了forEach 条件判断的写法测试用例 test/filtered_ls/valid_01.js 则展示了另一种等价写法——先用Array.prototype.filter筛出匹配文件再对结果forEach打印const fs require(fs) const path require(path) fs.readdir(process.argv[2], function (err, list) { if (err) { console.log(err) } list.filter(function (file) { return path.extname(file) . process.argv[3] }).forEach(function (file) { console.log(file) }) })两种风格均可通过验证读者可按喜好选择。验证机制如何强制「必须使用异步 I/O」本练习最有趣的部分在于它如何自动判定选手是否遵守了「必须异步」的约束。这一逻辑隐藏在 exercises/filtered_ls/exercise.js 中其实现分为两层第一层phantom wrapper 包装 fs 调用exercise.js 第 19 行引入了../my_first_io/wrap作为包装模块见 exercises/my_first_io/wrap.js。该模块会把子进程中的fs、fs.promisesfsp与util的所有方法逐一替换为包装函数通过调用栈$captureStack判断如果该 fs 方法是在选手主程序中调用的就将其记入ctx.fsCalls计数器。于是选手究竟用了哪些fs.*方法、用了多少次都被完整记录在案。第二层verify 处理器判定同步/异步exercise.js 第 53–72 行的addVerifyProcessor遍历exercise.wrapData.fsCalls中记录的方法名若方法名以Sync结尾如fs.readdirSync()判定usedSync true并输出失败提示fail.sync否则判定usedAsync true并输出通过提示pass.async若既没记录到同步也没记录到异步调用选手可能根本没使用 fs 模块则输出fail.unused。最终的通过条件是usedAsync !usedSync——只用异步、零同步调用。反例测试 test/filtered_ls/invalid_01.js 正是用fs.readdirSync写的同步版本用于验证该检查能正确拦截。这一设计也解释了为什么filtered_ls不能直接复用my_first_async_io的验证方式本练习要求的不只是「用了异步」而是「绝不出现同步调用」因此需要比普通输出比对更细粒度的调用追踪。练习运行的输入数据为了确保选手程序在不同环境下都能稳定验证练习会在运行时动态构造测试目录。从 exercises/filtered_ls/exercise.js 的addSetup阶段可见其流程在系统临时目录os.tmpdir()下创建以_learnyounode_进程PID命名的测试目录依据 exercises/filtered_ls/file-list.json 中的 15 个文件名如learnyounode.dat、learnyounode.txt、learnyounode.sql、api.html、README.md、CHANGELOG.md、LICENCE.md、data.json、data.dat、words.dat、w00t.dat、w00t.txt、wrrrrongdat、dat等批量写入占位内容通过submissionArgs.unshift(md)与submissionArgs.unshift(testDir)将测试目录与扩展名md依次注入选手程序的process.argv——也就是说官方验证时第二个参数是md期望输出的是测试目录中所有以.md结尾的文件即README.md与CHANGELOG.md验证结束后调用addCleanup用rimraf清理临时目录避免污染系统。这份file-list.json也直接复用于官方解法与测试用例的参数注入保证「题目、答案、测试」三方使用同一份数据源。运行与验证方式完成练习后可以用 learnyounode 自带的验证命令检查程序是否正确。英文原文 exercises/filtered_ls/problem.md 给出了标准用法$ learnyounode verify filtered-ls.js其中filtered-ls.js是选手保存的程序文件。verify模式会完整走一遍上文所述的「构造测试目录 → 注入参数 → 包装 fs 调用 → 执行选手程序 → 比对输出并判定异步约束」全流程而run模式则只负责在本地执行选手程序方便自行观察输出。除手工验证外仓库还通过workshopper-adventure-test驱动测试见 package.json 的test脚本与devDependencies其中test/filtered_ls/目录下的valid_01.js、invalid_01.js分别作为「异步通过版」与「同步失败版」的回归样例持续保障验证器的判定逻辑正确。与后续练习的衔接filtered_ls过滤逻辑本身并不复杂但它是通往下一练习make_it_modular的跳板make_it_modular要求把「读取目录 按扩展名过滤」的整套逻辑抽取为独立模块以「模块导出函数 回调接收结果」的方式组织代码并配有solution_filter.js示例与 15 个模块级测试样例见 exercises/make_it_modular。提前吃透fs.readdir的异步回调模式与path.extname的边界行为将大幅降低后续模块化改造时的认知负担。小结要点说明参数位置目录路径在process.argv[2]扩展名在process.argv[3]前两个元素为 Node 保留扩展名处理第二个参数不带.需自行拼接为. arg目录读取使用异步fs.readdir(path, callback)回调签名为callback(err, list)扩展名判断使用path.extname(file) ext注意无扩展名文件返回空字符串输出格式每个匹配文件console.log一行强制约束禁止任何*Sync调用验证器通过包装 fs 模块逐方法计数判定验证命令learnyounode verify filtered-ls.js通过本文的源码级拆解读者不仅能在本地写出可被learnyounode verify认可的答案更能理解其验证器「包装 fs 调用、区分同步/异步」的设计思想——这正是 learnyounode 这类自引导工作坊self-guided workshops区别于普通在线题库的价值所在。赞分享教程CLI【免费下载链接】learnyounodeLearn You The Node.js For Much Win! An intro to Node.js via a set of self-guided workshops.项目地址https://gitcode.com/gh_mirrors/le/learnyounode点击查看免费下载相关推荐learnyounode 实战使用 fs.readdir 与 path.extname 实现按扩展名过滤目录文件learnyounode 实战使用 fs.readdir 与 path.extname 实现按扩展名过滤目录文件 本篇技术指南以 learnyounodeN教程CLIlearnyounode 第二关使用 fs.readdir 与 path.extname 实现按扩展名过滤文件列表learnyounode 第二关使用 fs.readdir 与 path.extname 实现按扩展名过滤文件列表 导读 本篇文章以 learnyounode教程CLIConform错误处理最佳实践构建健壮的表单用户体验Conform错误处理最佳实践构建健壮的表单用户体验 在现代Web应用开发中表单是用户与系统交互的核心界面而错误处理则直接影响用户体验的流畅度和满意度。C教程CLI上一篇BugTraceAI-Apex-G4-26B-Q4 vs 其他安全AI模型为什么它在MITRE ATTCK测试中获得100%通过率下一篇Uni-MoE学术论文复现从公式推导到代码实现创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考