English 中文

$

source test1.0.0

类似 jQuery 的 dom 操作库。

类型定义
namespace $ {
    class $ extends Select {
        find(selector: string): $;
        each(fn: types.AnyFn): $;
        offset(): $offset.IOffset;
        hide(): $;
        show(): $;
        first(): $;
        last(): $;
        get(index: number): Element;
        eq(index: number): $;
        on(event: string, selector: string, handler: types.AnyFn): $;
        on(event: string, handler: types.AnyFn): $;
        off(event: string, selector: string, handler: types.AnyFn): $;
        off(event: string, handler: types.AnyFn): $;
        html(): string;
        html(value: string): $;
        text(): string;
        text(value: string): $;
        val(): string;
        val(value: string): $;
        css(name: string): string;
        css(name: string, value: string): $;
        css(properties: types.PlainObj<string | number>): $;
        attr(name: string): string;
        attr(name: string, value: string): $;
        attr(attributes: types.PlainObj<string>): $;
        data(name: string): string;
        data(name: string, value: string): $;
        data(attributes: types.PlainObj<string>): $;
        rmAttr(name: string): $;
        remove(): $;
        addClass(name: string | string[]): $;
        rmClass(name: string): $;
        toggleClass(name: string): $;
        hasClass(name: string): boolean;
        parent(): $;
        append(content: string | Element): $;
        prepend(content: string | Element): $;
        before(content: string | Element): $;
        after(content: string | Element): $;
    }
}
declare function $(selector: string | Element | Document): $.$;

支持方法列表

offset, hide, show, first, last, get, eq, on, off, html, text, val, css, attr, data, rmAttr, remove, addClass, rmClass, toggleClass, hasClass, append, prepend, before, after

const $btn = $('#btn');
$btn.html('eustia');
$btn.addClass('btn');
$btn.show();
$btn.on('click', function() {
    // Do something...
});

$attr

source test1.0.0

操作元素属性。

类型定义
namespace $attr {
    function remove(element: $safeEls.El, name: string): void;
}
function $attr(
    element: $safeEls.El,
    name: string,
    value: string
): void;
function $attr(
    element: $safeEls.El,
    attributes: types.PlainObj<string>
): void;
function $attr(element: $safeEls.El, name: string): string;

获取元素集中第一个元素的指定属性值。

参数名说明
element目标元素集
name属性名
返回值第一个元素的属性值

设置元素集中一个或多个属性的值。

参数名说明
element目标元素集
name属性名
val属性值
参数名说明
element目标元素集
attributes包含多个要设置属性-值对的对象

remove

对元素集中的所有元素,移除指定的属性。

参数名说明
element目标元素集
name属性名
$attr('#test', 'attr1', 'test');
$attr('#test', 'attr1'); // -> test
$attr.remove('#test', 'attr1');
$attr('#test', {
    attr1: 'test',
    attr2: 'test'
});

$class

source test1.0.0

操作元素 class。

类型定义
const $class: {
    add(element: $safeEls.El, name: string | string[]): void;
    has(element: $safeEls.El, name: string): boolean;
    toggle(element: $safeEls.El, name: string): void;
    remove(element: $safeEls.El, name: string): void;
};

add

对元素集中的所有元素,添加指定的 class。

参数名说明
element目标元素集
names添加的 class

has

判断元素集中是否有元素含有指定的 class。

参数名说明
element目标元素集
nameclass 值
返回值如果有,返回真

toggle

对于元素集中的每个元素,如果含有指定的 class 就将其删除,反之则添加。

参数名说明
element目标元素集
nameclass 值

remove

对于元素集中的所有元素,移除指定的 class。

参数名说明
element目标元素集
nameclass 值
$class.add('#test', 'class1');
$class.add('#test', ['class1', 'class2']);
$class.has('#test', 'class1'); // -> true
$class.remove('#test', 'class1');
$class.has('#test', 'class1'); // -> false
$class.toggle('#test', 'class1');
$class.has('#test', 'class1'); // -> true

$css

source test1.0.0

操作元素样式。

类型定义
function $css(element: $safeEls.El, name: string): string;
function $css(
    element: $safeEls.El,
    name: string,
    val: string
): void;
function $css(
    element: $safeEls.El,
    properties: types.PlainObj<string | number>
): void;

获取元素集中第一个元素的指定样式。

参数名说明
element目标元素集
name样式名
返回值样式值

设置元素集中一个或多个样式的值。

参数名说明
element目标元素集
name样式名
val样式值
参数名说明
element目标元素集
properties包含多个要设置样式-值对的对象
$css('#test', {
    color: '#fff',
    background: 'black',
    opacity: 0.5
});
$css('#test', 'display', 'block');
$css('#test', 'color'); // -> #fff

$data

source test1.0.0

同 $attr,自动给属性名加 data- 前缀。

类型定义
function $data(
    element: $safeEls.El,
    name: string,
    value: string
): void;
function $data(
    element: $safeEls.El,
    attributes: types.PlainObj<string>
): void;
function $data(element: $safeEls.El, name: string): string;
$data('#test', 'attr1', 'eustia');

$event

source test1.0.0

给指定 dom 元素绑定事件。

类型定义
const $event: {
    on(
        element: $safeEls.El,
        event: string,
        selector: string,
        handler: types.AnyFn
    ): void;
    on(element: $safeEls.El, event: string, handler: types.AnyFn): void;
    off(
        element: $safeEls.El,
        event: string,
        selector: string,
        handler: types.AnyFn
    ): void;
    off(element: $safeEls.El, event: string, handler: types.AnyFn): void;
};
function clickHandler() {
    // Do something...
}
$event.on('#test', 'click', clickHandler);
$event.off('#test', 'click', clickHandler);

$insert

source test1.0.0

插入 html 到不同位置。

类型定义
namespace $insert {
    type IInsert = (element: $safeEls.El, content: string | Element) => void;
}
const $insert: {
    before: $insert.IInsert;
    after: $insert.IInsert;
    append: $insert.IInsert;
    prepend: $insert.IInsert;
};

before

插入 html 到元素前。

after

插入 html 到元素后。

prepend

插入 html 到元素内部前。

append

插入 html 到元素内部后。

参数名说明
element目标元素集
contenthtml 字符串或元素
// <div id="test"><div class="mark"></div></div>
$insert.before('#test', '<div>licia</div>');
// -> <div>licia</div><div id="test"><div class="mark"></div></div>
$insert.after('#test', '<div>licia</div>');
// -> <div id="test"><div class="mark"></div></div><div>licia</div>
$insert.prepend('#test', '<div>licia</div>');
// -> <div id="test"><div>licia</div><div class="mark"></div></div>
$insert.append('#test', '<div>licia</div>');
// -> <div id="test"><div class="mark"></div><div>licia</div></div>

$offset

source test1.0.0

获取元素在文档中的位置。

类型定义
namespace $offset {
    interface IOffset {
        left: number;
        top: number;
        width: number;
        height: number;
    }
}
function $offset(element: $safeEls.El): $offset.IOffset;
参数名说明
element目标元素集
返回值元素位置
$offset('#test'); // -> {left: 0, top: 0, width: 0, height: 0}

$property

source test1.0.0

设置或获取元素的 html, text,val 等值。

类型定义
namespace $property {
    interface IProperty {
        (element: $safeEls.El, value: string): void;
        (element: $safeEls.El): string;
    }
}
const $property: {
    html: $property.IProperty;
    val: $property.IProperty;
    text: $property.IProperty;
};

html

设置或获取元素的 html 值。

text

设置或获取元素的 text 值。

val

设置或获取元素的 val 值。

$property.html('#test', 'licia');
$property.html('#test'); // -> licia

$remove

source test1.0.0

移除指定元素集。

类型定义
function $remove(element: $safeEls.El);
参数名说明
element目标元素集
$remove('#test');

$safeEls

source test1.0.0

将值转换为数组,如果值为字符串,使用 querySelector 获取元素集。

类型定义
namespace $safeEls {
    type El = Element | Element[] | NodeListOf<Element> | string;
}
function $safeEls(val: $safeEls.El): Element[];
参数名说明
val要转换的值
返回值元素集
$safeEls(document.querySelector('.test'));
$safeEls(document.querySelectorAll('.test'));
$safeEls('.test'); // -> Array of elements with test class

$show

source test1.0.0

显示元素。

类型定义
function $show(element: $safeEls.El): void;
参数名说明
element目标元素集
$show('#test');

Benchmark

source test1.30.0

JavaScript 基准测试。

类型定义
namespace Benchmark {
    interface IOptions {
        minTime?: number;
        maxTime?: number;
        minSamples?: number;
        delay?: number;
        name?: string;
    }
    interface IResult {
        name: string;
        mean: number;
        variance: number;
        deviation: number;
        sem: number;
        moe: number;
        rme: number;
        hz: number;
        sample: number[];
    }
}
class Benchmark {
    constructor(fn: types.AnyFn, options?: Benchmark.IOptions);
    run(): Promise<Benchmark.IResult>;
    static all(
        benches: Array<types.AnyFn | Benchmark>,
        options?: Benchmark.IOptions
    ): Promise<Benchmark.IResult[]>;
}

constructor

参数名说明
fn要测试的代码
options测试选项

可用选项:

参数名说明
minTime=50用于减少误差的时间
maxTime=5000测试运行最大时间
minSamples=5最小样本数量
delay=5测试周期间隔
name测试名称

run

运行基准测试,返回 promise。

all

[static] 运行多个基准测试。

const benchmark = new Benchmark(
    function test() {
        !!'Hello World!'.match(/o/);
    },
    {
        maxTime: 1500
    }
);
benchmark.run().then(result => {
    console.log(String(result));
});
Benchmark.all([
    function regExp() {
        /o/.test('Hello World!');
    },
    function indexOf() {
        'Hello World!'.indexOf('o') > -1;
    },
    function match() {
        !!'Hello World!'.match(/o/);
    }
]).then(results => {
    console.log(String(results));
});

Blob

source test1.0.0

如果支持 Blob,直接返回 Blob,否则使用 BlobBuilder 进行兼容。

constructor

参数名说明
partsBlob 分片
options选项
const blob = new Blob([]);

BloomFilter

source test1.10.0

布隆过滤器实现。

类型定义
class BloomFilter {
    constructor(size?: number, k?: number);
    add(val: string): void;
    test(val: string): boolean;
}

constructor

参数名说明
size=1024桶数目
k=3哈希函数数目

add

添加元素。

参数名说明
val要加的值

test

检测元素是否在过滤器中。

参数名说明
val要检查的值
返回值如果可能在返回真,如果绝对不在返回假
const bloom = new BloomFilter(256, 3);
bloom.add('Bruce Wayne');
bloom.add('Clark Kent');
bloom.test('Clark Kent'); // -> true
bloom.test('Bruce Wayne'); // -> true
bloom.test('Tony Stark'); // -> false

Caseless

source test1.9.0

修改对象的属性值时,无需关心键值的大小写情况。

类型定义
class Caseless {
    constructor(obj: any);
    getKey(key: string): string | void;
    set(key: string, val: any): void;
    get(key: string): any;
    remove(key: string): void;
    has(key: string): boolean;
}

constructor

参数名说明
obj目标对象

getKey

获取原始键值。

参数名说明
key不区分大小写的键名
返回值原始键值

set

设置值。

参数名说明
key不区分大小写的键名
val要设置的值

get

获取值。

参数名说明
key不区分大小写的键名
返回值键值

remove

移除值。

参数名说明
key不区分大小写的键名

has

判断是否存在给定的键名。

参数名说明
key不区分大小写的键名
返回值如果有,返回真
const headers = { 'Content-Type': 'text/javascript' };
const c = new Caseless(headers);
c.set('content-type', 'text/css');
console.log(headers); // -> { 'Content-Type': 'text/css' }
c.getKey('content-type'); // -> 'Content-Type'
c.remove('content-type');
c.has('content-type'); // -> false

Class

source test demo1.0.0

创建 JavaScript 类。

类型定义
namespace Class {
    class Base {
        toString(): string;
    }
    class IConstructor extends Base {
        constructor(...args: any[]);
        static extend(methods: any, statics: any): IConstructor;
        static inherits(Class: types.AnyFn): void;
        static methods(methods: any): IConstructor;
        static statics(statics: any): IConstructor;
        [method: string]: any;
    }
}
function Class(methods: any, statics?: any): Class.IConstructor;
参数名说明
methods公有方法
statics静态方法
返回值用于创建实例的函数
const People = Class({
    initialize: function People(name, age) {
        this.name = name;
        this.age = age;
    },
    introduce: function() {
        return 'I am ' + this.name + ', ' + this.age + ' years old.';
    }
});

const Student = People.extend(
    {
        initialize: function Student(name, age, school) {
            this.callSuper(People, 'initialize', arguments);

            this.school = school;
        },
        introduce: function() {
            return (
                this.callSuper(People, 'introduce') +
                '\n I study at ' +
                this.school +
                '.'
            );
        }
    },
    {
        is: function(obj) {
            return obj instanceof Student;
        }
    }
);

const a = new Student('allen', 17, 'Hogwarts');
a.introduce(); // -> 'I am allen, 17 years old. \n I study at Hogwarts.'
Student.is(a); // -> true

Color

source test1.0.0

颜色转换。

类型定义
namespace Color {
    interface IColor {
        val: number[];
        model: string;
    }
}
class Color {
    constructor(color: string | Color.IColor);
    toRgb(): string;
    toHex(): string;
    toHsl(): string;
    static parse(colorStr: string): Color.IColor;
}

constructor

参数名说明
color要转换的颜色

toRgb

获取颜色 rgb 格式。

toHex

获取颜色十六进制格式。

toHsl

获取颜色 hsl 格式。

parse

【静态】将颜色字符串转换为含有值及颜色模型的对象。

参数名说明
color颜色字符串
返回值含有值及颜色模型的对象
Color.parse('rgb(170, 287, 204, 0.5)'); // -> {val: [170, 187, 204, 0.5], model: 'rgb'}
const color = new Color('#abc');
color.toRgb(); // -> 'rgb(170, 187, 204)'
color.toHsl(); // -> 'hsl(210, 25%, 73%)'

Delegator

source test1.17.0

对象委托。

类型定义
class Delegator {
    constructor(host: object, target: object | string);
    method(name: string, target?: string): Delegator;
    getter(name: string, target?: string): Delegator;
    setter(name: string, target?: string): Delegator;
    access(name: string, target?: string): Delegator;
}

constructor

参数名说明
host宿主对象
target委托目标

method

允许在宿主对象上访问目标方法。

参数名说明
name宿主方法名
target=name目标方法名

getter

创建 getter。

setter

创建 setter。

access

创建 accessor,效果等于同时调用 setter 和 getter。

const host = {
    target: {
        a() {
            return 'a';
        },
        b: 'b',
        c: 'c',
        d: 'd',
        e() {
            return 'e';
        }
    }
};
const delegator = new Delegator(host, 'target');
delegator
    .method('a')
    .getter('b')
    .setter('c')
    .access('d');
host.a(); // -> 'a'
host.b; // -> 'b'
host.c = 5;
host.target.c; // -> 5
host.d; // -> 'd'
host.d = 5;
host.d; // -> 5

Dispatcher

source test1.0.0

Flux 调度器。

类型定义
class Dispatcher {
    dispatch(payload: any);
    register(cb: types.AnyFn): void;
    waitFor(ids: string[]): void;
    unregister(id: string): void;
    isDispatching(): boolean;
}

相关文档

const dispatcher = new Dispatcher();

dispatcher.register(function(payload) {
    switch (
        payload.actionType
        // Do something
    ) {
    }
});

dispatcher.dispatch({
    actionType: 'action'
});

Emitter

source test1.0.0

提供观察者模式的 Event emitter 类。

类型定义
class Emitter {
    on(event: string, listener: types.AnyFn): Emitter;
    off(event: string, listener: types.AnyFn): Emitter;
    once(event: string, listener: types.AnyFn): Emitter;
    emit(event: string, ...args: any[]): Emitter;
    removeAllListeners(event?: string): Emitter;
    static mixin(obj: any): any;
}

on

绑定事件。

off

解绑事件。

once

绑定只触发一次的事件。

参数名说明
event事件名称
listener事件监听器

emit

触发事件。

参数名说明
event事件名称
...args传递给监听器的参数

removeAllListeners

解绑所有事件。

参数名说明
event事件名称

mixin

【静态】 将 Emitter 类的方法绑定到指定对象上去。

参数名说明
obj目标对象
const event = new Emitter();
event.on('test', function(name) {
    console.log(name);
});
event.emit('test', 'licia'); // Logs out 'licia'.
Emitter.mixin({});

Enum

source test1.0.0

Enum 类实现。

类型定义
class Enum {
    size: number;
    constructor(map: string[] | { [member: string]: any });
    [key: string]: any;
}

constructor

参数名说明
arr字符串数组
参数名说明
obj键值对
const importance = new Enum([
    'NONE',
    'TRIVIAL',
    'REGULAR',
    'IMPORTANT',
    'CRITICAL'
]);
const val = 1;
if (val === importance.CRITICAL) {
    // Do something.
}

FileBlobStore

source test1.32.0

二进制文件存储。

类型定义
class FileBlobStore extends Emitter {
    constructor(path: string, data?: types.PlainObj<Buffer>);
    set(key: string, buf: Buffer): void;
    set(values: types.PlainObj<Buffer>): void;
    get(key: string): Buffer | void;
    get(keys: string[]): types.PlainObj<Buffer>;
    remove(key: string): void;
    remove(keys: string[]): void;
    clear(): void;
    each(fn: (val: Buffer, key: string) => void): void;
    save(): void;
}

API 基本与 Store 模块一致,主要不同点是只接收 Buffer 类型。

save

保存内容到磁盘。

const store = new FileBlobStore('path/to/file');
store.set('name', Buffer.from('licia'));
process.on('exit', () => store.save());

FileStore

source test1.32.0

constructor

类型定义
class FileStore extends Store {
    constructor(path: string, data?: any);
}
参数名说明
path存储文件路径
data默认数据
const store = new FileStore('path/to/file');
store.set('name', 'licia');

HashTable

source test1.13.0

哈希表实现。

类型定义
class HashTable {
    constructor(size?: number);
    set(key: string, val: any): void;
    get(key: string): any;
    has(key: string): boolean;
    delete(key: string): void;
}

constructor

参数名说明
size=32桶数目

set

设置值。

参数名说明
key键名
val键值

get

获取值。

参数名说明
key键名
返回值键值

has

检查是否有指定值。

参数名说明
key键名
返回值如果值存在,返回真

delete

删除值。

const hashTable = new HashTable(128);
hashTable.set('name', 'redhoodsu');
hashTable.get('name'); // -> 'redhoodsu'
hashTable.has('name'); // -> true
hashTable.delete('name');
hashTable.has('name'); // -> false

Heap

source test1.11.0

堆实现。

类型定义
class Heap {
    size: number;
    constructor(cmp?: types.AnyFn);
    clear(): void;
    add(item: any): number;
    poll(): any;
    peek(): any;
}

size

堆大小。

constructor

参数名说明
cmp比较器

clear

清空堆数据。

add

往堆里添加元素。

参数名说明
item入堆元素
返回值当前大小

poll

获取并删除堆的根元素。

peek

与 poll 一样,只是不删除。

const heap = new Heap(function(a, b) {
    return b - a;
});
heap.add(2);
heap.add(1);
heap.add(4);
heap.add(5);
heap.poll(); // -> 5
console.log(heap.size); // -> 4

HeapSnapshot

source test1.31.0

V8 内存快照操作库。

类型定义
class HeapSnapshot {
    nodes: LinkedList;
    edges: LinkedList;
    constructor(profile: any);
}

constructor

参数名说明
profile要解析的内存快照

nodes

解析后的节点信息。

edges

解析后的边信息。

const fs = require('fs');
const data = fs.readFileSync('path/to/heapsnapshot', 'utf8');
const heapSnapshot = new HeapSnapshot(data);
let totalSize = 0;
heapSnapshot.nodes.forEach(node => (totalSize += node.selfSize));
console.log(totalSize);

I18n

source test1.23.0

简单国际化库。

类型定义
class I18n {
    constructor(locale: string, langs: types.PlainObj<any>);
    set(locale: string, lang: types.PlainObj<any>): void;
    t(path: string | string[], data?: types.PlainObj<any>): string;
    locale(locale: string): void;
}

constructor

参数名说明
locale地区代码
langs语言数据

set

添加语言或者向已有的语言新增键值。

参数名说明
locale地区代码
lang语言数据

locale

设置当前地区。

参数名说明
locale地区代码

t

获取翻译文本。

参数名说明
path要获取文本的键值
data要传递的数据
返回值翻译文本
const i18n = new I18n('en', {
    en: {
        welcome: 'Hello, {{name}}!',
        curTime(data) {
            return 'Current time is ' + data.time;
        }
    },
    cn: {
        welcome: '你好,{{name}}!'
    }
});
i18n.set('cn', {
    curTime(data) {
        return '当前时间是 ' + data.time;
    }
});
i18n.t('welcome', { name: 'licia' }); // -> 'Hello, licia!'
i18n.locale('cn');
i18n.t('curTime', { time: '5:47 pm' }); // -> '当前时间是 5:47 pm'

JsonTransformer

source test1.0.0

JSON 转换器。

类型定义
class JsonTransformer {
    constructor(data: any);
    set(key: string, val: any): JsonTransformer;
    get(key?: string): any;
    map(from: string, to: string, fn: types.AnyFn): JsonTransformer;
    map(from: string, fn: types.AnyFn): JsonTransformer;
    filter(from: string, to: string, fn: types.AnyFn): JsonTransformer;
    filter(from: string, fn: types.AnyFn): JsonTransformer;
    remove(keys: string | string[]): JsonTransformer;
    compute(
        from: string | string[],
        to: string,
        fn: types.AnyFn
    ): JsonTransformer;
    compute(from: string, fn: types.AnyFn): JsonTransformer;
    toString(): string;
}

constructor

参数名说明
data={}目标 JSON 对象

set

设置属性值。

参数名说明
key属性路径
val

如果属性路径为空,整个对象将被值替换。

get

获取属性值。

参数名说明
key属性路径
返回值指定值或整个对象

remove

移除属性值。

参数名说明
key属性路径

map

数组 map 的快捷方式。

参数名说明
from源对象路径
to目标对象路径
fn真值检测函数

filter

数组 filter 的快捷方式。

compute

从多个属性值计算新值。

参数名说明
from源属性路径
to目标属性路径
fn计算函数
const data = new JsonTransformer({
    books: [
        {
            title: 'Book 1',
            price: 5
        },
        {
            title: 'Book 2',
            price: 10
        }
    ],
    author: {
        lastname: 'Su',
        firstname: 'RedHood'
    }
});
data.filter('books', function(book) {
    return book.price > 5;
});
data.compute('author', function(author) {
    return author.firstname + author.lastname;
});
data.set('count', data.get('books').length);
data.get(); // -> {books: [{title: 'Book 2', price: 10}], author: 'RedHoodSu', count: 1}

LinkedList

source test1.0.0

双向链表实现。

类型定义
namespace LinkedList {
    class Node {
        value: any;
        prev: Node | null;
        next: Node | null;
    }
}
class LinkedList {
    size: number;
    head: LinkedList.Node;
    tail: LinkedList.Node;
    push(val: any): number;
    pop(): any;
    unshift(val: any): number;
    shift(): any;
    find(fn: types.AnyFn): LinkedList.Node | void;
    delNode(node: LinkedList.Node): void;
    forEach(iterator: types.AnyFn, ctx?: any);
    toArr(): any[];
}

size

链表大小。

head

链表首结点。

tail

链表尾结点。

push

向链表尾部添加值。

参数名说明
val要添加的值
返回值链表大小

pop

获取链表尾部值。

unshift

向链表头部添加值。

shift

获取链表头部值。

rmNode

删除节点。

find

查找节点。

参数名说明
fn真值检测函数
返回值第一个通过的节点

forEach

遍历链表。

toArr

将链表转换成 JavaScript 数组。

const linkedList = new LinkedList();
linkedList.push(5);
linkedList.pop(); // -> 5

LocalStore

source test1.0.0

LocalStorage 存储。

类型定义
class LocalStore extends Store {
    constructor(name: string, data?: {});
}

继承自 Store 类。

constructor

参数名说明
nameLocalStorage 存储名
data默认数据
const store = new LocalStore('licia');
store.set('name', 'licia');

Logger

source test demo1.0.0

带日志级别的简单日志库。

类型定义
class Logger extends Emitter {
    name: string;
    formatter(type: string, argList: any[]): any[];
    constructor(name: string, level?: string | number);
    setLevel(level: string | number): Logger;
    getLevel(): number;
    trace(...args: any[]): Logger;
    debug(...args: any[]): Logger;
    info(...args: any[]): Logger;
    warn(...args: any[]): Logger;
    error(...args: any[]): Logger;
    static level: Enum;
}

constructor

参数名说明
name日志名称
level=DEBUG日志级别

setLevel

设置日志级别。

参数名说明
level日志级别

getLevel

获取当前日志级别。

trace,debug,info,warn,error

打日志方法。

日志级别

TRACE,DEBUG,INFO,WARN,ERROR 和 SILENT。

const logger = new Logger('licia', Logger.level.ERROR);
logger.trace('test');

// Format output.
logger.formatter = function(type, argList) {
    argList.push(new Date().getTime());

    return argList;
};

logger.on('all', function(type, argList) {
    // It's not affected by log level.
});

logger.on('debug', function(argList) {
    // Affected by log level.
});

Lru

source test1.4.5

简单 LRU 缓存。

类型定义
class Lru {
    constructor(max: number);
    has(key: string): boolean;
    remove(key: string): void;
    get(key: string): any;
    set(key: string, val: any): void;
    clear(): void;
}

constructor

参数名说明
max最大缓存数

has

检查是否有缓存。

参数名说明
key缓存键名
返回值如果有,返回真

remove

删除缓存。

参数名说明
key缓存键名

get

获取缓存。

参数名说明
key缓存键名
返回值缓存值

set

设置缓存。

参数名说明
key缓存键名
val缓存值

clear

清除所有缓存。

const cache = new Lru(50);
cache.set('test', 'licia');
cache.get('test'); // -> 'licia'

MediaQuery

source test demo1.5.2

CSS 媒体查询监听器。

类型定义
class MediaQuery extends Emitter {
    constructor(query: string);
    setQuery(query: string): void;
    isMatch(): boolean;
}

继承自 Emitter 类。

constructor

参数名说明
query媒体查询字符串

setQuery

更新查询字符串。

isMatch

如果媒体查询匹配,返回真。

事件

match

当媒体查询匹配时触发。

unmatch

与 match 事件相反。

const mediaQuery = new MediaQuery('screen and (max-width:1000px)');
mediaQuery.isMatch(); // -> false
mediaQuery.on('match', () => {
    // Do something...
});

MutationObserver

source test1.0.0

MutationObserver 安全版本,如果不支持,则什么也不做。

const observer = new MutationObserver(function(mutations) {
    // Do something.
});
observer.observe(document.documentElement);
observer.disconnect();

PriorityQueue

source test1.11.0

优先队列实现。

类型定义
class PriorityQueue {
    size: number;
    constructor(cmp?: types.AnyFn);
    clear(): void;
    enqueue(item: any): number;
    dequeue(): any;
    peek(): any;
}

size

队列大小。

constructor

参数名说明
cmp比较器

clear

清空队列。

enqueue

元素入列。

参数名说明
item入列元素
返回值当前大小

dequeue

获取并删除队列中拥有最高优先级的元素。

peek

同 dequeue,只是不删除。

const queue = new PriorityQueue(function(a, b) {
    if (a.priority > b.priority) return 1;
    if (a.priority === b.priority) return -1;
    return 0;
});
queue.enqueue({
    priority: 1000,
    value: 'apple'
});
queue.enqueue({
    priority: 500,
    value: 'orange'
});
queue.dequeue(); // -> { priority: 1000, value: 'apple' }

Promise

source test demo1.0.0

轻量 Promise 实现。

Promises 标准

function get(url) {
    return new Promise(function(resolve, reject) {
        const req = new XMLHttpRequest();
        req.open('GET', url);
        req.onload = function() {
            req.status == 200
                ? resolve(req.response)
                : reject(Error(req.statusText));
        };
        req.onerror = function() {
            reject(Error('Network Error'));
        };
        req.send();
    });
}

get('test.json').then(function(result) {
    // Do something...
});

PseudoMap

source test1.0.0

类似 es6 的 Map,不支持遍历器。

类型定义
const PseudoMap: typeof Map;

只支持字符串键名,当 Map 存在时会直接使用 Map。

const map = new PseudoMap();
map.set('1', 1);
map.get('1'); // -> 1

Queue

source test1.0.0

队列数据结构。

类型定义
class Queue {
    size: number;
    clear(): void;
    enqueue(item: any): number;
    dequeue(): any;
    peek(): any;
    forEach(iterator: types.AnyFn, context?: any): void;
    toArr(): any[];
}

size

队列大小。

clear

清空队列。

enqueue

元素入列。

参数名说明
item入列元素
返回值当前大小

dequeue

元素出列。

peek

获取第一个元素但不移除它。

forEach

遍历队列。

参数名说明
iterator调用函数
ctx*函数上下文

toArr

将队列转换为 JavaScript 数组。

const queue = new Queue();

console.log(queue.size); // -> 0
queue.enqueue(2);
queue.enqueue(3);
queue.dequeue(); // -> 2
console.log(queue.size); // -> 1
queue.peek(); // -> 3
console.log(queue.size); // -> 1

QuickLru

source test benchmark1.4.5

不使用链表的 LRU 实现。

类型定义
class QuickLru {
    constructor(max: number);
    has(key: string): boolean;
    remove(key: string): void;
    get(key: string): any;
    set(key: string, val: any): void;
    clear(): void;
}

参考 hashlru 算法,空间占用相比使用链表更多。

API 与 Lru 模块保持一致。

const cache = new QuickLru(50);
cache.set('test', 'licia');
cache.get('test'); // -> 'licia'

Readiness

source test1.32.0

任务就绪回调管理。

类型定义
class Readiness {
    signal(tasks: string | string[]): void;
    isReady(tasks: string | string[]): boolean;
    ready(tasks: string | string[], fn?: types.AnyFn): Promise<void>;
}

signal

设置任务为就绪状态。

参数名说明
tasks就绪任务

ready

注册任务就绪回调。

参数名说明
tasks要监听的任务
fn任务就绪时触发的回调函数
返回值任务就绪时 resolve 的 Promise

isReady

检查任务是否准备就绪。

参数名说明
tasks要检查的任务
返回值任务准备就绪,返回真
const readiness = new Readiness();
readiness.ready('serverCreated', function() {
    // Do something.
});
readiness.signal('serverCreated');
readiness.isReady('serverCreated'); // -> true

ReduceStore

source test1.0.0

简单类 redux 状态管理。

类型定义
class ReduceStore {
    constructor(reducer: types.AnyFn, initialState: any);
    subscribe(listener: types.AnyFn): types.AnyFn;
    dispatch(action: any): any;
    getState(): any;
}

constructor

参数名说明
reducer生成下一个状态的函数
initialState初始状态

subscribe

订阅状态改变事件。

参数名说明
listener回调函数
返回值取消订阅函数

dispatch

发出动作。

参数名说明
action描述改变内容的对象
返回值传入对象

getState

获取当前状态。

const store = new ReduceStore(function(state, action) {
    switch (action.type) {
        case 'INCREMENT':
            return state + 1;
        case 'DECREMENT':
            return state - 1;
        default:
            return state;
    }
}, 0);

store.subscribe(function() {
    console.log(store.getState());
});

store.dispatch({ type: 'INCREMENT' }); // 1
store.dispatch({ type: 'INCREMENT' }); // 2
store.dispatch({ type: 'DECREMENT' }); // 1

ResizeSensor

source test demo1.29.0

检查元素的大小是否发生变化。

类型定义
class ResizeSensor extends SingleEmitter {
    constructor(el: HTMLElement);
    destroy(): void;
}

constructor

参数名说明
element要监听大小的元素

destroy

停止监听大小变化事件。

const target = document.getElementById('test');
const sensor = new ResizeSensor(target);
sensor.addListener(function() {
    // Trigger if element's size changed.
});

Select

source test1.0.0

querySelectorAll 的简单包装类。

类型定义
class Select {
    constructor(selector: string | Element | Document);
    find(selector: string): Select;
    each(fn: types.AnyFn): Select;
}

constructor

参数名说明
selector选择器

find

查找子元素。

参数名说明
selector选择器

each

遍历匹配的元素。

参数名说明
fn调用函数
const $test = new Select('#test');
$test.find('.test').each(function(idx, element) {
    // Manipulate dom nodes
});

Semaphore

source test1.20.0

限制资源同时访问次数。

类型定义
class Semaphore {
    constructor(counter?: number);
    wait(fn: () => void): void;
    signal(): void;
}

constructor

参数名说明
counter=1初始计数

wait

等待计数器大于 0 时,执行函数。

参数名说明
fn要执行的函数

signal

执行队列中未执行任务。

const sem = new Semaphore(10);
require('http')
    .createServer((req, res) => {
        sem.wait(function() {
            res.end('.');
            setTimeout(() => sem.signal(), 500);
        });
    })
    .listen(3000);

SessionStore

source test1.0.0

SessionStorage 存储。

类型定义
class SessionStore extends Store {
    constructor(name: string, data?: any);
}

继承自 Store 类。

constructor

参数名说明
nameSessionStorage 存储名
data默认数据
const store = new SessionStore('licia');
store.set('name', 'licia');

SingleEmitter

source test1.29.0

与 Event emitter 类似,但仅有一种事件类型。

类型定义
class SingleEmitter {
    addListener(listener: types.AnyFn): void;
    rmListener(listener: types.AnyFn): void;
    emit(...args: any[]): void;
    rmAllListeners(): void;
    static mixin(obj: any): void;
}

addListener

添加监听器。

rmListener

移除监听器。

参数名说明
listener事件监听器

rmAllListeners

移除所有监听器。

emit

触发监听器。

参数名说明
...args传递给监听器的参数

mixin

【静态】将 SingleEmitter 类的方法绑定到指定对象上去。

参数名说明
obj目标对象
const event = new SingleEmitter();
event.addListener(function(name) {
    console.log(name);
});
event.emit('licia'); // Logs out 'licia'.

Socket

source test1.22.0

WebSocket 类的简单包装。

类型定义
class Socket extends Emitter {
    constructor(
        url: string,
        options?: {
            protocols?: string | string[];
            reconnect?: boolean;
        }
    );
    send(message: any): void;
    close(code?: number, reason?: string): void;
    connect(): void;
}

继续自 Emitter 类。

constructor

参数名说明
urlWebSocket 地址
options连接选项

可用选项:

参数名说明
protocols协议
reconnect=true是否尝试重新连接

send

发送数据。

参数名说明
message要发送的数据

close

关闭 WebSocket 连接。

参数名说明
code状态码
reason关闭原因

connect

连接 WebSocket,初始化时就会被调用。

const ws = new Socket('ws://localhost:8001');
ws.on('open', e => ws.send('Hello'));

Stack

source test1.0.0

栈数据结构。

类型定义
class Stack {
    size: number;
    clear(): void;
    push(item: any): number;
    pop(): any;
    peek(): any;
    forEach(iterator: types.AnyFn, context?: any): void;
    toArr(): any[];
}

size

栈大小。

clear

清空栈。

push

元素入栈。

参数名说明
item入栈元素
返回值当前大小

pop

元素出栈。

peek

获取最后一个元素但不移除它。

forEach

遍历栈。

参数名说明
iterator调用函数
ctx函数上下文

toArr

将栈转换为 JavaScript 数组。

const stack = new Stack();

stack.push(2); // -> 1
stack.push(3); // -> 2
stack.pop(); // -> 3

State

source test1.0.0

简单状态机。

类型定义
class State extends Emitter {
    constructor(initial: string, events: any);
    is(state: string): boolean;
    [event: string]: any;
}

继承自 Emitter 类。

constructor

参数名说明
initial初始状态
events改变状态的事件

is

检查当前状态是否是指定状态。

参数名说明
state要检查的状态
返回值如果是,返回真
const state = new State('empty', {
    load: { from: 'empty', to: 'pause' },
    play: { from: 'pause', to: 'play' },
    pause: { from: ['play', 'empty'], to: 'pause' },
    unload: { from: ['play', 'pause'], to: 'empty' }
});

state.is('empty'); // -> true
state.load();
state.is('pause'); // -> true
state.on('play', function(src) {
    console.log(src); // -> 'eustia'
});
state.on('error', function(err, event) {
    // Error handler
});
state.play('eustia');

Store

source test1.0.0

内存存储。

类型定义
class Store extends Emitter {
    constructor(data?: {});
    set(key: string, val: any): void;
    set(values: {}): void;
    get(key: string): any;
    get(keys: string[]): {};
    remove(key: string): void;
    remove(keys: string[]): void;
    clear(): void;
    each(fn: (...args: any[]) => void): void;
}

继承自 Emitter 类。

constructor

参数名说明
data初始数据

set

设置值。

参数名说明
key键名
val键值

设置多个值。

参数名说明
values包含多个键值对的对象

该方法被调用时发触发 change 事件。

get

获取值。

参数名说明
key键名
返回值键值

获取多个值。

参数名说明
keys键名列表
返回值包含多个键值对的对象

remove

移除值。

参数名说明
key键名

clear

清空数据。

each

遍历数据。

参数名说明
fn遍历函数
const store = new Store('test');
store.set('user', { name: 'licia' });
store.get('user').name; // -> 'licia'
store.clear();
store.each(function(val, key) {
    // Do something.
});
store.on('change', function(key, newVal, oldVal) {
    // It triggers whenever set is called.
});

Trace

source test1.33.0

解析、处理和生成 Chrome Trace 格式数据。

类型定义
namespace Trace {
    interface IEvent {
        name: string;
        cat: string;
        ph: string;
        ts: number;
        pid: number;
        tid: number;
        args: any;
        [key: string]: any;
    }
    class Process {
        constructor(id);
        id(): string;
        name(): string;
        addEvent(IEvent): void;
        rmEvent(IEvent): void;
        getThread(id: number): Thread;
        rmThread(id: number): void;
        threads(): Thread[];
        toJSON(): IEvent[];
    }
    class Thread {
        constructor(id, pid);
        id(): string;
        name(): string;
        addEvent(IEvent): void;
        rmEvent(IEvent): void;
        events(): IEvent[];
        toJSON(): IEvent[];
    }
}
class Trace {
    constructor(events: Trace.IEvent[]);
    addEvent(event: Trace.IEvent);
    rmEvent(event: Trace.IEvent);
    getProcess(id: number): Trace.Process;
    rmProcess(id: number): void;
    processes(): Trace.Process[];
    toJSON(): Trace.IEvent[];
}
const fs = require('fs');
const data = fs.readFileSync('path/to/trace', 'utf8');
const trace = new Trace(JSON.parse(data));
trace.rmProcess(627);
fs.writeFileSync(
    'path/to/trace',
    JSON.stringify(trace.toJSON()),
    'utf8',
    function() {}
);

Tracing

source test1.33.0

创建 chrome trace 格式数据。

类型定义
class Tracing {
    constructor(options?: {
        pid?: number;
        tid?: number;
        processName?: string;
        threadName?: string;
    });
    start(cat?: string): void;
    stop(): Trace.IEvent[];
    metadata(name: string, args: any): void;
    begin(cat: string, name: string, args?: any): void;
    end(args?: any): void;
    asyncBegin(cat: string, name: string, id?: string, args?: any): string;
    asyncEnd(id: string, args?: any): void;
    instant(
        cat: string,
        name: string,
        scope?: 'g' | 'p' | 't',
        args?: any
    ): void;
    id(): string;
}

constructor

参数名说明
options录制选项

可用选项:

参数名说明
pid进程 id
tid线程 id
processName进程名称
threadName线程名称

start

开始录制。

参数名说明
cat开启类别

stop

停止录制并获取事件列表。

begin

记录开始事件。

参数名说明
cat事件类别
name事件名称
args参数

end

记录结束事件。

asyncBegin

记录异步开始事件。

asyncEnd

记录异步结束事件。

instant

记录 instant 事件。

id

获取一个唯一 id。

const fs = require('fs');
const tracing = new Tracing();
tracing.start();
tracing.begin('cat', 'name');
// Do something...
tracing.end();
fs.writeFileSync(
    'path/to/trace',
    JSON.stringify(tracing.stop()),
    'utf8',
    function() {}
);

Trie

source test1.25.0

字典树数据结构。

类型定义
class Trie {
    add(word: string): void;
    remove(word: string): void;
    has(word: string): boolean;
    words(prefix: string): string[];
    clear(): void;
}

add

添加单词到字典数。

参数名说明
word要添加的单词

remove

从字典树中移除单词。

has

检查字典树中是否存在单词。

words

获取所有带指定前缀的单词。

参数名说明
prefix单词前缀
返回值所有带指定前缀的单词

clear

清除字典树中的所有单词。

const trie = new Trie();
trie.add('carpet');
trie.add('car');
trie.add('cat');
trie.add('cart');
trie.has('cat'); // -> true
trie.remove('carpet');
trie.has('carpet'); // -> false
trie.words('car'); // -> ['car', 'cart']
trie.clear();

Tween

source test demo1.0.0

JavaScript 补间动画库。

类型定义
class Tween extends Emitter {
    constructor(target: any);
    to(props: any, duration?: number, ease?: string | Function): Tween;
    progress(): number;
    progress(progress: number): Tween;
    play(): Tween;
    pause(): Tween;
    paused(): boolean;
}

继承自 Emitter 类。

constructor

参数名说明
obj要补间的对象

to

参数名说明
destination目标属性值
duration补间时长
ease缓动函数

play

开始播放。

pause

暂停动画。

paused

检查动画是否暂停。

progress

设置或获取动画进度。

参数名说明
progress介于 0 到 1 之间的数字
const pos = { x: 0, y: 0 };

const tween = new Tween(pos);
tween
    .on('update', function(target) {
        console.log(target.x, target.y);
    })
    .on('end', function(target) {
        console.log(target.x, target.y); // -> 100, 100
    });
tween.to({ x: 100, y: 100 }, 1000, 'inElastic').play();

Url

source test1.0.0

简单 url 操作库。

类型定义
namespace Url {
    interface IUrl {
        protocol: string;
        auth: string;
        hostname: string;
        hash: string;
        query: any;
        port: string;
        pathname: string;
        slashes: boolean;
    }
}
class Url {
    protocol: string;
    auth: string;
    hostname: string;
    hash: string;
    query: any;
    port: string;
    pathname: string;
    slashes: boolean;
    constructor(url?: string);
    setQuery(name: string, val: string | number): Url;
    setQuery(query: types.PlainObj<string | number>): Url;
    rmQuery(name: string | string[]): Url;
    toString(): string;
    static parse(url: string): Url.IUrl;
    static stringify(object: Url.IUrl): string;
}

constructor

参数名说明
url=locationurl 地址

setQuery

设置 query 值。

参数名说明
namequery 名
valquery 值
返回值this
参数名说明
queryquery 对象
返回值this

rmQuery

移除 query 值。

参数名说明
namequery 名
返回值this

parse

【静态】将 url 解析成对象。

参数名说明
urlurl 地址
返回值url 对象

stringify

【静态】将 url 对象转换为 url 地址。

参数名说明
urlurl 对象
返回值url 地址

url 对象包含以下属性值:

属性名说明
protocol协议名,(如 http:)
slashes协议名后是否有双斜杠
auth身份验证(例如 用户名:密码)
hostnameHost 名,不带端口号
port端口号
pathnameURL 路径
queryquery 对象
hashURL # 字符后边的部分,# 包含在内
const url = new Url('http://example.com:8080?eruda=true');
console.log(url.port); // -> '8080'
url.query.foo = 'bar';
url.rmQuery('eruda');
url.toString(); // -> 'http://example.com:8080/?foo=bar'

Validator

source test1.0.0

对象属性值校验。

类型定义
class Validator {
    constructor(options: types.PlainObj<any>);
    validate(object: any): string | boolean;
    static plugins: any;
    static addPlugin(name: string, plugin: types.AnyFn): void;
}

constructor

参数名说明
options校验配置

validate

校验对象。

参数名说明
obj目标对象
返回值校验结果,true 表示通过

addPlugin

【静态】添加插件。

参数名说明
name插件名
plugin校验函数

默认插件

required,number,boolean,string 和 regexp。

Validator.addPlugin('custom', function(val, key, config) {
    if (typeof val === 'string' && val.length === 5) return true;

    return key + ' should be a string with length 5';
});
const validator = new Validator({
    test: {
        required: true,
        custom: true
    }
});
validator.validate({}); // -> 'test is required'
validator.validate({ test: 1 }); // -> 'test should be a string with length 5';
validator.validate({ test: 'licia' }); // -> true

Wrr

source test1.21.0

加权轮询调度算法实现。

类型定义
class Wrr {
    size: number;
    set(val: any, weight: number): void;
    get(val: any): number | void;
    remove(val: any): void;
    clear(): void;
    next(): any;
}

size

池大小。

set

设置值和权重,如果值已存在则更新其权重。

参数名说明
val要设置的值
weight值的权重

get

获取指定值的权重。

参数名说明
val要获取的值
返回值值的权重

remove

移除指定值。

参数名说明
val要移除的值

next

从池中获取下一个值。

clear

清除所有值。

const pool = new Wrr();
pool.set('A', 4);
pool.set('B', 8);
pool.set('C', 2);
pool.next();
pool.remove('A');
console.log(pool.size); // -> 2

abbrev

source test1.0.0

计算字符串集的缩写集合。

类型定义
function abbrev(...names: string[]): types.PlainObj<string>;
参数名说明
names字符串集
返回值缩写集合
abbrev('lina', 'luna');
// -> {li: 'lina', lin: 'lina', lina: 'lina', lu: 'luna', lun: 'luna', luna: 'luna'}

after

source test1.0.0

创建一个函数,只有在调用 n 次后才会调用一次。

类型定义
function after<T extends types.AnyFn>(n: number, fn: T): T;
参数名说明
n调用次数
fn源函数
返回值输出函数
const fn = after(5, function() {
    // -> Only invoke after fn is called 5 times.
});

ajax

source test1.0.0

执行异步 HTTP 请求。

类型定义
namespace ajax {
    function get(
        url: string,
        data: string | {},
        success: types.AnyFn,
        dataType?: string
    ): XMLHttpRequest;
    function get(
        url: string,
        success: types.AnyFn,
        dataType?: string
    ): XMLHttpRequest;
    function post(
        url: string,
        data: string | {},
        success: types.AnyFn,
        dataType?: string
    ): XMLHttpRequest;
    function post(
        url: string,
        success: types.AnyFn,
        dataType?: string
    ): XMLHttpRequest;
}
function ajax(options: {
    type?: string;
    url: string;
    data?: string | {};
    dataType?: string;
    contentType?: string;
    success?: types.AnyFn;
    error?: types.AnyFn;
    complete?: types.AnyFn;
    timeout?: number;
}): XMLHttpRequest;
参数名说明
optionsAjax 选项

可用选项:

参数名说明
type请求类型
url请求地址
data请求数据
dataType=json响应类型(json,xml)
contentType=application/x-www-form-urlencoded请求内容类型
success成功回调
error失败回调
complete结束回调
timeout请求超时

get

type = GET 的快捷方式。

post

type = POST 的快捷方式。

参数名说明
url请求地址
data请求数据
success成功回调
dataType响应类型
ajax({
    url: 'http://example.com',
    data: { test: 'true' },
    error() {},
    success(data) {
        // ...
    },
    dataType: 'json'
});

ajax.get('http://example.com', {}, function(data) {
    // ...
});

allKeys

source test1.0.0

获取对象的所有键名,包括自身的及继承的。

类型定义
namespace allKeys {
    interface IOptions {
        prototype?: boolean;
        unenumerable?: boolean;
    }
}
function allKeys(
    obj: any,
    options: { symbol: true } & allKeys.IOptions
): Array<string | Symbol>;
function allKeys(
    obj: any,
    options?: ({ symbol: false } & allKeys.IOptions) | allKeys.IOptions
): string[];
参数名说明
obj目标对象
options选项
返回值包含所有键名的数组

可用选项:

参数名说明
prototype=true包含原型键名
unenumerable=false包含不可枚举键名
symbol=false包含 Symbol 键名

Object 对象原型上的方法不会被获取到。

const obj = Object.create({ zero: 0 });
obj.one = 1;
allKeys(obj); // -> ['zero', 'one']

ansiColor

source test1.4.1

控制台颜色。

类型定义
namespace ansiColor {
    type IFn = (str: string) => string;
}
const ansiColor: {
    black: ansiColor.IFn;
    red: ansiColor.IFn;
    green: ansiColor.IFn;
    yellow: ansiColor.IFn;
    blue: ansiColor.IFn;
    magenta: ansiColor.IFn;
    cyan: ansiColor.IFn;
    white: ansiColor.IFn;
    gray: ansiColor.IFn;
    grey: ansiColor.IFn;
    bgBlack: ansiColor.IFn;
    bgRed: ansiColor.IFn;
    bgGreen: ansiColor.IFn;
    bgYellow: ansiColor.IFn;
    bgBlue: ansiColor.IFn;
    bgMagenta: ansiColor.IFn;
    bgCyan: ansiColor.IFn;
    bgWhite: ansiColor.IFn;
    blackBright: ansiColor.IFn;
    redBright: ansiColor.IFn;
    greenBright: ansiColor.IFn;
    yellowBright: ansiColor.IFn;
    blueBright: ansiColor.IFn;
    magentaBright: ansiColor.IFn;
    cyanBright: ansiColor.IFn;
    whiteBright: ansiColor.IFn;
    bgBlackBright: ansiColor.IFn;
    bgRedBright: ansiColor.IFn;
    bgGreenBright: ansiColor.IFn;
    bgYellowBright: ansiColor.IFn;
    bgBlueBright: ansiColor.IFn;
    bgMagentaBright: ansiColor.IFn;
    bgCyanBright: ansiColor.IFn;
    bgWhiteBright: ansiColor.IFn;
};

支持颜色

black, red, green, yellow, blue, magenta, cyan, white, gray, grey

bgBlack, bgRed, bgGreen, bgYellow, bgBlue, bgMagenta, bgCyan, bgWhite,

blackBright, redBright, greenBright, yellowBright, blueBright, magentaBright, cyanBright, whiteBright

bgBlackBright, bgRedBright, bgGreenBright, bgYellowBright, bgBlueBright, bgMagentaBright, bgCyanBright, bgWhiteBright

ansiColor.red('Warning');

arrToMap

source test1.0.0

将字符串列表转换为映射。

类型定义
function arrToMap<T>(
    arr: string[],
    val?: T
): { [key: string]: T };
参数名说明
arr字符串列表
val=true键值
返回值映射
const needPx = arrToMap([
    'column-count',
    'columns',
    'font-weight',
    'line-weight',
    'opacity',
    'z-index',
    'zoom'
]);
const key = 'column-count';
let val = '5';
if (needPx[key]) val += 'px';
console.log(val); // -> '5px'

atob

source test1.0.0

window.atob,运行在 node 环境时使用 Buffer 进行模拟。

类型定义
function atob(str: string): string;
atob('SGVsbG8gV29ybGQ='); // -> 'Hello World'

average

source test1.0.0

获取数字的平均值。

类型定义
function average(...numbers: number[]): number;
参数名说明
numbers要计算的数字
返回值平均值
average(5, 3, 1); // -> 3

base64

source test1.0.0

base64 编解码。

类型定义
const base64: {
    encode(bytes: number[]): string;
    decode(str: string): number[];
};

encode

将字节数组编码为 base64 字符串。

参数名说明
bytes字节数组
返回值base64 编码的字符串

decode

将 base64 字符串解码为字节数组。

参数名说明
strbase64 编码的字符串
返回值字节数组
base64.encode([168, 174, 155, 255]); // -> 'qK6b/w=='
base64.decode('qK6b/w=='); // -> [168, 174, 155, 255]

before

source test1.0.0

创建一个函数,只能调用少于 n 次。

类型定义
function before<T extends types.AnyFn>(n: number, fn: T): T;
参数名说明
n调用次数
fn源函数
返回值输出函数

超过 n 次后再次调用函数将直接返回最后一次函数的调用结果。

const fn = before(5, function() {});
fn(); // Allow function to be call 4 times at last.

binarySearch

source test1.4.0

二分查找实现。

类型定义
function binarySearch(
    array: any[],
    val: any,
    cmp?: types.AnyFn
): number;
参数名说明
array目标数组
val要查找的值
cmp比较器
返回值第一次出现的位置,如果没有,返回 -1
binarySearch([1, 2, 3], 2); // -> 1
binarySearch([1, 2], 3); // -> -1
binarySearch(
    [
        {
            key: 1
        },
        {
            key: 2
        }
    ],
    { key: 1 },
    (a, b) => {
        if (a.key === b.key) return 0;
        return a.key < b.key ? -1 : 1;
    }
); // -> 0

bind

source test1.0.0

创建一个绑定到指定对象的函数。

类型定义
function bind(
    fn: types.AnyFn,
    ctx: any,
    ...args: any[]
): types.AnyFn;
参数名说明
fn源函数
ctx绑定对象
args可选参数
返回值输出函数
const fn = bind(
    function(msg) {
        console.log(this.name + ':' + msg);
    },
    { name: 'eustia' },
    'I am a utility library.'
);
fn(); // -> 'eustia: I am a utility library.'

btoa

source test1.0.0

window.btoa,运行在 node 环境时使用 Buffer 进行模拟。

类型定义
function btoa(str: string): string;
btoa('Hello World'); // -> 'SGVsbG8gV29ybGQ='

bubbleSort

source test1.0.0

冒泡排序实现。

类型定义
function bubbleSort(arr: any[], cmp?: types.AnyFn): any[];
参数名说明
arr要排序的数组
cmp比较器
返回值有序数组
bubbleSort([2, 1]); // -> [1, 2]

bytesToStr

source test1.1.0

将字节数组转换为字符串。

类型定义
function bytesToStr(bytes: number[], encoding?: string): string;
参数名说明
bytes字节数组
encoding=utf8字符串编码
返回值目标字符串
bytesToStr([108, 105, 99, 105, 97]); // -> 'licia'

bytesToWords

source test1.16.0

将字节数组转换为 32 位字长数组。

类型定义
function bytesToWords(bytes: number[]): number[];

在使用 CryptoJS 时会派上用处。

参数名说明
bytes字节数组
返回值字长数组
bytesToWords([0x12, 0x34, 0x56, 0x78]); // -> [0x12345678]

cacheRequire

source test benchmark1.32.0

缓存模块加载,提高应用启动速度。

类型定义
function cacheRequire(options?: {
    dir?: string;
    requirePath?: boolean;
    code?: boolean;
    compileCache?: boolean;
}): void;
参数名说明
options缓存选项

可用选项:

参数名说明
dir缓存文件夹
requirePath=trueWhether require path should be cached
code=falseWhether js code should be cached
compileCache=trueWhether compile cache should be used
cacheRequire({
    dir: 'path/to/cache/dir'
});

callbackify

source test1.0.0

将返回 Promise 的函数转换为使用回调的函数。

类型定义
function callbackify(fn: types.AnyFn): types.AnyFn;
参数名说明
fn返回 Promise 的函数
返回值使用回调的函数
function fn() {
    return new Promise(function(resolve, reject) {
        // ...
    });
}

const cbFn = callbackify(fn);

cbFn(function(err, value) {
    // ...
});

camelCase

source test1.0.0

将字符串转换为驼峰式。

类型定义
function camelCase(str: string): string;
参数名说明
str源字符串
返回值驼峰式字符串
camelCase('foo-bar'); // -> fooBar
camelCase('foo bar'); // -> fooBar
camelCase('foo_bar'); // -> fooBar
camelCase('foo.bar'); // -> fooBar

capitalize

source test1.0.0

将字符串的第一个字符转换为大写,其余字符转换为小写。

类型定义
function capitalize(str: string): string;
参数名说明
str源字符串
返回值目标字符串
capitalize('rED'); // -> Red

castPath

source test1.0.0

将值转换为属性路径数组。

类型定义
function castPath(path: string | string[], obj?: any): string[];
参数名说明
path要转换的值
obj目标对象
返回值属性路径数组
castPath('a.b.c'); // -> ['a', 'b', 'c']
castPath(['a']); // -> ['a']
castPath('a[0].b'); // -> ['a', '0', 'b']
castPath('a.b.c', { 'a.b.c': true }); // -> ['a.b.c']

centerAlign

source test1.0.0

字符串居中。

类型定义
function centerAlign(
    str: string | string[],
    width?: number
): string;
参数名说明
str源字符串
width每行宽度
返回值居中字符串
centerAlign('test', 8); // -> '  test'
centerAlign('test\nlines', 8); // -> '  test\n lines'
centerAlign(['test', 'lines'], 8); // -> '  test\n lines'

cgroup

source test1.35.0

在容器内读取 cgroup 信息。

类型定义
const cgroup: {
    cpu: {
        stat(): {
            usage: number;
        };
        max(): number;
    };
    cpuset: {
        cpus(): {
            effective: number[];
        };
    };
    memory: {
        max(): number;
        current(): number;
    };
    version(): number;
};
cgroup.cpu.stat();

char

source test1.0.0

根据指定的整数返回 unicode 编码为该整数的字符。

类型定义
function char(num: number): string;
参数名说明
num要转换的整数
返回值对应字符
char(65); // -> 'A'
char(97); // -> 'a'

chunk

source test1.0.0

将数组拆分为指定长度的子数组。

类型定义
function chunk(arr: any[], size?: number): Array<any[]>;
参数名说明
arr源数组
size=1子数组的长度
返回值目标数组
chunk([1, 2, 3, 4], 2); // -> [[1, 2], [3, 4]]
chunk([1, 2, 3, 4], 3); // -> [[1, 2, 3], [4]]
chunk([1, 2, 3, 4]); // -> [[1], [2], [3], [4]]

clamp

source test1.0.0

将数字限定于指定区间。

类型定义
function clamp(n: number, lower: number, upper: number): number;
function clamp(n: number, upper: number): number;
参数名说明
n要处理的数字
lower下限
upper上限
返回值限定后的数字
clamp(-10, -5, 5); // -> -5
clamp(10, -5, 5); // -> 5
clamp(2, -5, 5); // -> 2
clamp(10, 5); // -> 5
clamp(2, 5); // -> 2

className

source test1.0.0

合并 class。

类型定义
function className(...names: any[]): string;
参数名说明
names要合并的 class
返回值合并后的 class 字符串
className('a', 'b', 'c'); // -> 'a b c'
className('a', false, 'b', 0, 1, 'c'); // -> 'a b 1 c'
className('a', ['b', 'c']); // -> 'a b c'
className('a', { b: false, c: true }); // -> 'a c'
className('a', ['b', 'c', { d: true, e: false }]); // -> 'a b c d';

cliHelp

source test1.27.0

输出命令行帮助。

类型定义
namespace cliHelp {
    interface IOption {
        name: string;
        shorthand?: string;
        desc: string;
    }
    interface ICommand {
        name: string;
        desc: string;
        usage: string | string[];
        options?: IOption[];
    }
    interface IData {
        name: string;
        usage: string | string[];
        commands: ICommand[];
    }
}
function cliHelp(data: cliHelp.IData | cliHelp.ICommand): string;
参数名说明
data帮助数据
返回值命令行帮助
const test = {
    name: 'test',
    desc: 'Generate test files',
    usage: ['<module-name> [options]', 'lpad --browser'],
    options: [
        {
            name: 'browser',
            shorthand: 'b',
            desc: 'True if test should run in a browser'
        }
    ]
};
const data = {
    name: 'licia',
    usage: '<command> [options]',
    commands: [test]
};

cliHelp(data);
cliHelp(test);

clone

source test1.0.0

对指定对象进行浅复制。

类型定义
function clone<T>(val: T): T;

任何嵌套的对象或数组只会拷贝其引用。

参数名说明
val要克隆的值
返回值克隆值
clone({ name: 'eustia' }); // -> {name: 'eustia'}

cloneDeep

source test1.0.0

深复制。

类型定义
function cloneDeep<T>(val: T): T;
参数名说明
val要克隆的值
返回值克隆值
const obj = [{ a: 1 }, { a: 2 }];
const obj2 = cloneDeep(obj);
console.log(obj[0] === obj2[1]); // -> false

cmpVersion

source test1.0.0

比较版本号。

类型定义
function cmpVersion(v1: string, v2: string): number;
参数名说明
v1版本号
v2版本号
返回值比较结果
cmpVersion('1.1.8', '1.0.4'); // -> 1
cmpVersion('1.0.2', '1.0.2'); // -> 0
cmpVersion('2.0', '2.0.0'); // -> 0
cmpVersion('3.0.1', '3.0.0.2'); // -> 1
cmpVersion('1.1.1', '1.2.3'); // -> -1

combine

source test1.1.0

创建一个数组,用一个数组的值作为其键名,另一个数组的值作为其值。

类型定义
function combine(keys: string[], values: any[]): any;
参数名说明
keys键名数组
values键值数组
返回值目标对象
combine(['a', 'b', 'c'], [1, 2, 3]); // -> {a: 1, b: 2, c: 3}

compact

source test1.0.0

返回数组的拷贝并移除其中的虚值。

类型定义
function compact(arr: any[]): any[];

虚值包括 false,null,0,空字符串,undefined 和 NaN。

参数名说明
arr源数组
返回值目标数组
compact([0, 1, false, 2, '', 3]); // -> [1, 2, 3]

compose

source test1.0.0

将多个函数组合成一个函数。

类型定义
function compose(...fn: types.AnyFn[]): types.AnyFn;

每个函数使用下一个函数的返回值作为参数。

参数名说明
...fn要组合的函数
返回值目标函数
const welcome = compose(
    function(name) {
        return 'hi: ' + name;
    },
    function(name) {
        return name.toUpperCase() + '!';
    }
);

welcome('licia'); // -> 'hi: LICIA!'

compressImg

source test demo1.0.0

使用 canvas 对图像进行压缩。

类型定义
function compressImg(
    file: File | Blob | string,
    cb: types.AnyFn
): void;
function compressImg(
    file: File | Blob | string,
    options?: {
        maxWidth?: number;
        maxHeight?: number;
        width?: number;
        height?: number;
        mimeType?: string;
        quality?: number;
    },
    cb?: types.AnyFn
): void;
参数名说明
file图片文件或 url
options选项
cb回调

可用选项:

参数名说明
maxWidth最大宽度
maxHeight最大高度
width输出图片宽度
height输出图片高度
mimeTypeMine 类型
quality=0.8图片质量,从 0 到 1

为了保持图片比例,当宽度设置时高度将被忽略。

如果设置了宽高,最大宽度跟最大高度将被忽略。

const file = new Blob([]);
compressImg(
    file,
    {
        maxWidth: 200
    },
    function(err, file) {
        // ...
    }
);

concat

source test1.0.0

将多个数组合并成一个数组。

类型定义
function concat(...args: Array<any[]>): any[];
参数名说明
...arr要合并的数组
返回值合并后的数组
concat([1, 2], [3], [4, 5]); // -> [1, 2, 3, 4, 5]

contain

source test1.0.0

检查数组中是否有指定值。

类型定义
function contain(arr: any[] | {} | string, val: any): boolean;
参数名说明
target目标对象
val要检查的值
返回值如果有,返回真
contain([1, 2, 3], 1); // -> true
contain({ a: 1, b: 2 }, 1); // -> true
contain('abc', 'a'); // -> true

container

source test1.35.0

在容器内读取容器信息。

类型定义
const container: {
    cpuNum(): number;
    cpuUsage(period?: number): Promise<number>;
    cpuLoad(period?: number): Promise<number>;
    memUsage(): number;
    memLoad(): number;
};
container.cpuNum();

convertBase

source test1.0.0

对数字进行进制转换。

类型定义
function convertBase(
    num: number | string,
    from: number,
    to: number
): string;
参数名说明
num要转换的数字
from源进制
to目标进制
返回值转换后的数字
convertBase('10', 2, 10); // -> '2'
convertBase('ff', 16, 2); // -> '11111111'

convertBin

source test1.5.0

二进制数据格式转换。

类型定义
namespace convertBin {
    function blobToArrBuffer(blob: any): Promise<ArrayBuffer>;
}
function convertBin(bin: any, type: string): any;
参数名说明
bin源二进制数据
type二进制类型
返回值目标二进制数据

支持格式

base64, ArrayBuffer, Array, Uint8Array, Blob(browser), Buffer(node)

因为将 Blob 转换为其它格式是个异步过程,所以你不能直接对它进行转换。

blobToArrBuffer

将 Blob 类型转换为 ArrayBuffer 类型。

参数名说明
blobBlob 数据
返回值ArrayBuffer promise
convertBin('qK6b/w==', 'Uint8Array'); // -> [168, 174, 155, 255]
convertBin.blobToArrBuffer(new Blob([])).then(arrBuffer => {
    // Do something...
});

source test1.0.0

浏览器 cookie 操作库。

类型定义
namespace cookie {
    interface IOptions {
        path?: string;
        expires?: number;
        domain?: string;
        secure?: boolean;
    }
    interface ICookie {
        get(key: string, options?: cookie.IOptions): string;
        set(key: string, val: string, options?: cookie.IOptions): ICookie;
        remove(key: string, options?: cookie.IOptions): ICookie;
    }
}
const cookie: cookie.ICookie;

get

获取 cookie 值。

参数名说明
keyCookie 键名
返回值对应的 cookie 值

set

设置 cookie 值。

参数名说明
keycookie 键名
valcookie 值
optionscookie 选项
返回值cookie 模块

remove

移除 cookie 值。

参数名说明
keyCookie 键名
optionsCookie 选项
返回值cookie 模块
cookie.set('a', '1', { path: '/' });
cookie.get('a'); // -> '1'
cookie.remove('a');

copy

source test demo1.0.0

使用 document.execCommand 将文本拷贝到剪贴板。

类型定义
function copy(text: string, cb?: types.AnyFn): void;
参数名说明
text要拷贝的文本
cb可选回调
copy('text', function(err) {
    // Handle errors.
});

crc1

source test1.5.7

CRC1 算法实现。

类型定义
function crc1(
    input: string | number[],
    previous?: number
): number;
参数名说明
input信息码
previous用于累积计算的 CRC1 校验码
返回值CRC1 校验码
crc1('1234567890').toString(16); // -> 'd'

crc16

source test1.5.9

CRC16 算法实现。

类型定义
function crc16(
    input: string | number[],
    previous?: number
): number;
参数名说明
input信息码
previous用于累积计算的 CRC16 校验码
返回值CRC16 校验码
crc16('1234567890').toString(16); // -> 'c57a'

crc32

source test1.5.9

CRC32 算法实现。

类型定义
function crc32(
    input: string | number[],
    previous?: number
): number;
参数名说明
input信息码
previous用于累积计算的 CRC32 校验码
返回值CRC32 校验码
crc32('1234567890').toString(16); // -> '261daee5'

crc8

source test1.5.9

CRC8 算法实现。

类型定义
function crc8(
    input: string | number[],
    previous?: number
): number;
参数名说明
input信息码
previous用于累积计算的 CRC8 校验码
返回值CRC8 校验码
crc8('1234567890').toString(16); // -> '52'

create

source test1.16.0

创建对象并指定它的原型。

类型定义
function create(proto?: object): any;
参数名说明
proto新对象原型
返回值目标对象
const obj = create({ a: 1 });
console.log(obj.a); // -> 1

createAssigner

source test1.0.0

用于创建 extend,extendOwn 和 defaults 等模块。

类型定义
function createAssigner(
    keysFn: types.AnyFn,
    defaults: boolean
): types.AnyFn;
参数名说明
keysFn获取对象键名的函数
defaults设置为真时不对值进行覆盖
返回值目标函数

createUrl

source test1.0.0

CreateObjectURL 的包裹函数。

类型定义
function createUrl(
    data: any,
    options?: { type?: string }
): string;
参数名说明
data数据
options当数据不是 File 或者 Blob 对象时使用
返回值Blob 地址
createUrl('test', { type: 'text/plain' }); // -> Blob url
createUrl(['test', 'test']);
createUrl(new Blob([]));
createUrl(new File(['test'], 'test.txt'));

css

source test1.14.0

CSS 解析器。

类型定义
const css: {
    parse(css: string): object;
    stringify(stylesheet: object, options?: { indent?: string }): string;
};

注释会被移除掉。

parse

将 CSS 字符串转换为 js 对象。

参数名说明
cssCSS 字符串
返回值js 对象

stringify

将 js 对象序列化成 CSS 字符串。

参数名说明
stylesheet要序列化的对象
options序列化选项
返回值CSS 字符串

选项:

参数名说明
indent=' '缩进
const stylesheet = css.parse('.name { background: #000; color: red; }');
// {type: 'stylesheet', rules: [{type: 'rule', selector: '.name', declarations: [...]}]}
css.stringify(stylesheet);

cssPriority

source test1.29.0

计算与比较 CSS 选择器/样式的优先级。

类型定义
namespace cssPriority {
    function compare(p1: number[], p2: number[]): number;
}
function cssPriority(
    selector: string,
    options?: {
        important?: boolean;
        inlineStyle?: boolean;
        position?: number;
    }
): number[];
参数名说明
selectorCSS 选择器
options样式额外信息
返回值优先级数组

优先级数组包括六个数字值。

  1. important 标识
  2. 内联样式
  3. ID 选择器
  4. 类选择器
  5. 类型选择器
  6. 样式位置

compare

比较优先级。

参数名说明
p1优先级数组
p2优先级数组
返回值比较结果
cssPriority('a.button > i.icon:before', {
    important: true,
    inlineStyle: false,
    position: 100
}); // -> [1, 0, 0, 2, 3, 100]

cssSupports

source test1.0.0

检查浏览器是否支持某项 CSS 特性。

类型定义
function cssSupports(name: string, val?: string): boolean;
参数名说明
nameCss 属性名
valCss 属性值
返回值如果支持,返回真
cssSupports('display', 'flex'); // -> true
cssSupports('display', 'invalid'); // -> false
cssSupports('text-decoration-line', 'underline'); // -> true
cssSupports('grid'); // -> true
cssSupports('invalid'); // -> false

curry

source test1.0.0

函数柯里化。

类型定义
function curry(fn: types.AnyFn): types.AnyFn;
参数名说明
fn源函数
返回值目标函数
const add = curry(function(a, b) {
    return a + b;
});
const add1 = add(1);
add1(2); // -> 3

dateFormat

source test1.0.0

简单日期格式化。

类型定义
function dateFormat(
    date: Date,
    mask: string,
    utc?: boolean,
    gmt?: boolean
): string;
function dateFormat(
    mask: string,
    utc?: boolean,
    gmt?: boolean
): string;
参数名说明
date=new Date要格式化的日期对象
mask日期掩码
utc=false是否是 UTC
gmt=false是否是 GMT
返回值格式化日期
掩码说明
d月份天数,不补零
dd月份天数,不足两位补零
ddd星期几,简称
dddd星期几,全称
m月份,数字,不补零
mm月份,数字,不足两位补零
mmm月份,简称
mmmm月份,全称
yy年份,只显示后两位数字,不足两位补零
yyyy年份,显示四位数字
h小时,不补零 (12 小时制)
hh小时,不足两位补零(12 小时制)
H小时,不补零(24 小时制)
HH小时,不足两位补零(24 小时制)
M分钟,不补零
MM分钟,不足两位补零
s秒数,不补零
ss秒数,不足两位补零
l L毫秒,l 显示 3 位, L 显示 2 位
t小写显示上午下午,a 或 p
tt小写显示上午下午,am 或 pm
T大写显示上午下午,A 或 P
TT大写显示上午下午,AM 或 PM
Z美国时区缩写,比如 EST 或 MDT
oGMT/UTC 时区时差,比如 -0500 或 +0230
S月份天数序数后缀 (st,nd,rd,或 th)
UTC:是否是 UTC,必须写在最前面
dateFormat('isoDate'); // -> 2016-11-19
dateFormat('yyyy-mm-dd HH:MM:ss'); // -> 2016-11-19 19:00:04
dateFormat(new Date(), 'yyyy-mm-dd'); // -> 2016-11-19

debounce

source test1.0.0

返回函数的防反跳版本。

类型定义
function debounce<T extends types.AnyFn>(fn: T, wait: number): T;
参数名说明
fn源函数
wait延迟毫秒数
返回值目标函数
const calLayout = debounce(function() {}, 300);
// $(window).resize(calLayout);

debug

source test demo1.0.0

简单的 JavaScript 输出 debug 日志函数。

类型定义
function debug(name: string): any;
参数名说明
name名称
返回值打印格式化日志的函数
const d = debug('test');
d('doing lots of uninteresting work');
d.enabled = false;

deburr

source test1.6.1

转换拉丁语-1补充字母和拉丁语扩展字母-A为基本拉丁字母,并且去除组合变音标记。

类型定义
function deburr(str: string): string;
参数名说明
str要处理的字符串
返回值目标字符串
deburr('déjà vu'); // -> 'deja vu'

decodeUriComponent

source test1.0.0

类似 decodeURIComponent 函数,只是输入不合法时不抛出错误并尽可能地对其进行解码。

类型定义
function decodeUriComponent(str: string): string;
参数名说明
str要解码的字符串
返回值解码后的字符串
decodeUriComponent('%%25%'); // -> '%%%'
decodeUriComponent('%E0%A4%A'); // -> '\xE0\xA4%A'

defaults

source test1.0.0

填充对象的默认值。

类型定义
function defaults(obj: any, ...src: any[]): any;
参数名说明
obj目标对象
...src提供默认值对象
返回值目标对象
defaults({ name: 'RedHood' }, { name: 'Unknown', age: 24 }); // -> {name: 'RedHood', age: 24}

define

source test1.0.0

定义一个模块,需要跟 use 模块配合使用。

类型定义
function define(
    name: string,
    requires: string[],
    method: types.AnyFn
): void;
function define(name: string, method: types.AnyFn): void;
参数名说明
name模块名
requires依赖
method模块主体函数

模块主体函数只有被 use 模块使用时才会被执行。

define('A', function() {
    return 'A';
});
define('B', ['A'], function(A) {
    return 'B' + A;
});

defineProp

source test1.0.0

Object.defineProperty(defineProperties) 的快捷方式。

类型定义
function defineProp<T>(
    obj: T,
    prop: string,
    descriptor: PropertyDescriptor
): T;
function defineProp<T>(
    obj: T,
    descriptor: PropertyDescriptorMap
): T;
参数名说明
obj要定义的对象
prop属性路径
descriptor属性描述
返回值传入对象
参数名说明
obj要定义的对象
prop属性描述
返回值传入对象
const obj = { b: { c: 3 }, d: 4, e: 5 };
defineProp(obj, 'a', {
    get: function() {
        return this.e * 2;
    }
});
// obj.a is equal to 10
defineProp(obj, 'b.c', {
    set: function(val) {
        // this is pointed to obj.b
        this.e = val;
    }.bind(obj)
});
obj.b.c = 2;
// obj.a is equal to 4

const obj2 = { a: 1, b: 2, c: 3 };
defineProp(obj2, {
    a: {
        get: function() {
            return this.c;
        }
    },
    b: {
        set: function(val) {
            this.c = val / 2;
        }
    }
});
// obj2.a is equal to 3
obj2.b = 4;
// obj2.a is equal to 2

defined

source test1.16.0

返回第一个不是未定义的参数。

类型定义
function defined(...args: any[]): any;
参数名说明
...args参数列表
返回值第一个定义了的参数
defined(false, 2, void 0, 100); // -> false

delRequireCache

source test1.5.4

删除 node.js require 缓存。

类型定义
function delRequireCache(id: string): void;
参数名说明
id模块名或路径
const licia = require('licia');
licia.a = 5;
delRequireCache('licia');
require('licia').a; // -> undefined

delay

source test1.0.0

在指定时长后执行函数。

类型定义
function delay(
    fn: types.AnyFn,
    wait: number,
    ...args: any[]
): void;
参数名说明
fn源函数
wait延迟的毫秒数
...args绑定参数
delay(
    function(text) {
        console.log(text);
    },
    1000,
    'later'
);
// -> Logs 'later' after one second

delegate

source test1.0.0

事件委托。

类型定义
const delegate: {
    add(el: Element, type: string, selector: string, cb: types.AnyFn): void;
    remove(el: Element, type: string, selector: string, cb: types.AnyFn): void;
};

add

添加事件委托。

参数名说明
el父元素
type事件类型
selector匹配选择器
cb事件回调

remove

移除事件委托。

const container = document.getElementById('container');
function clickHandler() {
    // Do something...
}
delegate.add(container, 'click', '.children', clickHandler);
delegate.remove(container, 'click', '.children', clickHandler);

deprecate

source test demo1.5.0

Node.js util.deprecate 方法,支持浏览器。

类型定义
function deprecate(fn: types.AnyFn, msg: string): types.AnyFn;
参数名说明
fn即将废弃的方法
msg调用警告
返回值废弃方法,调用时会打印警告
const fn = () => {};
const obsoleteFn = deprecate(fn, 'obsoleteFn is deprecated.');
obsoleteFn();

detectBrowser

source test1.0.0

使用 ua 检测浏览器信息。

类型定义
function detectBrowser(
    ua?: string
): {
    name: string;
    version: number;
};
参数名说明
ua=navigator.userAgent浏览器用户代理
返回值包含名称和版本的对象

支持浏览器:ie,chrome,edge,firefox,opera,safari,ios(mobile safari),android(android browser)

const browser = detectBrowser();
if (browser.name === 'ie' && browser.version < 9) {
    // Do something about old IE...
}

detectMocha

source test1.0.0

检测是否有 mocha 测试框架在运行。

类型定义
function detectMocha(): boolean;
detectMocha(); // -> True if mocha is running.

detectOs

source test1.0.0

使用 ua 检测操作系统。

类型定义
function detectOs(ua?: string): string;
参数名说明
ua=navigator.userAgent浏览器用户代理
返回值操作系统名称

支持操作系统: windows, os x, linux, ios, android, windows phone

if (detectOs() === 'ios') {
    // Do something about ios...
}

difference

source test1.0.0

创建一个数组,该数组的元素不存在于给定的其它数组中。

类型定义
function difference(arr: any[], ...args: any[]): any[];
参数名说明
arr源数组
...args要排除的元素
返回值目标数组
difference([3, 2, 1], [4, 2]); // -> [3, 1]

dotCase

source test1.0.0

将字符串转换为点式。

类型定义
function dotCase(str: string): string;
参数名说明
str源字符串
返回值点式字符串
dotCase('fooBar'); // -> foo.bar
dotCase('foo bar'); // -> foo.bar

download

source test demo1.0.0

在浏览器端触发文件下载。

类型定义
function download(
    data: Blob | File | string | any[],
    name: string,
    type?: string
): void;
参数名说明
data下载的数据
name文件名
type=text/plain数据类型
download('test', 'test.txt');

durationFormat

source test1.18.0

简单时间格式化。

类型定义
function durationFormat(duration: number, mask?: string): string;
参数名说明
duration要格式化的时间,单位为毫秒
mask='hh:mm:ss'时间掩码
返回值格式化时间
掩码说明
d天数
h小时数
m分钟数
s秒数
l毫秒数
durationFormat(12345678); // -> '03:25:45'
durationFormat(12345678, 'h:m:s:l'); // -> '3:25:45:678'

each

source test benchmark1.0.0

遍历集合中的所有元素,用每个元素当做参数调用迭代器。

类型定义
function each<T>(
    list: types.List<T>,
    iterator: types.ListIterator<T, void>,
    ctx?: any
): types.List<T>;
function each<T>(
    object: types.Dictionary<T>,
    iterator: types.ObjectIterator<T, void>,
    ctx?: any
): types.Collection<T>;
参数名说明
obj目标集合
iterator迭代器
ctx函数上下文
each({ a: 1, b: 2 }, function(val, key) {});

easing

source test1.0.0

缓动函数,参考 http://jqueryui.com/

类型定义
const easing: {
    linear(percent: number): number;
    inQuad(percent: number): number;
    outQuad(percent: number): number;
    inOutQuad(percent: number): number;
    outInQuad(percent: number): number;
    inCubic(percent: number): number;
    outCubic(percent: number): number;
    inQuart(percent: number): number;
    outQuart(percent: number): number;
    inQuint(percent: number): number;
    outQuint(percent: number): number;
    inExpo(percent: number): number;
    outExpo(percent: number): number;
    inSine(percent: number): number;
    outSine(percent: number): number;
    inCirc(percent: number): number;
    outCirc(percent: number): number;
    inElastic(percent: number, elasticity?: number): number;
    outElastic(percent: number, elasticity?: number): number;
    inBack(percent: number): number;
    outBack(percent: number): number;
    inOutBack(percent: number): number;
    outInBack(percent: number): number;
    inBounce(percent: number): number;
    outBounce(percent: number): number;
};
参数名说明
percent位于 0 到 1 之前的数字
返回值计算结果
easing.linear(0.5); // -> 0.5
easing.inElastic(0.5, 500); // -> 0.03125

emulateTouch

source test demo1.9.0

在桌面端浏览器模拟 touch 事件。

类型定义
function emulateTouch(el: Element): void;
参数名说明
el目标元素
const el = document.querySelector('#test');
emulateTouch(el);
el.addEventListener('touchstart', () => {}, false);

endWith

source test1.0.0

检查字符串是否以指定字符串结尾。

类型定义
function endWith(str: string, suffix: string): boolean;
参数名说明
str目标字符串
suffix字符串后缀
返回值如果是后缀,返回真
endWith('ab', 'b'); // -> true

escape

source test1.0.0

转义 HTML 字符串,替换 &,<,>,",`,和 ' 字符。

类型定义
function escape(str: string): string;
参数名说明
str源字符串
返回值目标字符串
escape('You & Me'); // -> 'You &amp; Me'

escapeJsStr

source test1.0.0

转义字符串为合法的 JavaScript 字符串字面量。

类型定义
function escapeJsStr(str: string): string;

http://www.ecma-international.org/ecma-262/5.1/#sec-7.8.4

参数名说明
str源字符串
返回值目标字符串
escapeJsStr('"\n'); // -> '\\"\\\\n'

escapeRegExp

source test1.0.0

转义特殊字符用于 RegExp 构造函数。

类型定义
function escapeRegExp(str: string): string;
参数名说明
str源字符串
返回值目标字符串
escapeRegExp('[licia]'); // -> '\\[licia\\]'

evalCss

source test1.0.0

加载 css 到页面中。

类型定义
function evalCss(css: string): HTMLStyleElement;
参数名说明
csscss 代码
返回值style 节点
evalCss('body{background:#08c}');

evalJs

source test benchmark1.0.0

在指定的上下文执行 js 代码。

类型定义
function evalJs(js: string, ctx?: any): void;
参数名说明
jsJavaScript 代码
ctx=global上下文
evalJs('5+2'); // -> 7
evalJs('this.a', { a: 2 }); // -> 2

every

source test1.0.0

检查是否集合中的所有元素都能通过真值检测。

类型定义
function every<T>(
    object: types.List<T>,
    iterator?: types.ListIterator<T, boolean>,
    context?: any
): boolean;
function every<T>(
    object: types.Dictionary<T>,
    iterator?: types.ObjectIterator<T, boolean>,
    context?: any
): boolean;
参数名说明
object目标集合
iterator真值检测函数
context函数上下文
返回值如果都能通过,返回真
every([2, 4], function(val) {
    return val % 2 === 0;
}); // -> true

extend

source test1.0.0

复制多个对象中的所有属性到目标对象上。

类型定义
function extend(destination: any, ...sources: any[]): any;
参数名说明
destination目标对象
...sources源对象
返回值目标对象
extend({ name: 'RedHood' }, { age: 24 }); // -> {name: 'RedHood', age: 24}

extendDeep

source test1.0.0

类似 extend,但会递归进行扩展。

类型定义
function extendDeep(destination: any, ...sources: any[]): any;
参数名说明
destination目标对象
...sources源对象
返回值目标对象
extendDeep(
    {
        name: 'RedHood',
        family: {
            mother: 'Jane',
            father: 'Jack'
        }
    },
    {
        family: {
            brother: 'Bruce'
        }
    }
);
// -> {name: 'RedHood', family: {mother: 'Jane', father: 'Jack', brother: 'Bruce'}}

extendOwn

source test1.0.0

类似 extend,但只复制自己的属性,不包括原型链上的属性。

类型定义
function extendOwn(destination: any, ...sources: any[]): any;
参数名说明
obj目标对象
...sources源对象
返回值目标对象
extendOwn({ name: 'RedHood' }, { age: 24 }); // -> {name: 'RedHood', age: 24}

extractBlockCmts

source test1.0.0

从源码中提取块注释。

类型定义
function extractBlockCmts(str: string): string[];
参数名说明
str源码
返回值块注释
extractBlockCmts('\/*licia*\/'); // -> ['licia']

extractUrls

source test1.0.0

从文本中提取 url。

类型定义
function extractUrls(str: string): string[];
参数名说明
str文本
返回值url 列表
const str =
    '[Official site: http://eustia.liriliri.io](http://eustia.liriliri.io)';
extractUrls(str); // -> ['http://eustia.liriliri.io']

fetch

source test1.0.0

将 XMLHttpRequest 转换为 promise 的形式。

类型定义
namespace fetch {
    interface IResult {
        ok: boolean;
        status: number;
        statusText: string;
        url: string;
        clone(): IResult;
        text(): Promise<string>;
        json(): Promise<any>;
        xml(): Promise<Document | null>;
        blob(): Promise<Blob>;
        headers: {
            keys(): string[];
            entries(): Array<string[]>;
            get(name: string): string;
            has(name: string): boolean;
        };
    }
}
function fetch(
    url: string,
    options?: {
        method?: string;
        timeout?: number;
        headers?: types.PlainObj<string>;
        body?: any;
    }
): Promise<fetch.IResult>;

注意:这并不是 fetch 的 pollyfill。

参数名说明
url请求地址
options请求选项
返回值请求 promise
fetch('test.json', {
    method: 'GET',
    timeout: 3000,
    headers: {},
    body: ''
})
    .then(function(res) {
        return res.json();
    })
    .then(function(data) {
        console.log(data);
    });

fibonacci

source test1.0.0

计算斐波那契数列中某位数字。

类型定义
function fibonacci(n: number): number;
参数名说明
n序号 n
返回值斐波那契数列 n 位的数字
fibonacci(1); // -> 1
fibonacci(3); // -> 2

fileSize

source test1.0.0

将字节数转换为易于阅读的形式。

类型定义
function fileSize(bytes: number): string;
参数名说明
bytes文件字节大小
返回值易于阅读的文件大小
fileSize(5); // -> '5'
fileSize(1500); // -> '1.46K'
fileSize(1500000); // -> '1.43M'
fileSize(1500000000); // -> '1.4G'
fileSize(1500000000000); // -> '1.36T'

fileType

source test1.5.1

使用幻数检测文件类型。

类型定义
function fileType(
    input: Buffer | ArrayBuffer | Uint8Array
):
    | {
          ext: string;
          mime: string;
      }
    | undefined;
参数名说明
input文件输入
返回值包括扩展名和 mime 类型的对象

支持的文件类型

jpg, png, gif, webp, bmp, gz, zip, rar, pdf, exe

const fs = require('fs');
const file = fs.readFileSync('path/to/file');
console.log(fileType(file)); // -> { ext: 'jpg', mime: 'image/jpeg' }

fileUrl

source test1.36.0

将文件路径转换为文件协议 URL。

类型定义
function fileUrl(path: string): string;
参数名说明
path文件路径
返回值文件协议 URL
fileUrl('c:\\foo\\bar'); // -> 'file:///c:/foo/bar'

fill

source test1.0.0

在数组指定位置填充指定值。

类型定义
function fill(
    list: any[],
    val: any,
    start?: number,
    end?: number
): any[];
参数名说明
list源数组
val填充数组的值
start=0起始位置
end=arr.length结束位置,不包括
返回值目标数组
fill([1, 2, 3], '*'); // -> ['*', '*', '*']
fill([1, 2, 3], '*', 1, 2); // -> [1, '*', 3]

filter

source test1.0.0

遍历集合中的每个元素,返回所有通过真值检测的元素组成的数组。

类型定义
function filter<T>(
    list: types.List<T>,
    iterator: types.ListIterator<T, boolean>,
    context?: any
): T[];
function filter<T>(
    object: types.Dictionary<T>,
    iterator: types.ObjectIterator<T, boolean>,
    context?: any
): T[];
参数名说明
obj要遍历的集合
predicate真值检测函数
ctx函数上下文
返回值包含所有通过真值检测元素的数组
filter([1, 2, 3, 4, 5], function(val) {
    return val % 2 === 0;
}); // -> [2, 4]

find

source test1.0.0

找到集合中第一个通过真值检测的元素。

类型定义
function find<T>(
    object: types.List<T>,
    iterator: types.ListIterator<T, boolean>,
    context?: any
): T | undefined;
function find<T>(
    object: types.Dictionary<T>,
    iterator: types.ObjectIterator<T, boolean>,
    context?: any
): T | undefined;
参数名说明
object目标集合
iterator真值检测函数
context函数上下文
返回值第一个通过的元素
find(
    [
        {
            name: 'john',
            age: 24
        },
        {
            name: 'jane',
            age: 23
        }
    ],
    function(val) {
        return val.age === 23;
    }
); // -> {name: 'jane', age: 23}

findIdx

source test1.0.0

返回第一个通过真值检测元素在数组中的位置。

类型定义
function findIdx(arr: any[], predicate: types.AnyFn): number;
参数名说明
arr目标集合
predicate真值检测函数
返回值第一个符合条件元素的位置
findIdx(
    [
        {
            name: 'john',
            age: 24
        },
        {
            name: 'jane',
            age: 23
        }
    ],
    function(val) {
        return val.age === 23;
    }
); // -> 1

findKey

source test1.0.0

返回对象中第一个通过真值检测的属性键名。

类型定义
function findKey(
    obj: any,
    predicate: types.AnyFn,
    ctx?: any
): string | void;
参数名说明
obj目标对象
predicate真值检测函数
ctx函数上下文
返回值符合条件的键名
findKey({ a: 1, b: 2 }, function(val) {
    return val === 1;
}); // -> a

findLastIdx

source test1.0.0

同 findIdx,只是查找顺序改为从后往前。

类型定义
function findLastIdx(arr: any[], predicate: types.AnyFn): number;
参数名说明
arr目标集合
predicate真值检测函数
返回值从后往前,第一个符合条件元素的位置
findLastIdx(
    [
        {
            name: 'john',
            age: 24
        },
        {
            name: 'jane',
            age: 23
        },
        {
            name: 'kitty',
            age: 24
        }
    ],
    function(val) {
        return val.age === 24;
    }
); // -> 2

flatten

source test1.0.0

递归拍平数组。

类型定义
function flatten(arr: any[]): any[];
参数名说明
arr源数组
返回值目标数组
flatten(['a', ['b', ['c']], 'd', ['e']]); // -> ['a', 'b', 'c', 'd', 'e']

fnArgs

source test1.5.3

检验函数参数。

类型定义
function fnArgs(types: string[], args: any): void;
参数名说明
types参数类型
argsArgument 对象

如果检验失败,抛出异常。

function test(a, b, c) {
    fnArgs(['number|string', '?Function', '...number'], arguments);
    // Do something.
}
test(15);
test('test', () => {});
test('test', () => {}, 5);
test(); // Throw error
test('test', 'test'); // Throw error
test('test', () => {}, 5, 'test'); // Throw error

fnParams

source test1.0.0

获取函数的参数名列表。

类型定义
function fnParams(fn: types.AnyFn | string): string[];
参数名说明
fn目标函数
返回值参数名
fnParams(function(a, b) {}); // -> ['a', 'b']

fnv1a

source test1.10.0

简单 FNV-1a 哈希算法实现。

类型定义
function fnv1a(str: string): number;
参数名说明
str目标字符串
返回值哈希结果
fnv1a('test'); // -> 2949673445

format

source test1.0.0

使用类似于 printf 的方式来格式化字符串。

类型定义
function format(str: string, ...values: any[]): string;
参数名说明
str源字符串
...values替换占位符的值
返回值目标字符串

格式占位符

占位符说明
%s字符串
%d, %i整数
%f浮点数
%o对象
format('%s_%s', 'foo', 'bar'); // -> 'foo_bar'

fraction

source test1.0.0

转换数字为分数形式。

类型定义
function fraction(num: number): string;
参数名说明
num数字
返回值对应的分数
fraction(1.2); // -> '6/5'

freeze

source test1.0.0

Object.freeze 的快捷方式。

类型定义
function freeze<T>(obj: T): T;

如果不支持 Object.freeze,使用 Object.defineProperties 进行模拟。

参数名说明
obj目标对象
返回值目标对象
const a = { b: 1 };
freeze(a);
a.b = 2;
console.log(a); // -> {b: 1}

freezeDeep

source test1.0.0

递归进行 Object.freeze。

类型定义
function freezeDeep<T>(obj: T): T;
参数名说明
obj目标对象
返回值目标对象
const a = { b: { c: 1 } };
freezeDeep(a);
a.b.c = 2;
console.log(a); // -> {b: {c: 1}}

fs

source test1.0.0

node.js fs 模块的 promise 版本。

类型定义
const fs: {
    readFile(path: string, encoding: string): Promise<string>;
    readFile(path: string): Promise<Buffer>;
    exists(path: string): Promise<boolean>;
    unlink(path: string): Promise<void>;
    writeFile(path: string, data: string, options?: string): Promise<void>;
    writeFile(path: string, data: Buffer): Promise<void>;
    readdir(path: string): Promise<string[]>;
    rmdir(path: string): Promise<void>;
    [key: string]: any;
};
fs.readFile('test.js')
    .then(function(data) {
        // Do something
    })
    .catch(function(err) {
        // Handle errors
    });

fullscreen

source test demo1.4.0

全屏接口封装。

类型定义
namespace fullscreen {
    interface IFullscreen extends Emitter {
        request(el?: Element): void;
        exit(): void;
        toggle(el?: Element): void;
        isActive(): boolean;
        getEl(): Element | null;
        isEnabled(): boolean;
    }
}
const fullscreen: fullscreen.IFullscreen;

request

进入全屏。

参数名说明
el全屏元素

exit

退出全屏。

toggle

切换全屏。

参数名说明
el全屏元素

isActive

是否全屏。

getEl

获取全屏元素。

isEnabled

是否可以进入全屏。

fullscreen.request();
fullscreen.isActive(); // -> false, not a synchronous api
fullscreen.on('error', () => {});
fullscreen.on('change', () => {});

fuzzySearch

source test1.5.0

模糊搜索。

类型定义
function fuzzySearch(
    needle: string,
    haystack: any[],
    options?: {
        caseSensitive?: boolean;
        key?: string | string[];
    }
): any[];
参数名说明
needle搜索字符串
haystacks搜索集合
options搜索选项

可用选项:

参数名说明
caseSensitive=false是否大小写敏感
key搜索项是对象时的字符串路径
fuzzySearch('lic', ['licia', 'll', 'lic']); // -> ['lic', 'licia']
fuzzySearch(
    'alpha-test',
    [
        {
            name: 'alpha-test-1'
        },
        {
            name: 'beta-test'
        }
    ],
    {
        key: 'name'
    }
); // -> [{ name: 'alpha-test-1' }]

gcd

source test1.0.0

使用欧几里德算法求最大公约数。

类型定义
function gcd(a: number, b: number): number;
参数名说明
a要计算的数字
b要计算的数字
返回值最大公约数
gcd(121, 44); // -> 11

getPort

source test1.1.0

获取有效的 TCP 端口。

类型定义
function getPort(
    port?: number | number[],
    host?: string
): Promise<number>;
参数名说明
port首选端口
host地址
返回值有效端口

如果首选端口无法使用,将会返回一个有效的随机端口。

getPort([3000, 3001], '127.0.0.1').then(port => {
    console.log(port);
});

getProto

source test1.5.5

获取对象的原型。

类型定义
function getProto(obj: any): any;
参数名说明
obj目标对象
返回值对象原型,如果不存在,返回 null
const a = {};
getProto(Object.create(a)); // -> a

getUrlParam

source test1.0.0

获取 url 参数值。

类型定义
function getUrlParam(
    name: string,
    url?: string
): string | undefined;
参数名说明
name参数名
url=location目标 url
返回值参数值
getUrlParam('test', 'http://example.com/?test=true'); // -> 'true'

golangify

source test1.5.4

像 Go 一样处理错误。

类型定义
function golangify<T, U = Error>(
    fn: (...args: any[]) => Promise<T>
): (...args: any[]) => Promise<[T | undefined, U | null]>;
function golangify<T, U = Error>(
    p: Promise<T>
): Promise<[T | undefined, U | null]>;
参数名说明
fn返回 Promise 的函数
返回值同上,但 Promise 的结果形式为 [result, error]
参数名说明
p要转换的 Promise
返回值目标 Promise,结果形式为 [result, error]
(async () => {
    let fnA = golangify(async () => {
        throw Error('err');
    });
    await fnA(); // -> [undefined, Error]
    let fnB = golangify(async num => num * 2);
    await fnB(2); // -> [4, null]

    await golangify(Promise.reject(Error('err'))); // -> [undefined, Error]
    await golangify(Promise.resolve(4)); // -> [4, null]
})();

h

source test1.5.1

创建 HTML 元素。

类型定义
function h(
    tag: string,
    attrs?: types.PlainObj<any>,
    ...child: Array<string | HTMLElement>
): HTMLElement;
参数名说明
tag标签名
attrs属性
...child子节点
返回值目标元素
const el = h(
    'div#test.title',
    {
        onclick: function() {},
        title: 'test'
    },
    'inner text'
);
document.body.appendChild(el);

has

source test1.0.0

检查属性是否是对象自身的属性(原型链上的不算)。

类型定义
function has(obj: {}, key: string): boolean;
参数名说明
obj目标对象
key键名
返回值如果是自身的属性,返回真
has({ one: 1 }, 'one'); // -> true

heapSort

source test1.11.0

堆排序实现。

类型定义
function heapSort(arr: any[], cmp?: types.AnyFn): any[];
参数名说明
arr要排序的数组
cmp比较器
返回值有序数组
heapSort([2, 1]); // -> [1, 2]

hex

source test1.15.0

hex 编解码。

类型定义
const hex: {
    encode(bytes: number[]): string;
    decode(str: string): number[];
};

encode

将字节数组编码为 hex 字符串。

参数名说明
bytes字节数组
返回值hex 编码的字符串

decode

将 hex 字符串解码为字节数组。

参数名说明
strhex 编码的字符串
返回值字节数组
hex.encode([168, 174, 155, 255]); // -> 'a8ae9bff'
hex.decode('a8ae9bff'); // -> [168, 174, 155, 255]

highlight

source test demo1.5.6

高亮代码。

类型定义
function highlight(
    str: string,
    lang?: string,
    style?: {
        comment?: string;
        string?: string;
        number?: string;
        keyword?: string;
        operator?: string;
    }
): string;
参数名说明
str代码字符串
lang=js语言,js,html 或者 css
style高亮样式
返回值高亮后的 html 代码字符串

可设置样式:

comment,string,number,keyword,operator

highlight('const a = 5;', 'js', {
    keyword: 'color:#569cd6;'
}); // -> '<span class="keyword" style="color:#569cd6;">const</span> a <span class="operator" style="color:#994500;">=</span> <span class="number" style="color:#0086b3;">5</span>;'

hookFn

source test1.34.0

监听,修改函数参数和结果。

类型定义
function hookFn<T>(
    fn: T,
    options: {
        before?: types.AnyFn;
        after?: types.AnyFn;
        error?: types.AnyFn;
    }
): T;
参数名说明
fn要监听修改的函数
options监听选项
返回值包装后的函数

可用选项:

参数名说明
before参数处理函数
after结果处理函数
error异常处理函数
let sum = function(a, b) {
    if (a > 100) {
        throw Error('a is bigger than 100');
    }
    return a + b;
};
let totalSum = 0;
sum = hookFn(sum, {
    before(a, b) {
        return [+a, +b];
    },
    after(result) {
        totalSum += result;
        return totalSum;
    },
    error() {
        return totalSum;
    }
});
sum('2', '5'); // -> 7

hotkey

source test demo1.0.0

监听键盘触发对应的事件。

类型定义
namespace hotkey {
    interface IOptions {
        element?: HTMLElement;
    }
}
const hotkey: {
    on(key: string, options: hotkey.IOptions, listener: types.AnyFn): void;
    on(key: string, listener: types.AnyFn): void;
    off(key: string, options: hotkey.IOptions, listener: types.AnyFn): void;
    off(key: string, listener: types.AnyFn): void;
};

on

注册键盘按键监听器。

参数名说明
key按键
options选项
listener监听器

选项:

参数名说明
element=document目标元素

off

注销监听器。

const container = document.getElementById('container');
hotkey.on(
    'k',
    {
        element: container
    },
    function() {
        console.log('k is pressed');
    }
);
function keyDown() {}
hotkey.on('shift+a, shift+b', keyDown);
hotkey.off('shift+a', keyDown);

hslToRgb

source test1.0.0

将 hsl 格式的颜色值转换为 rgb 格式。

类型定义
function hslToRgb(hsl: number[]): number[];
参数名说明
hslhsl 值
返回值rgb 值
hslToRgb([165, 59, 50, 0.8]); // -> [52, 203, 165, 0.8]

html

source test1.6.0

HTML 解析器。

类型定义
const html: {
    parse(html: string): any[];
    stringify(tree: any[]): string;
};

parse

将 HTML 字符串转换为 js 对象。

参数名说明
htmlHTML 字符串
返回值js 对象

stringify

将 js 对象序列化成 HTML 字符串。

参数名说明
tree要序列化的对象
返回值HTML 字符串
const tree = html.parse('<div id="name">licia</div>');
// -> [{tag: 'div', attrs: {id: 'name'}, content: ['licia']}]
html.stringify(tree);

identity

source test1.0.0

返回传入的第一个参数。

类型定义
function identity<T>(val: T): T;
参数名说明
val任何值
返回值第一个参数
identity('a'); // -> 'a'

idxOf

source test1.0.0

返回指定值第一次在数组中出现的位置。

类型定义
function idxOf(arr: any[], val: any, fromIdx?: number): number;
参数名说明
arr目标数组
val要查找的值
fromIdx=0查找起始位置
返回值第一次出现的位置,如果没有,返回 -1
idxOf([1, 2, 1, 2], 2, 2); // -> 3

indent

source test1.0.0

对文本的每一行进行缩进处理。

类型定义
function indent(
    str: string,
    char?: string,
    len?: number
): string;
参数名说明
str源字符串
char缩进字符
len缩进长度
返回值目标字符串
indent('foo\nbar', ' ', 4); // -> '    foo\n    bar'

inherits

source test1.0.0

使构造函数继承另一个构造函数原型链上的方法。

类型定义
function inherits(
    Class: types.AnyFn,
    SuperClass: types.AnyFn
): void;
参数名说明
Class子类
SuperClass父类
function People(name) {
    this._name = name;
}
People.prototype = {
    getName: function() {
        return this._name;
    }
};
function Student(name) {
    this._name = name;
}
inherits(Student, People);
const s = new Student('RedHood');
s.getName(); // -> 'RedHood'

ini

source test1.5.4

ini 文件解析器。

类型定义
const ini: {
    parse(ini: string): any;
    stringify(
        obj: any,
        options?: {
            section?: string;
            whitespace: boolean;
        }
    ): string;
};

parse

将 ini 文件转换为 js 对象。

参数名说明
iniini 文件
返回值js 对象

stringify

将 js 对象序列化成 ini 文件格式。

参数名说明
obj要序列化的对象
options序列化选项
返回值ini 文件

选项:

参数名说明
section顶部名称
whitespace=false是否在 = 周围添加空格
const config = ini.parse(`
; This is a comment
library = licia

[user.info]
name = surunzi
alias[] = redhoodsu
alias[] = red
`); // -> {library: 'licia', user: {info: {name: 'surunzi', alias: ['redhoodsu', 'red']}}}

ini.stringify(config);

insertionSort

source test1.0.0

插入排序实现。

类型定义
function insertionSort(arr: any[], cmp?: types.AnyFn): any[];
参数名说明
arr要排序的数组
cmp比较器
返回值有序数组
insertionSort([2, 1]); // -> [1, 2]

intersect

source test1.0.0

计算所有数组的交集。

类型定义
function intersect(...arr: Array<any[]>): any[];
参数名说明
...arr源数组
返回值交集
intersect([1, 2, 3, 4], [2, 1, 10], [2, 1]); // -> [1, 2]

intersectRange

source test1.0.0

计算两个区间的交集。

类型定义
namespace intersectRange {
    interface IRange {
        start: number;
        end: number;
    }
}
function intersectRange(
    a: intersectRange.IRange,
    b: intersectRange.IRange
): intersectRange.IRange | void;
参数名说明
a区间 a
b区间 b
返回值如果存在区间交集,返回它
intersectRange({ start: 0, end: 12 }, { start: 11, end: 13 });
// -> {start: 11, end: 12}
intersectRange({ start: 0, end: 5 }, { start: 6, end: 7 });
// -> undefined

invariant

source test1.17.0

Facebook 的 invariant 模块。

类型定义
function invariant(
    condition: boolean,
    format?: string,
    a?: string,
    b?: string,
    c?: string,
    d?: string,
    e?: string,
    f?: string
): void;

相关文档

invariant(true, 'This will not throw');
// No errors
invariant(false, 'This will throw an error with this message');
// Error: Invariant Violation: This will throw an error with this message

invert

source test1.0.0

生成一个新对象,该对象的键名和键值进行调换。

类型定义
function invert(obj: any): any;
参数名说明
obj源对象
返回值目标对象

如果对象存在重复的键值,后面的值会覆盖前面的值。

invert({ a: 'b', c: 'd', e: 'f' }); // -> {b: 'a', d: 'c', f: 'e'}

isAbsoluteUrl

source test1.0.0

检查 url 是否是绝对地址。

类型定义
function isAbsoluteUrl(url: string): boolean;
参数名说明
url目标 url
返回值如果是绝对地址,返回真
isAbsoluteUrl('http://www.surunzi.com'); // -> true
isAbsoluteUrl('//www.surunzi.com'); // -> false
isAbsoluteUrl('surunzi.com'); // -> false

isArgs

source test1.0.0

检查值是否是参数类型。

类型定义
function isArgs(val: any): val is IArguments;
参数名说明
val要检查的值
返回值如果是参数类型,返回真
isArgs(
    (function() {
        return arguments;
    })()
); // -> true

isArr

source test1.0.0

检查值是否是数组类型。

类型定义
function isArr(val: any): val is any[];
参数名说明
val要检查的值
返回值如果是数组类型,返回真
isArr([]); // -> true
isArr({}); // -> false

isArrBuffer

source test1.0.0

检查值是否是 ArrayBuffer 类型。

类型定义
function isArrBuffer(val: any): val is ArrayBuffer;
参数名说明
val要检查的值
返回值如果是 ArrayBuffer 类型,返回真
isArrBuffer(new ArrayBuffer(8)); // -> true

isArrLike

source test1.0.0

检查值是否是类数组对象。

类型定义
function isArrLike(val: any): boolean;
参数名说明
val要检查的值
返回值如果是类数组对象,返回真

对于函数,返回假。

isArrLike('test'); // -> true
isArrLike(document.body.children); // -> true;
isArrLike([1, 2, 3]); // -> true

isAsyncFn

source test1.17.0

检查值是否是 Async 函数。

类型定义
function isAsyncFn(val: any): boolean;
参数名说明
val要检查的值
返回值如果是 Async 函数,返回真
isAsyncFn(function*() {}); // -> false
isAsyncFn(function() {}); // -> false
isAsyncFn(async function() {}); // -> true

isBlob

source test1.0.0

检查值是否是 Blob 类型。

类型定义
function isBlob(val: any): boolean;
参数名说明
val要检查的值
返回值如果是 Blob 类型,返回真
isBlob(new Blob([])); // -> true;
isBlob([]); // -> false

isBool

source test1.0.0

检查值是否是布尔类型。

类型定义
function isBool(val: any): val is boolean;
参数名说明
val要检查的值
返回值如果是布尔类型,返回真
isBool(true); // -> true
isBool(false); // -> true
isBool(1); // -> false

isBrowser

source test1.0.0

检测是否运行于浏览器环境。

类型定义
const isBrowser: boolean;
console.log(isBrowser); // -> true if running in a browser

isBuffer

source test1.0.0

检查值是否是 Buffer 类型。

类型定义
function isBuffer(val: any): boolean;
参数名说明
val要检查的值
返回值如果是 Buffer 类型,返回真
isBuffer(new Buffer(4)); // -> true

isClose

source test1.0.0

检查两个数字是否近似相等。

类型定义
function isClose(
    a: number,
    b: number,
    relTol?: number,
    absTol?: number
): boolean;

abs(a-b) <= max(relTol * max(abs(a), abs(b)), absTol)

参数名说明
a要比较的数字
b要比较的数字
relTol=1e-9相对误差
absTol=0绝对误差
返回值如果近似相等,返回真
isClose(1, 1.0000000001); // -> true
isClose(1, 2); // -> false
isClose(1, 1.2, 0.3); // -> true
isClose(1, 1.2, 0.1, 0.3); // -> true

isCyclic

source test benchmark1.30.0

检查值是否存在循环引用。

类型定义
function isCyclic(val: any): boolean;
参数名说明
val要检查的值
返回值如果存在循环引用,返回真
isCyclic({}); // -> false
const obj = { a: 1 };
obj.b = obj;
isCyclic(obj); // -> true

isDarkMode

source test1.19.0

检测是否暗黑模式。

类型定义
function isDarkMode(): boolean;
console.log(isDarkMode()); // true if dark mode

isDataUrl

source test1.0.0

检查字符串是否是有效的 Data Url。

类型定义
function isDataUrl(str: string): boolean;
参数名说明
str要检查的字符串
返回值如果是有效的 Data Url,返回真
isDataUrl('http://eustia.liriliri.io'); // -> false
isDataUrl('data:text/plain;base64,SGVsbG8sIFdvcmxkIQ%3D%3D'); // -> true

isDate

source test1.0.0

检查值是否是 Date 类型。

类型定义
function isDate(val: any): boolean;
参数名说明
val要检查的值
返回值如果是 Date 类型,返回真
isDate(new Date()); // -> true

isDir

source test1.28.0

检查路径是否是文件夹。

类型定义
function isDir(path: string): Promise<boolean>;
参数名说明
path要检查的路径
返回值如果是文件夹,返回真
isDir('/foo/bar');

isDocker

source test1.35.0

检测进程是否运行在 docker 容器内。

类型定义
function isDocker(): boolean;
console.log(isDocker()); // -> true if running inside a docker container.

isEl

source test1.0.0

检查值是否是 DOM 元素。

类型定义
function isEl(val: any): val is Element;
参数名说明
val要检查的值
返回值如果是 DOM 元素,返回真
isEl(document.body); // -> true

isEmail

source test1.0.0

简单检查值是否是合法的邮件地址。

类型定义
function isEmail(val: string): boolean;
参数名说明
val要检查的值
返回值如果是合法的邮件地址,返回真
isEmail('[email protected]'); // -> true

isEmpty

source test1.0.0

检查值是否是空对象或空数组。

类型定义
function isEmpty(val: any): boolean;
参数名说明
val要检查的值
返回值如果为空,返回真
isEmpty([]); // -> true
isEmpty({}); // -> true
isEmpty(''); // -> true

isEqual

source test1.0.0

对两个对象进行深度比较,如果相等,返回真。

类型定义
function isEqual(val: any, other: any): boolean;
参数名说明
val要比较的对象
other要比较的对象
返回值如果相等,返回真
isEqual([1, 2, 3], [1, 2, 3]); // -> true

isErr

source test1.0.0

检查值是否是 Error 类型。

类型定义
function isErr(val: any): val is Error;
参数名说明
val要检查的值
返回值如果是 Error 类型,返回真
isErr(new Error()); // -> true

isEven

source test1.0.0

检查数字是否是偶数。

类型定义
function isEven(num: number): boolean;
参数名说明
num要检查的数字
返回值如果是偶数,返回真
isEven(0); // -> true
isEven(1); // -> false
isEven(2); // -> true

isFile

source test1.0.0

检查值是否是 File 类型。

类型定义
function isFile(val: any): boolean;
参数名说明
val要检查的值
返回值如果是 File 类型,返回真
isFile(new File(['test'], 'test.txt', { type: 'text/plain' })); // -> true

isFinite

source test1.0.0

检查值是否是有限数字。

类型定义
function isFinite(val: any): boolean;
参数名说明
val要检查的值
返回值如果是有限数字,返回真
isFinite(3); // -> true
isFinite(Infinity); // -> false

isFn

source test1.0.0

检查值是否是函数。

类型定义
function isFn(val: any): val is Function;
参数名说明
val要检查的值
返回值如果是函数,返回真

Generator 函数返回真。

isFn(function() {}); // -> true
isFn(function*() {}); // -> true
isFn(async function() {}); // -> true

isFullWidth

source test1.24.0

检查值是否是全角字符。

类型定义
function isFullWidth(codePoint: number): boolean;
参数名说明
codePointUnicode 码点
返回值如果字符是全角,返回真
isFullWidth('a'.codePointAt(0)); // -> false
isFullWidth(','.codePointAt(0)); // -> false
isFullWidth('我'.codePointAt(0)); // -> true
isFullWidth(','.codePointAt(0)); // -> true

isGeneratorFn

source test1.0.0

检查值是否是 Generator 函数。

类型定义
function isGeneratorFn(val: any): boolean;
参数名说明
val要检查的值
返回值如果是 Generator 函数,返回真
isGeneratorFn(function*() {}); // -> true
isGeneratorFn(function() {}); // -> false

isHidden

source test1.18.0

检查元素是否隐藏。

类型定义
function isHidden(
    el: Element,
    options?: {
        display?: boolean;
        visibility?: boolean;
        opacity?: boolean;
        size?: boolean;
        viewport?: boolean;
        overflow?: boolean;
    }
): boolean;
参数名说明
el目标元素
options检查选项
返回值如果元素隐藏,返回真

可用选项:

参数名说明
display=true检查是否显示
visibility=false检查 visibility css 属性
opacity=false检查 opacity css 属性
size=false检查宽高
viewport=false检查是否在可视区域
overflow=false检查是否因 overflow 隐藏
isHidden(document.createElement('div')); // -> true

isInt

source test1.0.0

检查值是否是整数。

类型定义
function isInt(val: any): boolean;
参数名说明
val要检查的值
返回值如果是整数,返回真
isInt(5); // -> true
isInt(5.1); // -> false
isInt({}); // -> false

isIp

source test1.5.1

检查值是否是 IP 地址。

类型定义
namespace isIp {
    function v4(str: string): boolean;
    function v6(str: string): boolean;
}
function isIp(str: string): boolean;
参数名说明
str要检查的字符串
返回值如果是 IP 地址,返回真

v4

检查值是否是 IPv4 地址。

v6

检查值是否是 IPv6 地址。

isIp('192.168.191.1'); // -> true
isIp('1:2:3:4:5:6:7:8'); // -> true
isIp('test'); // -> false
isIp.v4('192.168.191.1'); // -> true
isIp.v6('1:2:3:4:5:6:7:8'); // -> true

isJson

source test1.0.0

检查值是否是有效的 JSON。

类型定义
function isJson(val: string): boolean;

该模块使用 JSON.parse()try... catch 进行检测。

参数名说明
valJSON 字符串
返回值如果是有效的 JSON,返回真
isJson('{"a": 5}'); // -> true
isJson("{'a': 5}"); // -> false

isLeapYear

source test1.0.0

检查年份是否是闰年。

类型定义
function isLeapYear(year: number): boolean;
参数名说明
year要检查的年份
返回值如果是闰年,返回真
isLeapYear(2000); // -> true
isLeapYear(2002); // -> false

isMap

source test1.0.0

检查值是否是 Map 对象。

类型定义
function isMap(val: any): boolean;
参数名说明
val要检查的值
返回值如果是 Map 类型,返回真
isMap(new Map()); // -> true
isMap(new WeakMap()); // -> false

isMatch

source test1.0.0

检查对象所有键名和键值是否在指定的对象中。

类型定义
function isMatch(obj: any, src: any): boolean;
参数名说明
obj目标对象
src进行匹配的对象
返回值如果匹配,返回真
isMatch({ a: 1, b: 2 }, { a: 1 }); // -> true

isMiniProgram

source test1.0.0

检测是否运行于微信小程序环境中。

类型定义
const isMiniProgram: boolean;
console.log(isMiniProgram); // -> true if running in mini program.

isMobile

source test1.0.0

使用 ua 检测是否运行于移动端浏览器。

类型定义
function isMobile(ua?: string): boolean;
参数名说明
ua=navigator.userAgent浏览器用户代理
返回值如果是移动端浏览器,返回真
isMobile(navigator.userAgent);

isNaN

source test1.0.0

检测值是否是 NaN。

类型定义
function isNaN(val: any): boolean;
参数名说明
val要检查的值
返回值如果是 NaN,返回真

跟全局 isNaN 不同的是,Undefined 不是 NaN。

isNaN(0); // -> false
isNaN(NaN); // -> true

isNative

source test1.0.0

检查值是否是原生函数。

类型定义
function isNative(val: any): boolean;
参数名说明
val要检查的值
返回值如果是原生函数,返回真
isNative(function() {}); // -> false
isNative(Math.min); // -> true

isNil

source test1.0.0

检查值是否是 null 或 undefined,等价于 value == null。

类型定义
function isNil(val: any): boolean;
参数名说明
val要检查的值
返回值如果是 null 或 undefined,返回真
isNil(null); // -> true
isNil(void 0); // -> true
isNil(undefined); // -> true
isNil(false); // -> false
isNil(0); // -> false
isNil([]); // -> false

isNode

source test1.0.0

检测是否运行于 node 环境中。

类型定义
const isNode: boolean;
console.log(isNode); // -> true if running in node

isNull

source test1.0.0

检查值是否是 Null 类型。

类型定义
function isNull(val: any): val is null;
参数名说明
val要检查的值
返回值如果是 Null 类型,返回真
isNull(null); // -> true

isNum

source test1.0.0

检测值是否是数字类型。

类型定义
function isNum(val: any): val is number;
参数名说明
val要检查的值
返回值如果是数字,返回真
isNum(5); // -> true
isNum(5.1); // -> true
isNum({}); // -> false

isNumeric

source test1.0.0

检查值是否是数字,包括数字字符串。

类型定义
function isNumeric(val: any): boolean;
参数名说明
val要检查的值
返回值如果是数字,返回真
isNumeric(1); // -> true
isNumeric('1'); // -> true
isNumeric(Number.MAX_VALUE); // -> true
isNumeric(0xff); // -> true
isNumeric(''); // -> false
isNumeric('1.1.1'); // -> false
isNumeric(NaN); // -> false

isObj

source test1.0.0

检查值是否是对象。

类型定义
function isObj(val: any): boolean;
参数名说明
val要检查的值
返回值如果是对象,返回真

标准定义

isObj({}); // -> true
isObj([]); // -> true

isOdd

source test1.0.0

检查数字是否是奇数。

类型定义
function isOdd(num: number): boolean;
参数名说明
num要检查的数字
返回值如果是奇数,返回真
isOdd(0); // -> false
isOdd(1); // -> true
isOdd(2); // -> false

isPlainObj

source test1.0.0

检查值是否是用 Object 构造函数创建的对象。

类型定义
function isPlainObj(val: any): boolean;
参数名说明
val要检查的值
返回值如果是 plain object,返回真
isPlainObj({}); // -> true
isPlainObj([]); // -> false
isPlainObj(function() {}); // -> false

isPortFree

source test1.5.2

检查 TCP 端口是否可用。

类型定义
function isPortFree(
    port: number,
    host?: string
): Promise<boolean>;
参数名说明
portTCP 端口
host地址
返回值如果端口可用,返回真
isPortFree(3000).then(isFree => {
    // Do something.
});

isPrime

source test1.2.0

检查整数是否是质数。

类型定义
function isPrime(num: number): boolean;
参数名说明
num要检查的数字
返回值如果是质数,返回真
isPrime(11); // -> true
isPrime(8); // -> false

isPrimitive

source test1.0.0

检测值是否是字符串,数字,布尔值或 null。

类型定义
function isPrimitive(val: any): boolean;
参数名说明
val要检查的值
返回值如果是原始类型,返回真
isPrimitive(5); // -> true
isPrimitive('abc'); // -> true
isPrimitive(false); // -> true

isPromise

source test1.0.0

检查值是否是类 promise 对象。

类型定义
function isPromise(val: any): boolean;
参数名说明
val要检查的值
返回值如果是类 promise 对象,返回真
isPromise(new Promise(function() {})); // -> true
isPromise({}); // -> false

isRegExp

source test1.0.0

检查值是否是正则类型。

类型定义
function isRegExp(val: any): val is RegExp;
参数名说明
val要检查的值
返回值如果是正则类型,返回真
isRegExp(/a/); // -> true

isRelative

source test1.0.0

检查路径是否是相对路径。

类型定义
function isRelative(path: string): boolean;
参数名说明
path要检查的路径
返回值如果是相对路径,返回真
isRelative('README.md'); // -> true

isRetina

source test1.0.0

判断是否运行在 retina 屏幕的设备上。

类型定义
const isRetina: boolean;
console.log(isRetina); // -> true if high DPR

isRunning

source test1.22.0

检查进程是否运行中。

类型定义
function isRunning(pid: number): boolean;
参数名说明
pid进程 id
返回值如果进程运行中,返回真
isRunning(123456); // true if running

isSet

source test1.0.0

检查值是否是 Set 类型。

类型定义
function isSet(val: any): boolean;
参数名说明
val要检查的值
返回值如果是 Set 类型,返回真
isSet(new Set()); // -> true
isSet(new WeakSet()); // -> false

isSorted

source test1.0.0

检查数组是否有序。

类型定义
function isSorted(arr: any[], cmp?: types.AnyFn): boolean;
参数名说明
arr目标数组
cmp比较器
返回值如果数组有序,返回真
isSorted([1, 2, 3]); // -> true
isSorted([3, 2, 1]); // -> false

isStr

source test1.0.0

检查值是否是字符串。

类型定义
function isStr(val: any): val is string;
参数名说明
val要检查的值
返回值如果是字符串,返回真
isStr('licia'); // -> true

isStrBlank

source test benchmark1.39.0

检查字符串是否为空。

类型定义
function isStrBlank(str: string): boolean;
参数名说明
str要检查的字符串
返回值如果字符串为空,返回真
isStrBlank('licia'); // -> false
isStrBlank(''); // -> true
isStrBlank('    '); // -> true
isStrBlank('\r\n '); // -> true

isStream

source test1.0.0

检查值是否是 Node.js Stream 类型。

类型定义
function isStream(val: any): boolean;
参数名说明
val要检查的值
返回值如果是 Node.js Stream 类型,返回真
const stream = require('stream');

isStream(new stream.Stream()); // -> true

isSymbol

source test1.5.5

检查值是否是 Symbol 类型。

类型定义
function isSymbol(val: any): val is symbol;
参数名说明
val要检查的值
返回值如果是 Symbol 类型,返回真
isSymbol(Symbol('test')); // -> true

isTypedArr

source test1.0.0

检查值是否 TypedArray 类型。

类型定义
function isTypedArr(val: any): boolean;
参数名说明
val要检查的值
返回值如果值是 TypedArray 类型,返回真
isTypedArr([]); // -> false
isTypedArr(new Uint8Array(8)); // -> true

isUndef

source test1.0.0

检查值是否是 undefined。

类型定义
function isUndef(val: any): val is undefined;
参数名说明
val要检查的值
返回值如果是 undefined,返回真
isUndef(void 0); // -> true
isUndef(null); // -> false

isUrl

source test1.0.0

简单检查值是否是有效的 url 地址。

类型定义
function isUrl(val: string): boolean;
参数名说明
val要检查的值
返回值如果是有效的 url 地址,返回真
isUrl('http://www.example.com?foo=bar&param=test'); // -> true

isWeakMap

source test1.0.0

检查值是否是 WeakMap 类型。

类型定义
function isWeakMap(val: any): boolean;
参数名说明
val要检查的值
返回值如果是 WeakMap 类型,返回真
isWeakMap(new Map()); // -> false
isWeakMap(new WeakMap()); // -> true

isWeakSet

source test1.0.0

检查值是否是 WeakSet 类型。

类型定义
function isWeakSet(val: any): boolean;
参数名说明
val要检查的值
返回值如果是 WeakSet 类型,返回真
isWeakSet(new Set()); // -> false
isWeakSet(new WeakSet()); // -> true

isWindows

source test1.0.0

检测是否运行在 windows 操作系统上。

类型定义
const isWindows: boolean;
console.log(isWindows); // -> true if running on windows

jsonClone

source test1.12.0

使用 JSON parse 和 stringify 方法对指定对象进行复制。

类型定义
function jsonClone<T>(val: T): T;
参数名说明
val要克隆的值
返回值克隆值
jsonClone({ name: 'licia' }); // -> { name: 'licia' }

jsonp

source test1.0.0

简单 jsonp 实现。

类型定义
function jsonp(options: {
    url: string;
    data?: any;
    success?: types.AnyFn;
    param?: string;
    name?: string;
    error?: types.AnyFn;
    complete?: types.AnyFn;
    timeout?: number;
}): void;
参数名说明
optionsjsonp 选项

可用选项:

参数名说明
url请求地址
data请求数据
success成功回调
param=callback回调参数名
name回调函数名
error失败回调
complete结束回调
timeout请求超时
jsonp({
    url: 'http://example.com',
    data: { test: 'true' },
    success: function(data) {
        // ...
    }
});

kebabCase

source test1.0.0

将字符串转换为短横线式。

类型定义
function kebabCase(str: string): string;
参数名说明
str源字符串
返回值短横线式字符串
kebabCase('fooBar'); // -> foo-bar
kebabCase('foo bar'); // -> foo-bar
kebabCase('foo_bar'); // -> foo-bar
kebabCase('foo.bar'); // -> foo-bar

keyCode

source test1.0.0

键码键名转换。

类型定义
function keyCode(name: string): number;
function keyCode(code: number): string;

获取键码对应的键名。

参数名说明
code键码
返回值对应的键名

获取键名对应的键码。

参数名说明
name键名
返回值对应的键码
keyCode(13); // -> 'enter'
keyCode('enter'); // -> 13

keys

source test1.0.0

返回包含对象自身可遍历所有键名的数组。

类型定义
function keys(obj: any): string[];
参数名说明
obj目标对象
返回值所有键名
keys({ a: 1 }); // -> ['a']

kill

source test1.4.4

杀死进程。

类型定义
function kill(pid: number): void;
参数名说明
pid进程 ID
kill(9420);

last

source test1.0.0

获取数组的最后一个元素。

类型定义
function last(arr: any[]): any;
参数名说明
arr目标数组
返回值数组的最后一个元素
last([1, 2]); // -> 2

lazyImport

source test1.31.0

模块懒加载,底层使用 Proxy。

类型定义
function lazyImport<T>(
    importFn: (moduleId: string) => T,
    dirname?: string
): (moduleId: string) => T;
参数名说明
importFn实际引入模块的方法
dirname当前脚本所在目录
返回值用于引入模块的新方法
const r = lazyImport(require);

const _ = r('underscore');

_.isNumber(5);

lazyRequire

source test1.0.0

模块懒加载。

类型定义
function lazyRequire<T>(
    requireFn: (moduleId: string) => T
): (moduleId: string) => T;
const r = lazyRequire(require);

const _ = r('underscore');

// underscore is required only when _ is called.
_().isNumber(5);

levenshtein

source test1.4.8

计算字符串编辑距离,使用 levenshtein 算法。

类型定义
function levenshtein(a: string, b: string): number;
参数名说明
a字符串 a
b字符串 b
返回值a 和 b 的字符串编辑距离
levenshtein('cat', 'cake'); // -> 2

linkify

source test1.0.0

将文本中的 url 地址转换为超链接。

类型定义
function linkify(str: string, hyperlink?: types.AnyFn): string;
参数名说明
str源字符串
hyperlink转换超链接函数
返回值目标字符串
const str = 'Official site: http://eustia.liriliri.io';
linkify(str); // -> 'Official site: <a href="http://eustia.liriliri.io">http://eustia.liriliri.io</a>'
linkify(str, function(url) {
    return '<a href="' + url + '" target="_blank">' + url + '</a>';
});

loadCss

source test1.0.0

往页面插入样式链接。

类型定义
function loadCss(src: string, cb?: types.AnyFn): void;
参数名说明
src样式文件地址
cb加载完回调
loadCss('style.css', function(isLoaded) {
    // Do something...
});

loadImg

source test1.0.0

加载指定地址的图片。

类型定义
function loadImg(src: string, cb?: types.AnyFn): void;
参数名说明
src图片地址
cb加载完回调
loadImg('http://eustia.liriliri.io/img.jpg', function(err, img) {
    console.log(img.width, img.height);
});

loadJs

source test1.0.0

往页面插入脚本链接。

类型定义
function loadJs(src: string, cb?: types.AnyFn): void;
参数名说明
src脚本地址
cb加载完回调
loadJs('main.js', function(isLoaded) {
    // Do something...
});

longest

source test1.0.0

获取数组中最长的一项。

类型定义
function longest(arr: string[]): string;
参数名说明
arr目标数组
返回值最长的一项
longest(['a', 'abcde', 'abc']); // -> 'abcde'

lowerCase

source test1.0.0

转换字符串为小写。

类型定义
function lowerCase(str: string): string;
参数名说明
str源字符串
返回值目标字符串
lowerCase('TEST'); // -> 'test'

lpad

source test1.0.0

对字符串进行左填充。

类型定义
function lpad(str: string, len: number, chars?: string): string;
参数名说明
str源字符串
len填充长度
chars填充字符串
返回值目标字符串
lpad('a', 5); // -> '    a'
lpad('a', 5, '-'); // -> '----a'
lpad('abc', 3, '-'); // -> 'abc'
lpad('abc', 5, 'ab'); // -> 'ababc'

ltrim

source test1.0.0

删除字符串头部指定字符或空格。

类型定义
function ltrim(str: string, chars?: string | string[]): string;
参数名说明
str源字符串
chars删除字符
返回值目标字符串
ltrim(' abc  '); // -> 'abc  '
ltrim('_abc_', '_'); // -> 'abc_'
ltrim('_abc_', ['a', '_']); // -> 'bc_'

map

source test1.0.0

对集合的每个元素调用转换函数生成与之对应的数组。

类型定义
function map<T, TResult>(
    list: types.List<T>,
    iterator: types.ListIterator<T, TResult>,
    context?: any
): TResult[];
function map<T, TResult>(
    object: types.Dictionary<T>,
    iterator: types.ObjectIterator<T, TResult>,
    context?: any
): TResult[];
参数名说明
object源集合
iterator转换函数
context函数上下文
返回值目标集合
map([4, 8], function(n) {
    return n * n;
}); // -> [16, 64]

mapObj

source test1.0.0

类似 map,但针对对象,生成一个新对象。

类型定义
function mapObj<T, TResult>(
    object: types.Dictionary<T>,
    iterator: types.ObjectIterator<T, TResult>,
    context?: any
): types.Dictionary<TResult>;
参数名说明
object源对象
iterator转换函数
context函数上下文
返回值目标对象
mapObj({ a: 1, b: 2 }, function(val, key) {
    return val + 1;
}); // -> {a: 2, b: 3}

matcher

source test1.0.0

传入对象返回函数,如果传入参数中包含该对象则返回真。

类型定义
function matcher(attrs: any): types.AnyFn;
参数名说明
attrs要匹配的对象
返回值真值检测函数
const filter = require('licia/filter');

const objects = [
    { a: 1, b: 2, c: 3 },
    { a: 4, b: 5, c: 6 }
];
filter(objects, matcher({ a: 4, c: 6 })); // -> [{a: 4, b: 5, c: 6}]

max

source test1.0.0

获取数字中的最大值。

类型定义
function max(...num: number[]): number;
参数名说明
...num要计算的数字
返回值最大值
max(2.3, 1, 4.5, 2); // 4.5

md5

source test benchmark1.1.0

MD5 算法实现。

类型定义
function md5(msg: string | number[]): string;
参数名说明
msg密文
返回值MD5 摘要
md5('licia'); // -> 'e59f337d85e9a467f1783fab282a41d0'

memStorage

source test1.0.0

Web Storage 接口的纯内存实现。

类型定义
const memStorage: typeof window.localStorage;

当 localStorage 或者 sessionStorage 无法使用时可以使用其作为替代。

const localStorage = window.localStorage || memStorage;
localStorage.setItem('test', 'licia');

memoize

source test1.0.0

缓存函数计算结果。

类型定义
function memoize(
    fn: types.AnyFn,
    hashFn?: types.AnyFn
): types.AnyFn;
参数名说明
fn源函数
hashFn计算缓存键名函数
返回值目标函数
const fibonacci = memoize(function(n) {
    return n < 2 ? n : fibonacci(n - 1) + fibonacci(n - 2);
});

mergeArr

source test1.24.0

将数组合并到第一个数组里。

类型定义
function mergeArr<T, U>(
    first: ArrayLike<T>,
    ...arrays: ArrayLike<U>[]
): ArrayLike<T | U>;
参数名说明
first要修改的数组
arrays合并到第一个数组的数组
返回值第一个数组
const a = [1, 2];
mergeArr(a, [3, 4], [5, 6]);
console.log(a); // -> [1, 2, 3, 4, 5, 6]

mergeSort

source test1.0.0

归并排序实现。

类型定义
function mergeSort(arr: any[], cmp?: types.AnyFn): any[];

注意:它不改变原数组。

参数名说明
arr要排序的数组
cmp比较器
返回值有序数组
mergeSort([2, 1]); // -> [1, 2]

meta

source test1.0.0

meta 操作库,将 name 和 content 属性值转换为键值对。

类型定义
namespace meta {
    function remove(nameList: string | string[]): void;
}
function meta(): {};
function meta(key: string): string;
function meta(keys: string[]): {};
function meta(key, value): void;
function meta(pairs: {}): void;

获取指定 meta 值。如果忽略 meta 名,所有的 meta 键值对都被返回。

参数名说明
namemeta 名
返回值meta 值

设置 meta 值。

参数名说明
namemeta 名
contentmeta 值
参数名说明
metas包含所有 meta 键值对的对象

remove

移除指定 meta。

参数名说明
namemeta 名
// <meta name="a" content="1"/> <meta name="b" content="2"/> <meta name="c" content="3"/>
meta(); // -> {a: '1', b: '2', c: '3'}
meta('a'); // -> '1'
meta(['a', 'c']); // -> {a: '1', c: '3'}
meta('d', '4');
meta({
    d: '5',
    e: '6',
    f: '7'
});
meta.remove('d');
meta.remove(['e', 'f']);

methods

source test1.0.0

获取对象中所有方法名。

类型定义
function methods(obj: any): string[];
参数名说明
obj目标对象
返回值方法名列表
methods(console); // -> ['Console', 'assert', 'dir', ...]

mime

source test1.5.0

常用 mime 类型。

类型定义
function mime(name: string): string | undefined;
参数名说明
name扩展名
返回值mime 类型
参数名说明
namemime 类型
返回值扩展名

该模块只包含常用的文件类型。

mime('jpg'); // -> 'image/jpeg'
mime('bmp'); // -> 'image/bmp'
mime('video/mp4'); // -> 'mp4'
mime('test'); // -> undefined

min

source test1.0.0

获取数字中的最小值。

类型定义
function min(...num: number[]): number;
参数名说明
...num要计算的数字
返回值最小值
min(2.3, 1, 4.5, 2); // 1

mkdir

source test1.0.0

递归地创建文件夹。

类型定义
namespace mkdir {
    function sync(dir: string, mode?: number): void;
}
function mkdir(
    dir: string,
    mode?: number,
    cb?: types.AnyFn
): void;
function mkdir(dir: string, cb?: types.AnyFn): void;
参数名说明
dir文件夹路径
mode=0777文件夹模式
cb回调

sync

同步版本。

mkdir('/tmp/foo/bar/baz', function(err) {
    if (err) console.log(err);
    else console.log('Done');
});
mkdir.sync('/tmp/foo2/bar/baz');

moment

source test1.0.0

简单的类 moment.js 实现。

类型定义
namespace moment {
    class M {
        constructor(value: string | Date);
        format(mask: string): string;
        isValid(): boolean;
        isLeapYear(): boolean;
        isSame(that: M): boolean;
        valueOf(): number;
        isBefore(that: M): boolean;
        isAfter(that: M): boolean;
        year(): number;
        year(number): M;
        month(): number;
        month(number): M;
        date(): number;
        date(number): M;
        hour(): number;
        hour(number): M;
        minute(): number;
        minute(number): M;
        second(): number;
        second(number): M;
        millisecond(): number;
        millisecond(number): M;
        unix(): number;
        clone(): M;
        toDate(): Date;
        toArray(): number[];
        toJSON(): string;
        toISOString(): string;
        toObject(): any;
        toString(): string;
        set(unit: string, num: number): M;
        startOf(unit: string): M;
        endOf(unit: string): M;
        daysInMonth(): number;
        add(num: number, unit: string): M;
        subtract(num: number, unit: string): M;
        diff(input: M | string | Date, unit: string, asFloat: boolean): number;
    }
}
function moment(value: string | Date): moment.M;

它只支持一小部分的 moment.js api。

可用方法

format,isValid,isLeapYear,isSame,isBefore,isAfter,year, month,date,hour,minute,second,millisecond,unix,clone, toDate,toArray,toJSON,toISOString,toObject,toString,set, startOf,endOf,add,subtract,diff

不支持特性

时区以及 quarter 和 week 单位。

注意:格式化功能使用 dateFormat 模块,所以掩码格式并不完全与 moment.js 一致。

moment('20180501').format('yyyy-mm-dd'); // -> '2018-05-01'

morphDom

source test1.25.0

将 DOM 树变化成目标 DOM 树。

类型定义
function morphDom(from: Node, to: Node | string): Node;
参数名说明
from原始 DOM 树
to要变化的 DOM 树
返回值变化后的 DOM 树
const el1 = document.createElement('div');
el1.className = 'test';
const el2 = document.createElement('div');
el2.className = 'licia';
morphDom(el1, el2);
console.log(el1.className); // -> 'licia'

morse

source test1.19.0

摩尔斯电码编解码。

类型定义
const morse: {
    encode(txt: string): string;
    decode(morse: string): string;
};

encode

将文本转换为摩尔斯电码。

参数名说明
txt要编码的文本
返回值摩尔斯电码

decode

将摩尔斯电码转换为文本。

参数名说明
morse摩尔斯电码
返回值解码后的文本
const str = morse.encode('Hello, world.');
// -> '.... . .-.. .-.. --- --..-- ....... .-- --- .-. .-.. -.. .-.-.-'
morse.decode(str); // -> 'Hello, world.'

ms

source test1.0.0

时长字符串与毫秒转换库。

类型定义
function ms(str: string): number;
function ms(num: number): string;

转换时长字符串为毫秒。

参数名说明
str字符串格式
返回值毫秒

转换毫秒为时长字符串。

参数名说明
num毫秒
返回值字符串格式
ms('1s'); // -> 1000
ms('1m'); // -> 60000
ms('1.5h'); // -> 5400000
ms('1d'); // -> 86400000
ms('1y'); // -> 31557600000
ms('1000'); // -> 1000
ms(1500); // -> '1.5s'
ms(60000); // -> '1m'

naturalSort

source test1.30.0

以自然顺序排序数组。

类型定义
function naturalSort<T extends any[]>(arr: T): T;
参数名说明
arr要排序的数组
返回值有序数组
naturalSort(['img12', 'img11', '$img', '_img', '1', '2', '12']);
// -> ['1', '2', '12', '$img', 'img11', 'img12', '_img']
naturalSort([2, '1', 13]); // -> ['1', 2, 13]

negate

source test1.0.0

创建一个将原函数结果取反的函数。

类型定义
function negate<T extends types.AnyFn>(predicate: T): T;
参数名说明
predicate源函数
返回值目标函数
function even(n) {
    return n % 2 === 0;
}
[1, 2, 3, 4, 5, 6].filter(negate(even)); // -> [1, 3, 5]

nextTick

source test1.0.0

能够同时运行在 node 和浏览器端的 next tick 实现。

类型定义
function nextTick(cb: types.AnyFn): void;
参数名说明
cb调用函数

如果支持 process.nextTick,则调用它,否则使用 setImmediate 或 setTimeout 进行兼容。

nextTick(function() {
    // Do something...
});

noop

source test1.0.0

一个什么也不做的空函数。

类型定义
function noop(): void;
noop(); // Does nothing

normalizeHeader

source test1.2.0

标准化 HTTP 头部名。

类型定义
function normalizeHeader(header: string): string;
参数名说明
header源头部名
返回值目标头部名
normalizeHeader('content-type'); // -> 'Content-Type'
normalizeHeader('etag'); // -> 'ETag'

normalizePath

source test1.0.0

标准化文件路径中的斜杠。

类型定义
function normalizePath(path: string): string;
参数名说明
path源路径
返回值目标路径
normalizePath('\\foo\\bar\\'); // -> '/foo/bar/'
normalizePath('./foo//bar'); // -> './foo/bar'

normalizePhone

source test1.13.0

标准化电话号码为 E.164 格式。

类型定义
function normalizePhone(
    phone: string,
    options: {
        countryCode: number;
        trunkPrefix?: boolean;
    }
): string;
参数名说明
phone电话号码
options标准化选项
返回值E.164 格式电话号码

可用选项:

参数名说明
countryCode国家代码
trunkPrefix=false如果本地格式有长途字冠,设为真
normalizePhone('13512345678', {
    countryCode: 86
}); // -> '+8613512345678'
normalizePhone('(415) 555-2671', {
    countryCode: 1
}); // -> '+14155552671'
normalizePhone('020 7183 8750', {
    countryCode: 44,
    trunkPrefix: true
}); // -> '+442071838750'

notify

source test demo1.14.0

Web Notifications 接口简单包装。

类型定义
namespace notify {
    class Notification extends Emitter {
        constructor(title: string, options?: object);
        show(): void;
    }
}
function notify(title: string, options?: object): void;
参数名说明
title通知标题
options通知选项

你可以传入所有在 Web Notification 中支持的选项。

Notification

如果你想要监听并处理像 close,show,click 或者 error 等事件,使用这个类创建实例。

notify('licia', {
    body: 'This is the notification content'
});
const notification = new notify.Notification('licia', {
    body: 'This is the notification content'
});
notification.on('error', err => console.log(err));
notification.on('click', e => console.log(e));
notification.show();

now

source test1.0.0

获取当前时间戳。

类型定义
function now(): number;
now(); // -> 1468826678701

objToStr

source test1.0.0

Object.prototype.toString 的别名。

类型定义
function objToStr(val: any): string;
参数名说明
val目标值
返回值字符串表示
objToStr(5); // -> '[object Number]'

omit

source test1.0.0

类似 pick,但结果相反。

类型定义
function omit(
    obj: any,
    filter: string | string[] | Function
): any;
参数名说明
obj源对象
filter对象过滤器
返回值目标对象
omit({ a: 1, b: 2 }, 'a'); // -> {b: 2}
omit({ a: 1, b: 2, c: 3 }, ['b', 'c']); // -> {a: 1}
omit({ a: 1, b: 2, c: 3, d: 4 }, function(val, key) {
    return val % 2;
}); // -> {b: 2, d: 4}

once

source test1.0.0

创建只能调用一次的函数。

类型定义
function once(fn: types.AnyFn): types.AnyFn;
参数名说明
fn源函数
返回值目标函数
function init() {}
const initOnce = once(init);
initOnce();
initOnce(); // -> init is invoked once

open

source test1.2.0

打开 url 地址或文件。

类型定义
function open(target: string): any;
参数名说明
target要打开的目标
返回值子进程对象
open('https://eustia.liriliri.io/');

openFile

source test demo1.3.0

在浏览器中打开文件选择框。

类型定义
function openFile(options?: {
    accept?: string;
    multiple?: boolean;
}): Promise<File[]>;
参数名说明
options选项
返回值文件列表

可用选项:

参数名说明
accept文件类型
multiple=false是否支持多选
openFile({ multiple: true }).then(fileList => {
    console.log(fileList);
});

optimizeCb

source test1.0.0

用于高效的函数上下文绑定。

类型定义
function optimizeCb(
    fn: types.AnyFn,
    ctx: any,
    argCount?: number
): types.AnyFn;

ordinal

source test1.5.2

转换数字为序数形式。

类型定义
function ordinal(num: number): string;
参数名说明
num要转换的数字
返回值目标序数
ordinal(1); // -> '1st'
ordinal(2); // -> '2nd'

orientation

source test demo1.0.0

屏幕方向工具库。

类型定义
namespace orientation {
    interface IOrientation extends Emitter {
        get(): string;
    }
}
const orientation: orientation.IOrientation;

on

绑定 change 事件。

off

解绑 change 事件。

get

获取当前屏幕方向(横屏 landscape 或 竖屏 portrait)。

orientation.on('change', function(direction) {
    console.log(direction); // -> 'portrait'
});
orientation.get(); // -> 'landscape'

pad

source test1.0.0

对字符串进行左右填充。

类型定义
function pad(str: string, len: number, chars?: string): string;
参数名说明
str源字符串
len填充长度
chars填充字符串
返回值目标字符串
pad('a', 5); // -> '  a  '
pad('a', 5, '-'); // -> '--a--'
pad('abc', 3, '-'); // -> 'abc'
pad('abc', 5, 'ab'); // -> 'babca'
pad('ab', 5, 'ab'); // -> 'ababa'

pairs

source test1.0.0

将对象转换为包含【键名,键值】对的数组。

类型定义
function pairs(obj: any): Array<any[]>;
参数名说明
obj目标对象
返回值键值对数组
pairs({ a: 1, b: 2 }); // -> [['a', 1], ['b', 2]]

parallel

source test1.0.0

同时执行多个函数。

类型定义
function parallel(tasks: types.AnyFn[], cb?: types.AnyFn): void;
参数名说明
tasks函数数组
cb结束回调
parallel(
    [
        function(cb) {
            setTimeout(function() {
                cb(null, 'one');
            }, 200);
        },
        function(cb) {
            setTimeout(function() {
                cb(null, 'two');
            }, 100);
        }
    ],
    function(err, results) {
        // results -> ['one', 'two']
    }
);

parseArgs

source test1.0.0

命令行参数简单解析。

类型定义
function parseArgs(
    args: string[],
    options: {
        names: any;
        shorthands: any;
    }
): any;
参数名说明
args参数数组
options解析选项
返回值解析结果

options

参数名说明
names选项名及类型
shorthands选项名缩写
parseArgs(['eustia', '--output', 'util.js', '-w'], {
    names: {
        output: 'string',
        watch: 'boolean'
    },
    shorthands: {
        output: 'o',
        watch: 'w'
    }
});
// -> {remain: ['eustia'], output: 'util.js', watch: true}

parseHtml

source test1.6.0

HTML 解析器。

类型定义
function parseHtml(
    html: string,
    handlers: {
        start?: (tag: string, attrs: any, unary: boolean) => void;
        end?: (tag: string) => void;
        comment?: (text: string) => void;
        text?: (text: string) => void;
    }
): void;
参数名说明
html要解析的 HTML
handler处理函数
parseHtml('<div>licia</div>', {
    start: (tag, attrs, unary) => {},
    end: tag => {},
    comment: text => {},
    text: text => {}
});

partial

source test1.0.0

返回局部填充参数的函数,与 bind 模块相似。

类型定义
function partial(
    fn: types.AnyFn,
    ...partials: any[]
): types.AnyFn;
参数名说明
fn源函数
...partials局部填充参数
返回值目标函数
const sub5 = partial(function(a, b) {
    return b - a;
}, 5);
sub5(20); // -> 15

pascalCase

source test1.0.0

将字符串转换为帕斯卡式。

类型定义
function pascalCase(str: string): string;
参数名说明
str源字符串
返回值帕斯卡式字符串
pascalCase('fooBar'); // -> FooBar
pascalCase('foo bar'); // -> FooBar
pascalCase('foo_bar'); // -> FooBar
pascalCase('foo.bar'); // -> FooBar

perfNow

source test1.0.0

高精度时间戳。

类型定义
function perfNow(): number;
const start = perfNow();

// Do something.

console.log(perfNow() - start);

pick

source test1.0.0

过滤对象。

类型定义
function pick(
    object: any,
    filter: string | string[] | Function
): any;
参数名说明
object源对象
filter对象过滤器
返回值目标对象
pick({ a: 1, b: 2 }, 'a'); // -> {a: 1}
pick({ a: 1, b: 2, c: 3 }, ['b', 'c']); // -> {b: 2, c: 3}
pick({ a: 1, b: 2, c: 3, d: 4 }, function(val, key) {
    return val % 2;
}); // -> {a: 1, c: 3}

pipe

source test1.23.0

将所有的 stream 流连接起来。

类型定义
import stream = require('stream');
function pipe(...streams: stream.Stream[]): void;
参数名说明
...streams要连接的 stream 流
const fs = require('fs');
const through = require('licia/through');
pipe(
    fs.createReadStream('in.txt'),
    through(function(chunk, enc, cb) {
        this.push(chunk);
        cb();
    }),
    fs.createWriteStream('out.txt')
);

pluck

source test1.0.0

提取数组对象中指定属性值,返回一个数组。

类型定义
function pluck(object: any, key: string | string[]): any[];
参数名说明
obj目标集合
key属性路径
返回值指定属性值列表
const stooges = [
    { name: 'moe', age: 40 },
    { name: 'larry', age: 50 },
    { name: 'curly', age: 60 }
];
pluck(stooges, 'name'); // -> ['moe', 'larry', 'curly']

precision

source test1.0.0

获取数字的精度。

类型定义
function precision(num: number): number;
参数名说明
num要检查的数字
返回值精度
precision(1.234); // -> 3;

prefetch

source test demo1.4.0

预获取指定的 url。

类型定义
function prefetch(url: string): Promise<void>;
参数名说明
url目标 url

如果支持,它将使用<link rel=prefetch>进行预加载。

prefetch('https://eustia.liriliri.io/');

prefix

source test1.0.0

给 css 属性名增加浏览器前缀。

类型定义
namespace prefix {
    function dash(name: string): string;
}
function prefix(name: string): string;
参数名说明
name源属性名
返回值目标属性名

dash

同上,但返回短横线命名方式的版本。

prefix('text-emphasis'); // -> 'WebkitTextEmphasis'
prefix.dash('text-emphasis'); // -> '-webkit-text-emphasis'
prefix('color'); // -> 'color'

promisify

source test1.0.0

转换使用回调的异步函数,使其返回 Promise。

类型定义
function promisify(
    fn: types.AnyFn,
    multiArgs?: boolean
): types.AnyFn;
参数名说明
fn源函数
multiArgs=false回调是否有多个结果
返回值目标函数

如果 multiArgs 设为真,返回的 Promise 会将回调的结果合并成一个数组。

const fs = require('fs');

const readFile = promisify(fs.readFile);
readFile('test.js', 'utf-8').then(function(data) {
    // Do something with file content.
});

property

source test1.0.0

返回一个函数,该函数返回任何传入对象的指定属性。

类型定义
function property(path: string | string[]): types.AnyFn;
参数名说明
path属性路径
返回值目标函数
const obj = { a: { b: 1 } };
property('a')(obj); // -> {b: 1}
property(['a', 'b'])(obj); // -> 1

query

source test1.0.0

解析序列化 url 的 query 部分。

类型定义
const query: {
    parse(str: string): any;
    stringify(object: any): string;
};

parse

将 query 字符串解析成对象。

参数名说明
strquery 字符串
返回值query 对象

stringify

将对象序列化成 query 字符串。

参数名说明
objquery 对象
返回值query 字符串
query.parse('foo=bar&eruda=true'); // -> {foo: 'bar', eruda: 'true'}
query.stringify({ foo: 'bar', eruda: 'true' }); // -> 'foo=bar&eruda=true'
query.parse('name=eruda&name=eustia'); // -> {name: ['eruda', 'eustia']}

quickSort

source test benchmark1.0.0

快排实现。

类型定义
function quickSort(arr: any[], cmp?: types.AnyFn): any[];
参数名说明
arr要排序的数组
cmp比较器
返回值有序数组
quickSort([2, 1]); // -> [1, 2]

raf

source test1.0.0

requestAnimationFrame 快捷方式。

类型定义
namespace raf {
    function cancel(id: number): void;
}
function raf(cb: types.AnyFn): number;

如果原生 requestAnimationFrame 不支持,使用 setTimeout 进行兼容。

const id = raf(function tick() {
    // Animation stuff
    raf(tick);
});
raf.cancel(id);

random

source test1.0.0

在给定区间内生成随机数。

类型定义
function random(
    min: number,
    max?: number,
    floating?: boolean
): number;
参数名说明
min最小值
max最大值
floating=false是否允许浮点数
返回值随机数
random(1, 5); // -> an integer between 0 and 5
random(5); // -> an integer between 0 and 5
random(1.2, 5.2, true); /// -> a floating-point number between 1.2 and 5.2

randomBytes

source test1.0.0

随机字节序列生成器。

类型定义
function randomBytes(size: number): Uint8Array;

如果支持,使用 node 的 crypto 模块或浏览器的 crypto 对象。

参数名说明
size字节序列长度
返回值随机字节序列
randomBytes(5); // -> [55, 49, 153, 30, 122]

randomColor

source test demo1.12.0

随机颜色生成器。

类型定义
function randomColor(): string;
function randomColor(options: {
    count?: number;
    hue?: number;
    lightness?: number;
    format?: string;
    seed?: number;
}): string | string[];
参数名说明
options随机选项
返回值随机颜色

可用选项:

参数名说明
count=1生成数
hue色调,取值为 0 - 360
lightness亮度,取值为 0 - 1
format=hex颜色格式,hex,hsl 或者 rgb
seed随机种子
randomColor({
    count: 2
}); // -> ['#fed7f4', '#526498']

randomId

source test1.4.8

简单 id 生成器,类似于 nanoid。

类型定义
function randomId(size?: number, symbols?: string): string;
参数名说明
size=21id 长度
symbols生成 id 字符,默认为 a-zA-Z0-9_-
randomId(); // -> 'oKpy4HwU8E6IvU5I03gyQ'
randomId(5); // -> 'sM6E9'
randomId(5, 'abc'); // -> 'cbbcb'

randomItem

source test1.0.0

随机获取数组中的某项。

类型定义
function randomItem(arr: any[]): any;
参数名说明
arr目标数组
返回值随机项
randomItem([1, 2, 3]); // -> 2

range

source test1.0.0

创建整数数组。

类型定义
function range(
    start: number,
    end?: number,
    step?: number
): number[];
参数名说明
start起始值
end结束值
step=1相邻差
返回值整数数组
range(5); // -> [0, 1, 2, 3, 4]
range(0, 5, 2); // -> [0, 2, 4]

rc4

source test1.1.0

RC4 对称加密算法实现。

类型定义
const rc4: {
    encrypt(key: string, str: string): string;
    decrypt(key: string, str: string): string;
};

encrypt

RC4 加密,结果表示为 base64 字符串。

decrypt

RC4 解密,传入 base64 字符串。

参数名说明
key密钥
str源字符串
返回值目标字符串
rc4.encrypt('licia', 'Hello world'); // -> 'j9y2VpSfR3AdNN8='
rc4.decrypt('licia', 'j9y2VpSfR3AdNN8='); // -> 'Hello world'

ready

source test1.0.0

dom 准备好时调用回调函数,类似于 jQuery 的 ready 方法。

类型定义
function ready(fn: types.AnyFn): void;
参数名说明
fn回调函数
ready(function() {
    // It's safe to manipulate dom here.
});

reduce

source test benchmark1.0.0

合并多个值成一个值。

类型定义
function reduce<T, TResult>(
    list: types.List<T>,
    iterator: types.MemoIterator<T, TResult>,
    memo?: TResult,
    context?: any
): TResult;
function reduce<T, TResult>(
    list: types.Dictionary<T>,
    iterator: types.MemoObjectIterator<T, TResult>,
    memo?: TResult,
    context?: any
): TResult;
参数名说明
obj目标集合
iteratee=identity合并函数
initial初始值
ctx函数上下文
返回值合并值
reduce(
    [1, 2, 3],
    function(sum, n) {
        return sum + n;
    },
    0
); // -> 6

reduceRight

source test1.0.0

类似于 reduce,只是从后往前合并。

类型定义
function reduceRight<T, TResult>(
    list: types.Collection<T>,
    iterator: types.MemoIterator<T, TResult>,
    memo?: TResult,
    context?: any
): TResult;
reduceRight(
    [[1], [2], [3]],
    function(a, b) {
        return a.concat(b);
    },
    []
); // -> [3, 2, 1]

reject

source test1.0.0

类似 filter,但结果相反。

类型定义
function reject<T>(
    list: types.List<T>,
    iterator: types.ListIterator<T, boolean>,
    context?: any
): T[];
function reject<T>(
    object: types.Dictionary<T>,
    iterator: types.ObjectIterator<T, boolean>,
    context?: any
): T[];
参数名说明
obj要遍历的集合
predicate真值检测函数
ctx函数上下文
返回值包含所有未通过真值检测元素的数组
reject([1, 2, 3, 4, 5], function(val) {
    return val % 2 === 0;
}); // -> [1, 3, 5]

remove

source test1.0.0

移除集合中所有通过真值检测的元素,返回包含所有删除元素的数组。

类型定义
function remove<T, TResult>(
    list: types.List<T>,
    iterator: types.ListIterator<T, boolean>,
    context?: any
): TResult[];

与 filter 不同,该模块会改变原数组。

参数名说明
list要遍历的集合
iterator真值检测函数
context函数上下文
返回值包含所有删除元素的数组
const arr = [1, 2, 3, 4, 5];
const evens = remove(arr, function(val) {
    return val % 2 === 0;
});
console.log(arr); // -> [1, 3, 5]
console.log(evens); // -> [2, 4]

repeat

source test1.0.0

重复字符串指定次数。

类型定义
function repeat(str: string, n: number): string;
参数名说明
str源字符串
n重复次数
返回值目标字符串
repeat('a', 3); // -> 'aaa'
repeat('ab', 2); // -> 'abab'
repeat('*', 0); // -> ''

replaceAll

source test1.23.0

替换字符串中所有指定字符串。

类型定义
function replaceAll(
    str: string,
    substr: string,
    newSubstr: string
): string;
参数名说明
str源字符串
substr被替换的子串
newSubstr替换的子串
返回值所有子串被替换后的新字符串
replaceAll('hello world goodbye world', 'world', 'licia'); // -> 'hello licia goodbye licia'

restArgs

source test1.0.0

将给定序号后的参数合并成一个数组。

类型定义
function restArgs(
    fn: types.AnyFn,
    startIndex?: number
): types.AnyFn;
参数名说明
function源函数
startIndex合并参数起始位置
返回值目标函数
const paramArr = restArgs(function(rest) {
    return rest;
});
paramArr(1, 2, 3, 4); // -> [1, 2, 3, 4]

reverse

source test benchmark1.16.0

将数组元素颠倒,不改变原数组。

类型定义
function reverse(arr: any[]): any[];
参数名说明
arr源数组
返回值目标数组
reverse([1, 2, 3]); // -> [3, 2, 1]

rgbToHsl

source test1.0.0

将 rgb 格式的颜色值转换为 hsl 格式。

类型定义
function rgbToHsl(rgb: number[]): number[];
参数名说明
rgbrgb 值
返回值hsl 值
rgbToHsl([52, 203, 165, 0.8]); // -> [165, 59, 50, 0.8]

ric

source test1.4.0

requestIdleCallback 的快捷方式。

类型定义
namespace ric {
    function cancel(id: number): void;
}
function ric(cb: types.AnyFn): number;

如果原生 requestIdleCallback 不支持,使用 setTimeout 进行兼容。

const id = ric(function() {
    // Called during a browser's idle periods
});
ric.cancel(id);

rmCookie

source test1.0.0

遍历所有可能的路径和域名将 cookie 删除。

类型定义
function rmCookie(key: string): void;
参数名说明
keycookie 名
rmCookie('test');

rmdir

source test1.0.0

递归地删除文件夹。

类型定义
function rmdir(dir: string, cb?: types.AnyFn): void;
参数名说明
dir文件夹路径
cb回调
rmdir('/tmp/foo/bar/baz', function(err) {
    if (err) console.log(err);
    else console.log('Done');
});

root

source test1.0.0

根对象引用,对于 nodeJs,取 global 对象,对于浏览器,取 window 对象。

类型定义
const root: any;

rpad

source test1.0.0

对字符串进行右填充。

类型定义
function rpad(str: string, len: number, chars?: string): string;
参数名说明
str源字符串
len填充长度
chars填充字符
返回值目标字符串
rpad('a', 5); // -> 'a    '
rpad('a', 5, '-'); // -> 'a----'
rpad('abc', 3, '-'); // -> 'abc'
rpad('abc', 5, 'ab'); // -> 'abcab'

rtrim

source test1.0.0

删除字符串尾部指定字符或空格。

类型定义
function rtrim(str: string, chars?: string | string[]): string;
参数名说明
str源字符串
chars删除字符
返回值目标字符串
rtrim(' abc  '); // -> ' abc'
rtrim('_abc_', '_'); // -> '_abc'
rtrim('_abc_', ['c', '_']); // -> '_ab'

safeCb

source test1.0.0

创建回调函数,内部模块使用。

类型定义
function safeCb(
    val?: any,
    ctx?: any,
    argCount?: number
): types.AnyFn;

safeDel

source test1.0.0

删除对象属性。

类型定义
function safeDel(obj: any, path: string | string[]): any;
参数名说明
obj目标对象
path属性路径
返回值删除值或 undefined
const obj = { a: { aa: { aaa: 1 } } };
safeDel(obj, 'a.aa.aaa'); // -> 1
safeDel(obj, ['a', 'aa']); // -> {}
safeDel(obj, 'a.b'); // -> undefined

safeGet

source test1.0.0

获取对象属性值,路径不存在时不报错。

类型定义
function safeGet(obj: any, path: string | string[]): any;
参数名说明
obj目标对象
path属性路径
返回值属性值或 undefined
const obj = { a: { aa: { aaa: 1 } } };
safeGet(obj, 'a.aa.aaa'); // -> 1
safeGet(obj, ['a', 'aa']); // -> {aaa: 1}
safeGet(obj, 'a.b'); // -> undefined

safeSet

source test1.0.0

设置对象属性值。

类型定义
function safeSet(
    obj: any,
    path: string | string[],
    val: any
): void;

如果路径的某一层不存在,将会创建一个空对象。

参数名说明
obj目标对象
path属性路径
val要设置的值
const obj = {};
safeSet(obj, 'a.aa.aaa', 1); // obj = {a: {aa: {aaa: 1}}}
safeSet(obj, ['a', 'aa'], 2); // obj = {a: {aa: 2}}
safeSet(obj, 'a.b', 3); // obj = {a: {aa: 2, b: 3}}

safeStorage

source test1.0.0

安全地使用 storage,使其在旧浏览器及 safari 无痕模式下能正常运行。

类型定义
function safeStorage(type?: string): typeof window.localStorage;
参数名说明
type='local'模式,local 或 session
返回值指定 storage
const localStorage = safeStorage('local');
localStorage.setItem('licia', 'util');

sameOrigin

source test1.26.0

检查两个 url 是否同源。

类型定义
function sameOrigin(url1: string, url2: string): boolean;
参数名说明
url1要检查的 url
url2要检查的 url
返回值同源,返回真
const url1 = 'http://example.com/a.html';
const url2 = 'http://example.com/b.html';
const url3 = 'http://licia.liriliri.io';
sameOrigin(url1, url2); // -> true
sameOrigin(url1, url3); // -> false

sample

source test1.0.0

从集合中随机抽取部分样本。

类型定义
function sample(obj: any, n: number): any[];
参数名说明
obj目标集合
n样本数量
返回值样本
sample([2, 3, 1], 2); // -> [2, 3]
sample({ a: 1, b: 2, c: 3 }, 1); // -> [2]

scrollTo

source test demo1.0.0

以动画的形式滚动到指定目标。

类型定义
function scrollTo(
    target: Element | string | number,
    options: {
        tolerance?: number;
        duration?: number;
        easing?: string | Function;
        callback?: types.AnyFn;
    }
);
参数名说明
target滚动目标
options滚动选项

选项

选项名说明
tolerance=0偏移
duration=800时长
easing=outQuart缓动函数
callback=noop结束回调
scrollTo('body', {
    tolerance: 0,
    duration: 800,
    easing: 'outQuart',
    callback: function() {}
});

seedRandom

source test1.12.0

随机数生成器。

类型定义
function seedRandom(
    seed: number,
    min?: number,
    max?: number,
    floating?: boolean
): () => number;
参数名说明
seed随机种子
min=0最小值
max=1最大值
floating=true是否允许浮点数
返回值生成随机数字序列的函数
const random = seedRandom(19920719, 0, 100, false);
random(); // -> 7
random(); // -> 68

selectionSort

source test1.0.0

选择排序实现。

类型定义
function selectionSort(arr: any[], cmp?: types.AnyFn): any[];
参数名说明
arr要排序的数组
cmp比较器
返回值有序数组
selectionSort([2, 1]); // -> [1, 2]

selector

source test1.14.0

CSS 选择器解析器。

类型定义
namespace selector {
    interface IToken {
        type: string;
        value: string;
    }
}
const selector: {
    parse(selector: string): Array<selector.IToken[]>;
    stringify(selector: Array<selector.IToken[]>): string;
};

parse

将 CSS 选择器转换为 js 对象。

参数名说明
selectorCSS 选择器
返回值js 对象

stringify

将 js 对象序列化成 CSS 选择器。

参数名说明
groups要序列化的对象
返回值CSS 选择器
const groups = selector.parse('#test, input.user[name="licia"]');
// -> [[{type: 'id', value: 'test'}],[{type: 'tag', value: 'input'}...]]
selector.stringify(groups);

shebang

source test1.23.0

获取 shebang 命令。

类型定义
function shebang(str: string): string | void;
参数名说明
str要获取命令的文本
返回值Shebang 命令
shebang('#!/usr/bin/env node'); // -> '/usr/bin/env node'
shebang('#!/bin/bash'); // -> '/bin/bash'
shebang('node'); // -> undefined

shellSort

source test1.5.0

希尔排序实现。

类型定义
function shellSort(arr: any[], cmp?: types.AnyFn): any[];
参数名说明
arr要排序的数组
cmp比较器
返回值有序数组
shellSort([2, 1]); // -> [1, 2]

shuffle

source test1.0.0

将数组中元素的顺序打乱。

类型定义
function shuffle(arr: any[]): any[];
参数名说明
arr源数组
返回值目标数组
shuffle([1, 2, 3]); // -> [3, 1, 2]

size

source test1.0.0

获取对象的大小或类数组元素的长度。

类型定义
function size(obj: any): number;
参数名说明
obj目标集合
返回值集合大小
size({ a: 1, b: 2 }); // -> 2
size([1, 2, 3]); // -> 3

sizeof

source test1.14.0

计算 js 对象大概的内存占用。

类型定义
function sizeof(obj: any): number;
参数名说明
obj要计算的对象
返回值对象大小,单位是字节

一个字符占用 2 字节,布尔值 4 字节,数字 8 字节。

对象键名当成字符串来计算。

sizeof('a'); // -> 2
sizeof(8); // -> 8
sizeof(false); // -> 4
sizeof(function() {}); // -> 0
sizeof({ a: 'b' }); // -> 4

sleep

source test1.4.1

使用 Promise 模拟暂停方法。

类型定义
function sleep(timeout: number): Promise<void>;
参数名说明
timeout暂停时长
(async function() {
    await sleep(2000);
})();

slice

source test1.0.0

截取数组的一部分生成新数组。

类型定义
function slice(
    array: any[],
    start?: number,
    end?: number
): any[];
参数名说明
array目标数组
start=0起始位置
end=array.length结束位置,不包含
slice([1, 2, 3, 4], 1, 2); // -> [2]

slugify

source test1.7.0

Slug 化字符串。

类型定义
function slugify(
    str: string,
    replacement?: { [index: string]: string }
): string;
参数名说明
str源字符串
replacement自定义替换
返回值目标字符串
slugify('I ♥ pony'); // -> 'I-love-pony'
slugify('I ♥ pony', { ' ': '_' }); // -> 'I_love_pony'

snakeCase

source test1.0.0

转换字符串为下划线式。

类型定义
function snakeCase(str: string): string;
参数名说明
str源字符串
返回值下划线式字符串
snakeCase('fooBar'); // -> foo_bar
snakeCase('foo bar'); // -> foo_bar
snakeCase('foo.bar'); // -> foo_bar

some

source test1.0.0

检查集合中是否有元素通过真值检测。

类型定义
function some<T>(
    list: types.List<T>,
    iterator?: types.ListIterator<T, boolean>,
    context?: any
): boolean;
function some<T>(
    object: types.Dictionary<T>,
    iterator?: types.ObjectIterator<T, boolean>,
    context?: any
): boolean;
参数名说明
obj目标集合
predicate真值检测函数
ctx函数上下文
返回值如果有元素通过真值检测,返回真
some([2, 5], function(val) {
    return val % 2 === 0;
}); // -> true

sortBy

source test1.0.0

遍历集合中的元素,将其作为参数调用函数,并以得到的结果为依据对数组进行排序。

类型定义
function sortBy(
    arr: any,
    iterator?: types.AnyFn,
    ctx?: any
): any[];
参数名说明
arr源集合
iteratee=identity排序依据生成函数
ctx函数上下文
返回值排序后的数组
sortBy([1, 2, 3, 4, 5, 6], function(num) {
    return Math.sin(num);
}); // -> [5, 4, 6, 3, 1, 2]

sortKeys

source test1.17.0

排序对象的键名。

类型定义
function sortKeys(
    obj: object,
    options?: {
        deep?: boolean;
        comparator?: types.AnyFn;
    }
): object;
参数名说明
obj要排序的对象
options排序选项
返回值排序后的对象

可用选项:

参数名说明
deep=false是否递归
comparator比较器
sortKeys(
    { b: { d: 2, c: 1 }, a: 0 },
    {
        deep: true
    }
); // -> {a: 0, b: {c: 1, d: 2}}

spaceCase

source test1.0.0

将字符串转换为空格式。

类型定义
function spaceCase(str: string): string;
参数名说明
str源字符串
返回值空格式字符串
spaceCase('fooBar'); // -> foo bar
spaceCase('foo.bar'); // -> foo bar
spaceCase('foo.bar'); // -> foo bar

splitCase

source test1.0.0

将不同命名式的字符串拆分成数组。

类型定义
function splitCase(str: string): string[];
参数名说明
str目标字符串
返回值拆分成的数组
splitCase('foo-bar'); // -> ['foo', 'bar']
splitCase('foo bar'); // -> ['foo', 'bar']
splitCase('foo_bar'); // -> ['foo', 'bar']
splitCase('foo.bar'); // -> ['foo', 'bar']
splitCase('fooBar'); // -> ['foo', 'bar']
splitCase('foo-Bar'); // -> ['foo', 'bar']

splitPath

source test1.0.0

将路径拆分为文件夹路径,文件名和扩展名。

类型定义
function splitPath(
    path: string
): {
    dir: string;
    name: string;
    ext: string;
};
参数名说明
path目标路径
返回值包含文件夹路径,文件名和扩展名的对象
splitPath('f:/foo/bar.txt'); // -> {dir: 'f:/foo/', name: 'bar.txt', ext: '.txt'}
splitPath('/home/foo/bar.txt'); // -> {dir: '/home/foo/', name: 'bar.txt', ext: '.txt'}

stackTrace

source test1.5.3

获取 v8 的 CallSite 对象。

类型定义
function stackTrace(): any[];

Stack trace 接口说明

stackTrace(); // -> List of CallSite objects

startWith

source test1.0.0

检查字符串是否以指定字符串开头。

类型定义
function startWith(str: string, prefix: string): boolean;
参数名说明
str目标字符串
prefix字符串前缀
返回值如果是前缀,返回真
startWith('ab', 'a'); // -> true

strHash

source test1.0.0

使用 djb2 算法进行字符串哈希。

类型定义
function strHash(str: string): number;
参数名说明
str目标字符串
返回值哈希结果
strHash('test'); // -> 2090770981

strToBytes

source test1.1.0

将字符串转换为字节数组。

类型定义
function strToBytes(str: string, encoding?: string): number[];
参数名说明
str目标字符串
encoding=utf8字符串编码
返回值字节数组

支持编码:utf8,hex,base64

strToBytes('licia'); // -> [108, 105, 99, 105, 97]
strToBytes('qK6b/w==', 'base64'); // -> [168, 174, 155, 255]

strTpl

source test1.23.0

简单的字符串模板。

类型定义
function strTpl(str: string, data: types.PlainObj<any>): string;
参数名说明
str模板字符串
data渲染数据
返回值目标字符串
strTpl('Hello, {{name.first}}!', { name: { first: 'licia' } }); // -> 'Hello, licia!'

strWidth

source test1.24.0

获取字符串的可见宽度。

类型定义
function strWidth(str: string): number;
参数名说明
str要获取宽度的字符串
返回值可见宽度
strWidth('Hello \nworld!'); // -> 12
strWidth('\u001b[4m你好,世界!\u001b[0m'); // -> 12

stringify

source test1.0.0

JSON 序列化,支持循环引用和函数。

类型定义
function stringify(obj: any, spaces?: number): string;

undefined 被当作 null 处理。

参数名说明
obj目标对象
spaces缩进
返回值序列化后的字符串
stringify({ a: function() {} }); // -> '{"a":"[Function function () {}]"}'
const obj = { a: 1, b: {} };
obj.b = obj;
stringify(obj); // -> '{"a":1,"b":"[Circular ~]"}'

stringifyAll

source test demo1.5.5

序列化对象,保留类型信息。

类型定义
namespace stringifyAll {
    function parse(str: string): any;
}
function stringifyAll(
    obj: any,
    options?: {
        unenumerable?: boolean;
        symbol?: boolean;
        accessGetter?: boolean;
        timeout?: number;
        depth?: number;
        ignore?: any[];
    }
): string;
参数名说明
obj源对象
options序列化选项
返回值序列化后的字符串

可用选项:

参数名说明
unenumerable=false包含不可枚举值
symbol=false包含 Symbol 键名
accessGetter=false获取 getter 值
timeout=0序列化超时时间
depth=0遍历对象的最大深度
ignore忽略的对象

超时后,所有未序列化的值都会变成 “Timeout”。

parse

将字符串反序列化回对象。

参数名说明
obj序列化后的字符串
返回值目标对象
stringifyAll(function test() {}); // -> '{"value":"function test() {}","type":"Function",...}'

stripAnsi

source test1.0.0

清除字符串中的 ansi 控制码。

类型定义
function stripAnsi(str: string): string;
参数名说明
str源字符串
返回值目标字符串
stripAnsi('\u001b[4mcake\u001b[0m'); // -> 'cake'

stripBom

source test1.38.0

清除 UTF-8 BOM。

类型定义
function stripBom(str: string): string;
参数名说明
str源字符串
返回值目标字符串
stripBom('\uFEFFlicia'); // -> 'licia'

stripCmt

source test1.0.0

清除源码中的注释。

类型定义
function stripCmt(str: string): string;
参数名说明
str源码
返回值无注释代码
stripCmt('// comment \n var a = 5; \/* comment2\n * comment3\n *\/'); // -> ' var a = 5; '

stripColor

source test1.0.0

清除字符串中的 ansi 颜色控制码。

类型定义
function stripColor(str: string): string;
参数名说明
str源字符串
返回值目标字符串
stripColor('\u001b[31mred\u001b[39m'); // -> 'red'

stripHtmlTag

source test1.0.0

清除字符串中的 html 标签。

类型定义
function stripHtmlTag(str: string): string;
参数名说明
str源字符串
返回值目标字符串
stripHtmlTag('<p>Hello</p>'); // -> 'Hello'

stripIndent

source test1.5.4

清除多行文本的缩进。

类型定义
function stripIndent(str: string): string;
function stripIndent(
    literals: TemplateStringsArray,
    ...placeholders: any[]
): string;
参数名说明
str源字符串
返回值目标字符串

它可以像函数一样调用,也可以当成标签模板使用。

stripIndent`
    Test string
        * item one
        * item two
`; // -> 'Test string\n    * item one\n    * item two'

stripNum

source test1.15.0

将数字转换为指定的精度。

类型定义
function stripNum(num: number, precision?: number): number;
参数名说明
num源数字
precision=12精度
返回值目标数字
stripNum(0.1 + 0.2); // -> 0.3

sum

source test1.0.0

计算数字和。

类型定义
function sum(...num: number[]): number;
参数名说明
...num要计算的数字
返回值数字和
sum(1, 2, 5); // -> 8

swap

source test1.0.0

交换数组中的两项。

类型定义
function swap(arr: any[], a: number, b: number): any[];
参数名说明
arr目标数组
a序号一
b序号二
返回值数组本身
const arr = [1, 2];
swap(arr, 0, 1); // -> [2, 1]

table

source test1.24.0

输出表格字符串。

类型定义
function table(rows: Array<string[]>): string;
参数名说明
rows表格数据
返回值表格字符串
table([
    ['', 'firstName', 'lastName'],
    ['daughter', 'Emily', 'Smith'],
    ['father', 'John', 'Smith'],
    ['mother', 'Jane', 'Smith']
]);

template

source test1.0.0

将模板字符串编译成函数用于渲染。

类型定义
function template(str: string, util?: any): types.AnyFn;
参数名说明
str模板字符串
util模板函数
返回值编译后的模板函数
template('Hello <%= name %>!')({ name: 'licia' }); // -> 'Hello licia!'
template('<p><%- name %></p>')({ name: '<licia>' }); // -> '<p>&lt;licia&gt;</p>'
template('<%if (echo) {%>Hello licia!<%}%>')({ echo: true }); // -> 'Hello licia!'
template('<p><%= util["upperCase"](name) %></p>', {
    upperCase: function(str) {
        return str.toLocaleUpperCase();
    }
})({ name: 'licia' }); // -> '<p>LICIA</p>'

throttle

source test1.0.0

返回函数的节流阀版本。

类型定义
function throttle<T extends types.AnyFn>(fn: T, wait: number): T;
参数名说明
fn源函数
wait延迟毫秒数
返回值目标函数
const updatePos = throttle(function() {}, 100);
// $(window).scroll(updatePos);

through

source test1.0.0

stream Transform 类的简单包装。

类型定义
import stream = require('stream');
namespace through {
    interface ThroughConstructor extends stream.Transform {
        new (opts?: stream.DuplexOptions): stream.Transform;
        (opts?: stream.DuplexOptions): stream.Transform;
    }
    type TransformCallback = (err?: any, data?: any) => void;
    type TransformFunction = (
        this: stream.Transform,
        chunk: any,
        enc: string,
        callback: TransformCallback
    ) => void;
    type FlushCallback = (
        this: stream.Transform,
        flushCallback: () => void
    ) => void;
    function obj(
        transform?: TransformFunction,
        flush?: FlushCallback
    ): stream.Transform;
    function ctor(
        transform?: TransformFunction,
        flush?: FlushCallback
    ): ThroughConstructor;
    function ctor(
        opts?: stream.DuplexOptions,
        transform?: TransformFunction,
        flush?: FlushCallback
    ): ThroughConstructor;
}
function through(
    transform?: through.TransformFunction,
    flush?: through.FlushCallback
): stream.Transform;
function through(
    opts?: stream.DuplexOptions,
    transform?: through.TransformFunction,
    flush?: through.FlushCallback
): stream.Transform;
参数名说明
opts={}初始化流选项
transformTransform 实现
flushFlush 实现

obj

设置 objectMode 为真的快捷方式。

ctor

返回继承 Transform 的类。

const fs = require('fs');
fs.createReadStream('in.txt')
    .pipe(
        through(function(chunk, enc, cb) {
            // Do something to chunk
            this.push(chunk);
            cb();
        })
    )
    .pipe(fs.createWriteStream('out.txt'));

timeAgo

source test1.0.0

将时间格式化成多久之前的形式。

类型定义
function timeAgo(
    date: Date | number,
    now?: Date | number
): string;
参数名说明
date目标日期
now=new Date当时日期
返回值格式化时间表示
const now = new Date().getTime();
timeAgo(now - 1000 * 6); // -> just now
timeAgo(now - 1000 * 15); // -> 15 seconds ago
timeAgo(now + 1000 * 60 * 15); // -> in 15 minutes
timeAgo(now - 1000 * 60 * 60 * 5, now); // -> 5 hours ago

timeTaken

source test1.0.0

获取函数的执行时间。

类型定义
function timeTaken(fn: types.AnyFn): number;
参数名说明
fn要计算执行时间的函数
返回值执行时间,单位毫秒
timeTaken(function() {
    // Do something.
}); // -> Time taken to execute given function.

times

source test1.2.0

调用目标函数 n 次。

类型定义
function times<T>(
    n: number,
    fn: (n: number) => T,
    ctx?: any
): T[];
参数名说明
n调用次数
fn目标函数
ctx函数上下文
返回值结果数组
times(3, String); // -> ['0', '1', '2']

toArr

source test1.0.0

将任意值转换为数组。

类型定义
function toArr(val: any): any[];
参数名说明
val要转换的值
返回值转换后的数组
toArr({ a: 1, b: 2 }); // -> [{a: 1, b: 2}]
toArr('abc'); // -> ['abc']
toArr(1); // -> [1]
toArr(null); // -> []

toAsync

source test1.8.0

让 generator 可以像 async/await 一样使用。

类型定义
function toAsync(fn: types.AnyFn): types.AnyFn;
参数名说明
fnGenerator 函数
返回值目标函数
const sleep = require('licia/sleep');

const fn = toAsync(function*() {
    yield sleep(200);
    return 'licia';
});

fn().then(str => {});

toBool

source test1.0.0

将任意值转换为布尔值。

类型定义
function toBool(val: any): boolean;
参数名说明
val要转换的值
返回值转换后的布尔值
toBool(true); // -> true
toBool(null); // -> false
toBool(1); // -> true
toBool(0); // -> false
toBool('0'); // -> false
toBool('1'); // -> true
toBool('false'); // -> false

toDate

source test1.0.0

将任意值转换为日期类型。

类型定义
function toDate(val: any): Date;
参数名说明
val要转换的值
返回值转换后的日期值
toDate('20180501');
toDate('2018-05-01');
toDate(1525107450849);

toEl

source test1.0.0

将 html 字符串转换为 dom 元素。

类型定义
function toEl(str: string): Element;

必须只有一个根元素。

参数名说明
strhtml 字符串
返回值html 元素
toEl('<div>test</div>');

toInt

source test1.0.0

将任意值转换为整数。

类型定义
function toInt(val: any): number;
参数名说明
val要转换的值
返回值转换后的整数
toInt(1.1); // -> 1
toInt(undefined); // -> 0

toNum

source test1.0.0

将任意值转换为数字。

类型定义
function toNum(val: any): number;
参数名说明
val要转换的值
返回值转换后的数字
toNum('5'); // -> 5

toSrc

source test1.0.0

将函数转换为源码。

类型定义
function toSrc(fn: types.AnyFn): string;
参数名说明
fn目标函数
返回值源码
toSrc(Math.min); // -> 'function min() { [native code] }'
toSrc(function() {}); // -> 'function () { }'

toStr

source test1.0.0

将任意值转换为字符串。

类型定义
function toStr(val: any): string;
参数名说明
val要转换的值
返回值转换后的字符串
toStr(null); // -> ''
toStr(1); // -> '1'
toStr(false); // -> 'false'
toStr([1, 2, 3]); // -> '1,2,3'

topoSort

source test1.0.0

拓扑排序实现。

类型定义
function topoSort(edges: any[]): any[];
参数名说明
edges依赖关系
返回值排序后的数组
topoSort([
    [1, 2],
    [1, 3],
    [3, 2]
]); // -> [1, 3, 2]

trigger

source test1.0.0

触发浏览器事件。

类型定义
function trigger(
    el: Element | Document,
    type: string,
    options?: any
): void;
function trigger(type: string, options?: any): void;
参数名说明
el=document目标元素
type事件类型
options选项
trigger(document.getElementById('test'), 'mouseup');
trigger('keydown', { keyCode: 65 });

trim

source test benchmark1.0.0

删除字符串两边指定字符或空格。

类型定义
function trim(str: string, chars?: string | string[]): string;
参数名说明
str源字符串
chars删除字符
返回值目标字符串
trim(' abc  '); // -> 'abc'
trim('_abc_', '_'); // -> 'abc'
trim('_abc_', ['a', 'c', '_']); // -> 'b'

truncate

source test1.20.0

截取字符串,使其长度为指定值。

类型定义
function truncate(
    txt: string,
    width: number,
    options?: {
        ellipsis?: string;
        separator: string;
    }
): string;
参数名说明
txt要截取的字符串
width最大字符串长度
options选项
返回值截取后的字符串

选项:

参数名说明
ellipsis='...'表示截取掉部分的符号
separator分隔符,尽可能使截取位置在该处
truncate('ORA ORA ORA ORA ORA ORA', 12); // -> 'ORA ORA O...'
truncate('ORA ORA ORA ORA ORA ORA', 10, {
    separator: ' ',
    ellipsis: '……'
}); // -> 'ORA ORA……'

tryIt

source test1.0.0

在 try catch 块中运行函数。

类型定义
function tryIt(fn: types.AnyFn, cb?: types.AnyFn): void;
参数名说明
fn目标函数
cb回调
tryIt(
    function() {
        // Do something that might cause an error.
    },
    function(err, result) {
        if (err) console.log(err);
    }
);

type

source test1.0.0

获取 JavaScript 对象的内部类型。

类型定义
function type(val: any, lowerCase?: boolean): string;
参数名说明
val目标对象
lowerCase=true是否小写
返回值对象类型
type(5); // -> 'number'
type({}); // -> 'object'
type(function() {}); // -> 'function'
type([]); // -> 'array'
type([], false); // -> 'Array'
type(async function() {}, false); // -> 'AsyncFunction'

types

source test1.0.0

仅用于生成 ts 定义文件。

类型定义
namespace types {
    interface Collection<T> {}
    interface List<T> extends Collection<T> {
        [index: number]: T;
        length: number;
    }
    interface ListIterator<T, TResult> {
        (value: T, index: number, list: List<T>): TResult;
    }
    interface Dictionary<T> extends Collection<T> {
        [index: string]: T;
    }
    interface ObjectIterator<T, TResult> {
        (element: T, key: string, list: Dictionary<T>): TResult;
    }
    interface MemoIterator<T, TResult> {
        (prev: TResult, curr: T, index: number, list: List<T>): TResult;
    }
    interface MemoObjectIterator<T, TResult> {
        (prev: TResult, curr: T, key: string, list: Dictionary<T>): TResult;
    }
    type Fn<T> = (...args: any[]) => T;
    type AnyFn = Fn<any>;
    type PlainObj<T> = { [name: string]: T };
}
const types: {};

ucs2

source test1.0.0

UCS-2 编解码。

类型定义
const ucs2: {
    encode(arr: number[]): string;
    decode(str: string): number[];
};

encode

通过码点序列创建字符串。

参数名说明
arr码点序列
返回值编码后的字符串

decode

通过字符串创建码点序列。

参数名说明
str字符串
返回值码点序列
ucs2.encode([0x61, 0x62, 0x63]); // -> 'abc'
ucs2.decode('abc'); // -> [0x61, 0x62, 0x63]
'𝌆'.length; // -> 2
ucs2.decode('𝌆').length; // -> 1

uncaught

source test demo1.2.0

全局错误监听。

类型定义
const uncaught: {
    start(): void;
    stop(): void;
    addListener(fn: (err: Error) => void): void;
    rmListener(fn: (err: Error) => void): void;
    rmAllListeners(): void;
};

start

开始监听错误。

stop

停止监听错误。

addListener

添加监听器。

参数名说明
fn错误监听器

rmListener

移除监听器。

rmAllListeners

移除所有监听器。

uncaught.start();
uncaught.addListener(err => {
    // Do something.
});

unescape

source test1.0.0

和 escape 相反,转义 HTML 实体回去。

类型定义
function unescape(str: string): string;
参数名说明
str源字符串
返回值目标字符串
unescape('You &amp; Me'); // -> 'You & Me'

union

source test1.0.0

返回传入所有数组的并集。

类型定义
function union(...arr: Array<any[]>): any[];
参数名说明
...arr要合并的数组
返回值数组并集
union([2, 1], [4, 2], [1, 2]); // -> [2, 1, 4]

uniqId

source test1.0.0

生成全局唯一 id。

类型定义
function uniqId(prefix?: string): string;
参数名说明
prefixid 前缀
返回值全局唯一 id
uniqId('eustia_'); // -> 'eustia_xxx'

unique

source test1.0.0

返回数组去重后的副本。

类型定义
function unique(
    arr: any[],
    cmp?: (a: any, b: any) => boolean | number
): any[];
参数名说明
arr源数组
cmp比较器
返回值目标数组
unique([1, 2, 3, 1]); // -> [1, 2, 3]

universalify

source test1.7.0

使用异步函数同时支持 promise 及回调模式。

类型定义
function universalify(
    fn: types.AnyFn,
    type: string
): types.AnyFn;
参数名说明
fn异步函数
type源类型,promise 或 callback
返回值目标函数
function callbackFn(str, cb) {
    setTimeout(() => {
        cb(null, str);
    }, 10);
}

const fn = universalify(callbackFn, 'callback');
fn('licia', (err, result) => {
    console.log(result); // -> 'licia'
});
fn('licia').then(result => {
    console.log(result); // -> 'licia'
});

unzip

source test1.0.0

与 zip 相反。

类型定义
declare function unzip(arr: Array<any[]>): Array<any[]>;
参数名说明
arr源数组
返回值目标数组
unzip([
    ['a', 1, true],
    ['b', 2, false]
]); // -> [['a', 'b'], [1, 2], [true, false]]

upperCase

source test1.0.0

转换字符串为大写。

类型定义
function upperCase(str: string): string;
参数名说明
str源字符串
返回值目标字符串
upperCase('test'); // -> 'TEST'

upperFirst

source test1.0.0

将字符串的第一个字符转换为大写。

类型定义
function upperFirst(str: string): string;
参数名说明
str源字符串
返回值目标字符串
upperFirst('red'); // -> Red

use

source test1.0.0

使用 define 创建的模块。

类型定义
function use(requires: string[], method: types.AnyFn): void;
function use(method: types.AnyFn): void;
参数名说明
requires依赖
method要执行的代码
// define('A', () => 'A');
use(['A'], function(A) {
    console.log(A + 'B'); // -> 'AB'
});

utf8

source test1.0.0

UTF-8 编解码。

类型定义
const utf8: {
    encode(str: string): string;
    decode(str: string, safe?: boolean): string;
};

encode

UTF-8 编码。

参数名说明
str源字符串
返回值目标字符串

decode

UTF-8 解码。

参数名说明
str源字符串
safe=false如果设为真,不抛错误
返回值目标字符串
utf8.encode('\uD800\uDC00'); // ->  '\xF0\x90\x80\x80'
utf8.decode('\xF0\x90\x80\x80'); // -> '\uD800\uDC00'

uuid

source test benchmark1.0.0

生成符合 RFC4112 版本 4 协议的 uuid。

类型定义
function uuid(): string;

相关标准 RFC4122 4.4

uuid(); // -> '53ce0497-6554-49e9-8d79-347406d2a88b'

values

source test1.0.0

返回对象所有的属性值。

类型定义
function values(obj: any): any[];
参数名说明
obj目标对象
返回值所有属性值
values({ one: 1, two: 2 }); // -> [1, 2]

viewportScale

source test1.0.0

获取窗口缩放比。

类型定义
function viewportScale(): number;
viewportScale(); // -> 3

vlq

source test1.4.0

vlq 编解码。

类型定义
const vlq: {
    encode(number: number | number[]): string;
    decode(string: string): number[];
};

encode

将数字编码为 vlq 字符串。

参数名说明
number源数字
返回值目标字符串

decode

将 vlq 字符串解码为数字。

参数名说明
string源字符串
返回值目标数字
vlq.encode(123); // -> '2H'
vlq.encode([123, 456, 789]); // -> '2HwcqxB'
vlq.decode('2H'); // -> [123]
vlq.decode('2HwcqxB'); // -> [123, 456, 789]

waitUntil

source test1.4.3

等待直到条件函数返回真值。

类型定义
function waitUntil(
    condition: types.AnyFn,
    timeout?: number,
    interval?: number
): Promise<any>;
参数名说明
condition条件函数
timeout=0超时
interval=250等待间隔
let a = 5;
setTimeout(() => (a = 10), 500);
waitUntil(() => a === 10).then(() => {
    console.log(a); // -> 10
});

waterfall

source test1.0.0

按顺序执行函数序列。

类型定义
function waterfall(tasks: types.AnyFn[], cb?: types.AnyFn): void;
参数名说明
tasks函数序列
cb结束回调
waterfall(
    [
        function(cb) {
            cb(null, 'one');
        },
        function(arg1, cb) {
            // arg1 -> 'one'
            cb(null, 'done');
        }
    ],
    function(err, result) {
        // result -> 'done'
    }
);

wordWrap

source test1.27.0

按照指定长度对字符串进行折行处理。

类型定义
function wordWrap(txt: string, width: number): string;
参数名说明
txt要折行的字符串
width最大行宽度
返回值折行后的字符串
wordWrap('Licia is a utility library.', 10);
// -> 'Licia is \na utility \nlibrary.'

wordsToBytes

source test1.16.0

将 32 位字长数组转换为字节数组。

类型定义
function wordsToBytes(words: number[]): number[];
参数名说明
words字长数组
返回值字节数组
wordsToBytes([0x12345678]); // -> [0x12, 0x34, 0x56, 0x78]

workerize

source test demo1.0.0

将函数运行在 worker 线程中。

类型定义
function workerize(fn: types.AnyFn): types.AnyFn;
参数名说明
fn源函数
返回值目标函数
const worker = workerize(function(a, b) {
    return a + b;
});
worker(1, 2).then(function(value) {
    console.log(value); // -> 3
});

wrap

source test1.0.0

将函数封装到包裹函数里面, 并把它作为第一个参数传给包裹函数。

类型定义
function wrap(
    fn: types.AnyFn,
    wrapper: types.AnyFn
): types.AnyFn;
参数名说明
fn要包裹的函数
wrapper包裹函数
返回值目标函数
const p = wrap(escape, function(fn, text) {
    return '<p>' + fn(text) + '</p>';
});
p('You & Me'); // -> '<p>You &amp; Me</p>'

wx

source test1.4.6

小程序 wx 对象的 promise 版本。

类型定义
const wx: any;
wx.getStorage('test').then(res => {
    console.log(res.data);
});

xpath

source test1.10.0

使用 xpath 选择元素,不支持 IE。

类型定义
function xpath(xpath: string): HTMLElement[];
参数名说明
xpathXpath
返回值目标元素集
xpath('//html/body'); // -> [body]

zip

source test1.0.0

将每个数组中相应位置的值合并在一起。

类型定义
function zip(...arr: Array<any[]>): Array<any[]>;
参数名说明
arr源数组
返回值目标数组
zip(['a', 'b'], [1, 2], [true, false]); // -> [['a', 1, true], ['b', 2, false]]