rd
列出(遍历)目录下的所有文件,包括子目录(支持 TypeScript)
安装
npm install rd --save
API列表
说明:
read
开头表示返回数组结果each
开头表示每发现一个文件均调用回调函数findOne
Sync
结尾表示是同步函数,其他表示异步函数
可用的API(详细用法可参考 test/test.js
):
read(dir, [threads], callback)
readFilter(dir, pattern, [threads], callback)
readFile(dir, [threads], callback)
readFileFilter(dir, pattern, [threads], callback)
readDir(dir, [threads], callback)
readDirFilter(dir, pattern, [threads], callback)
each(dir, findOne, [threads], callback)
eachFilter(dir, pattern, [threads], findOne, callback)
eachFile(dir, [threads], findOne, callback)
eachFileFilter(dir, pattern, [threads], findOne, callback)
eachDir(dir, [threads], findOne, callback)
eachDirFilter(dir, pattern, [threads], findOne, callback)
说明:
- 以上所有函数均提供同步版本,如
read
对应的同步版本为readSync
;相应的callback
改为直接return
返回值; threads
参数表示并发数量,为可选参数,默认为1;同步版本没有此参数;
findOne
回调函数格式:
{ // filename 是当前文件的完整路径 // stats 是使用 fs.Stats 对象}
callback
回调函数格式:
{ // 如果出错,err为出错信息 // each系列函数没有list参数 // read系列函数list为完整文件名的列表}
pattern
参数格式:
- 正则表达式
- 函数
{ // filename 是当前文件的完整路径 // 返回 true 表示该文件名符合条件}
简单示例
var rd = ; // 异步列出目录下的所有文件rd; // 同步列出目录下的所有文件var files = rd; // 异步遍历目录下的所有文件rd; // 同步遍历目录下的所有文件rd; // 同步遍历目录下的所有js文件rd;
License
Copyright (c) 2013-2018 Zongmin Lei <leizongmin@gmail.com>http://ucdok.com The MIT License Permission is hereby granted, free of charge, to any person obtaininga copy of this software and associated documentation files (the"Software"), to deal in the Software without restriction, includingwithout limitation the rights to use, copy, modify, merge, publish,distribute, sublicense, and/or sell copies of the Software, and topermit persons to whom the Software is furnished to do so, subject tothe following conditions: The above copyright notice and this permission notice shall beincluded in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OFMERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE ANDNONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BELIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTIONOF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTIONWITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.