qiao-file

qiao-file

nodejs 下文件相关封装

1. Node.js-开发实践：高性能 FS
2. Node.js-开发实践：使用健壮的 FS

install

安装

npm i qiao-file

use

使用

// cjs
const { isExists } = require('qiao-file');

// mjs
import { isExists } from 'qiao-file';

api

extname

获取文件的后缀

• filePath
  • 类型: string
  • 说明: 文件地址
• return
  • 类型: string
  • 说明: 文件后缀，例如.js

const res = extname(filePath);

isExists

判断文件或者文件夹是否存在

• fpath
  • 类型: string
  • 说明: 文件或者文件夹地址
• return
  • 类型: boolean
  • 说明: 结果
  • true: 存在

const res = await isExists(fpath);

isDir

判断文件路径是否为文件夹

• fpath
  • 类型: string
  • 说明: 文件或者文件夹地址
• return
  • 类型: boolean
  • 说明: 结果
  • true: 是文件夹

const res = await isDir(fpath);

cp

复制文件或文件夹

• src
  • 类型: string
  • 说明: 文件或文件夹地址
• dest
  • 类型: string
  • 说明: 目标文件或文件夹地址，如果 dest 存在，默认会覆盖
• return
  • 类型: boolean
  • 说明: 结果
  • true: 成功

const res = await cp(src, dest);

mv

移动文件或文件夹

• src
  • 类型: string
  • 说明: 文件或文件夹地址
• dest
  • 类型: string
  • 说明: 目标文件或文件夹地址，如果 dest 存在，默认会覆盖
• return
  • 类型: boolean
  • 说明: 结果
  • true: 成功

const res = await mv(src, dest);

rm

删除文件或文件夹

• path
  • 类型: string
  • 说明: 文件或文件夹地址
• return
  • 类型: boolean
  • 说明: 结果
  • true: 成功

const res = await rm(path);

mkdir

创建文件夹

• dirpath
  • 类型: string
  • 说明: 文件夹地址
• return
  • 类型: boolean
  • 说明: 结果
  • true: 成功

const res = await mkdir(dirpath);

readdir

读取文件夹内容

• dirpath
  • 类型: string
  • 说明: 文件夹地址
• return
  • 类型: string[]
  • 说明: dirpath 下的文件或文件夹路径

  • ['path', ...]
    

const res = await readdir(dirpath);

lsdir

列出文件夹下所有的文件和文件夹路径

• dirpath
  • 类型: string
  • 说明: 文件夹地址
• return
  • 类型: object
  • 说明: dirpath 下的文件或文件夹路径

  • {
      files: [
        {
          name: 'index.js',
          path: '/path/to/index.js',
        },
        ...
      ],
      folders: [
        {
          name: '1',
          path: '/path/to/1',
        },
        ...
      ],
    }
    

const res = await lsdir(dirpath);

lstree

列出文件夹下所有的文件和文件夹信息，以树的方式

• dirpath

  • 类型: string
  • 说明: 文件夹地址

• ignores

  • 类型: string[]
  • 说明：需要过滤的路径

• return

  • 类型: object[]
  • 说明: dirpath 下的文件和文件夹信息，以树的方式

  • [
      {
        children: [],
        name: 'filename',
        path: '',
      },
    ];
    

const dirpath = 'xx';
const ignores = ['node_modules', 'is-'];
const res = await lstree(dirpath, ignores);

readFile

读取文件内容

• filePath
  • 类型: string
  • 说明: 文件地址
• return
  • 类型: string
  • 说明: 文件内容

const res = await readFile(filePath);

readFileLineByLine

按行读取文件

• filePath
  • 类型: string
  • 说明: 文件地址
• onLine
  • 类型: function
  • 说明: 每行的回调函数
• onClose
  • 类型: function
  • 说明: 整个文件读取完毕的回调函数

readFileLineByLine(filePath, onLine, onClose);

writeFile

写文件

• filePath
  • 类型: string
  • 说明: 文件地址
• content
  • 类型: string
  • 说明: 文件内容
• return
  • 类型: boolean
  • 说明: 结果
  • true: 成功

const res = await writeFile(filePath, content);

version

0.1.8.20230407

1. 优化测试用例和 readme
2. 3.0.0

0.1.7.20230404

1. add ava
2. readDir --> readdir

0.1.6.20230307

1. 2.0.0

0.1.5.20221008

1. 1.0.0

0.1.4.20220707

1. write file from lines
2. read file line by line
3. read file line by line sync

0.1.3.20220420

1. lstree path name
2. mv
3. write file

0.1.2.20220419

1. es6
2. add lstree
3. read file

0.1.1.20220417

1. add lerna

0.1.0.20220317

1. add cp

0.0.9.20191204

1. add funding

0.0.8.20191011

1. exports.fs
2. exports.path

0.0.7.20190122

1. modify md

0.0.6.20190117

1. extname to lower case
2. add lsdir
3. add rm

0.0.5.20190107

1. nodejs file tool

0.0.4.20181127

1. modify method name
2. add .js

0.0.3.20181122

1. npm audit

0.0.2.20181017

1. isExists
2. extname
3. mkdir
4. getAllFiles

0.0.1.20181016

1. init