util

fis. util

fis 中工具类操作集合。lodash 中所有方法都挂载在此名字空间下面。

Source:

• util.js, line 108

Example

/a/b//c\d/ -> /a/b/c/d

Methods

(static) applyMatches(path, matches, allowed)

将 matches 规则应用到某个对象上面。

Parameters:

Source:

• util.js, line 1477

(static) base64(data) → {String}

生成base64串

Parameters:

Source:

• util.js, line 540

Returns:

base64串

Type

String

(static) camelcase(str) → {String}

驼峰写法转换

Parameters:

Source:

• util.js, line 1026

Returns:

转换后的字符串

Type

String

(static) clone(source) → {any}

clone一个变量

Parameters:

Source:

• util.js, line 208

Returns:

clone值

Type

any

(static) copy(rSource, target, include, exclude, uncover, move)

复制符合include和exclude规则的文件到目标目录，若rSource为文件夹则递归其下属每个文件

Parameters:

Source:

• util.js, line 866

(static) del()

删除指定目录下面的文件。

Source:

• util.js, line 823

(static) download(url, callback, extract, opt)

下载功能实现

Parameters:

Source:

• util.js, line 1130

(static) escapeReg(str) → {String}

正则串编码转义

Parameters:

Source:

• util.js, line 237

Returns:

普通字符串

Type

String

(static) escapeShellArg(命令)

shell编码转义

Parameters:

Source:

• util.js, line 260

(static) escapeShellCmd(命令)

shell命令编码转义

Parameters:

Source:

• util.js, line 249

(static) exist(filepath)

判断文件是否存在。

Parameters:

Source:

• util.js, line 320

(static) ext(str) → {Object}

path处理

Parameters:

Source:

• util.js, line 917

Returns:

Type

Object

Example

str = /a.b.c/f.php?kw=%B2%E5%BB%AD#addfhubqwek
 {
origin: '/a.b.c/f.php?kw=%B2%E5%BB%AD#addfhubqwek',
rest: '/a.b.c/f',
hash: '#addfhubqwek',
query: '?kw=%B2%E5%BB%AD',
fullname: '/a.b.c/f.php',
dirname: '/a.b.c',
ext: '.php',
filename: 'f',
basename: 'f.php'
 }

(static) filter(str, include, exclude) → {Boolean}

str过滤处理，判断include中匹配str为true，exclude中不匹配str为true

Parameters:

Source:

• util.js, line 737

Returns:

是否匹配

Type

Boolean

(static) find(rPath, include, exclude, root) → {Array}

若rPath为文件夹，夹遍历目录下符合include和exclude规则的全部文件；若rPath为文件，直接匹配该文件路径是否符合include和exclude规则

Parameters:

Source:

• util.js, line 791

Returns:

符合规则的文件路径的集合

Type

Array

(static) getMimeType(ext) → {String}

匹配文件后缀所属MimeType类型

Parameters:

Source:

• util.js, line 305

Returns:

MimeType类型

Type

String

(static) glob(pattern, str, options) → {Boolean|RegExp}

模拟linux glob文法实现，但()为捕获匹配模式

Parameters:

Source:

• util.js, line 1337

Returns:

若str参数为String则返回str是否可被pattern匹配
若str参数不为String，则返回正则表达式

Type

Boolean | RegExp

(static) install(name, version, opt)

读取fis组件安装

Parameters:

Source:

• util.js, line 1277

(static) isAbsolute(path) → {Boolean}

判断路径是否为绝对路径

Parameters:

Source:

• util.js, line 365

Returns:

true为是

Type

Boolean

(static) isDir(path) → {Boolean}

是否为文件夹

Parameters:

Source:

• util.js, line 411

Returns:

true为是

Type

Boolean

(static) isEmpty(obj) → {Boolean}

判断对象是否为null,[],{},0

Parameters:

Source:

• util.js, line 1458

Returns:

是否为空

Type

Boolean

(static) isFile(path) → {Boolean}

是否为一个文件

Parameters:

Source:

• util.js, line 399

Returns:

true为是

Type

Boolean

(static) isImageFile(path) → {Boolean}

是否为配置中的image文件类型

Parameters:

Source:

• util.js, line 511

Returns:

Type

Boolean

(static) isTextFile(path) → {Boolean}

是否为配置中的text文件类型

Parameters:

Source:

• util.js, line 499

Returns:

Type

Boolean

(static) isUtf8(bytes) → {Boolean}

判断Buffer是否为utf8

Parameters:

Source:

• util.js, line 598

Returns:

true为utf8

Type

Boolean

(static) isWin() → {Boolean}

是否为windows系统

Source:

• util.js, line 463

Returns:

Type

Boolean

(static) map(obj, callback, merge)

对象枚举元素遍历，若merge为true则进行_.assign(obj, callback)，若为false则回调元素的key value index

Parameters:

Source:

• util.js, line 143

(static) md5(data, len) → {String}

按位数生成md5串

Parameters:

Source:

• util.js, line 523

Returns:

md5串

Type

String

(static) merge(source, target) → {Object}

将target合并到source上，新值为undefiend一样会覆盖掉原有数据

Parameters:

Source:

• util.js, line 188

Returns:

合并后的对象

Type

Object

(static) mkdir(path, mode)

递归创建文件夹

Parameters:

Source:

• util.js, line 560

(static) mtime(path) → {Date}

获取路径最近修改时间

Parameters:

Source:

• util.js, line 423

Returns:

时间(GMT+0800)

Type

Date

(static) nohup(cmd, options, callback)

调起nohup命令

Parameters:

Source:

• util.js, line 1412

(static) pad(str, len, fill, pre) → {String}

固定长度字符前后缀填补方法(fillZero)

Parameters:

Source:

• util.js, line 165

Returns:

填补后的字符串

Type

String

(static) parseUrl(url, opt) → {Object}

url解析函数，规则类似require('url').parse

Parameters:

Source:

• util.js, line 1109

Returns:

{ protocol, host, port, path, method, agent }

Type

Object

(static) pathinfo(path) → {Object}

生成路径信息

Parameters:

Source:

• util.js, line 1005

Returns:

@see ext()

Type

Object

(static) pipe(type, callback, def)

加载处理fis模块下的全部插件，如fis3-plugin-*

Parameters:

Source:

• util.js, line 1046

(static) query(str) → {Object}

path处理，提取path中rest部分(?之前)、query部分(?#之间)、hash部分(#之后)

Parameters:

Source:

• util.js, line 965

Returns:

{
origin: 原始串
rest: path部分(?之前)
query: query部分(?#之间)
hash: hash部分(#之后)
}

Type

Object

(static) read(path, convert) → {String}

读取文件内容

Parameters:

Source:

• util.js, line 691

Returns:

文件内容

Type

String

(static) readBuffer(buffer) → {String}

处理Buffer编码方式

Parameters:

Source:

• util.js, line 671

Returns:

判断若为utf8可识别的编码则去掉bom返回utf8编码后的String，若不为utf8可识别编码则返回gbk编码后的String

Type

String

(static) readJson(path) → {Object}

读取JSON文件

Parameters:

Source:

• util.js, line 1318

Returns:

JSON文件内容JSON.parse后得到的对象

Type

Object

(static) realpath(path) → {String}

返回path的绝对路径，若path不存在则返回false

Parameters:

Source:

• util.js, line 330

Returns:

绝对路径

Type

String

(static) realpathSafe(path) → {String}

多功能path处理

Parameters:

Source:

• util.js, line 353

Returns:

处理后的路径

Type

String

(static) stringQuote(str, quotes) → {Object}

提取字符串中的引号和一对引号包围的内容

Parameters:

Source:

• util.js, line 271

Returns:

{
origin: 源字符串
rest: 引号包围的文字内容
quote: 引号类型
}

Type

Object

(static) toEncoding(str, encoding) → {String}

字符串编码转换

Parameters:

Source:

• util.js, line 585

Returns:

编码转换后的字符串

Type

String

(static) touch(path, mtime)

修改文件时间戳

Parameters:

Source:

• util.js, line 439

(static) upload(url, opt, data, content, subpath, callback)

遵从RFC规范的文件上传功能实现

Parameters:

Source:

• util.js, line 1201

(static) write(path, data, charset, append)

写文件，若路径不存在则创建

Parameters:

Source:

• util.js, line 713