• 无前缀：public
• _ 开头：protected
• __ 开头：private

断言

import {Assert} from 'jx-cores';

Assert.instanceOf(inst, expectedInst, msg);
Assert.instanceOneOf(inst, expectedInsts, msg);

Assert.oneOf(value, expectedValues, msg);

Assert.equal(inst, expectedInst, msg);
Assert.objectEqual(inst, expectedInst, msg);

Assert.hasFunction(valueName, inst, msg);
Assert.hasProperty(valueName, inst, msg);
Assert.hasProperties(valueNames, inst, msg);

Assert.greaterThan(expected, value, msg);
Assert.greaterThanOrEqual(expected, value, msg);
Assert.lessThan(expected, value, msg);
Assert.lessThanOrEqual(expected, value, msg);

Assert.integer(value, msg);
Assert.number(value, msg);
Assert.string(value, msg);
Assert.boolean(value, msg);
Assert.true(value, msg);
Assert.false(value, msg);
Assert.object(value, msg);
Assert.array(value, msg);
Assert.function(value, msg);

降维 Promise.then().catch() => [err, res]

告别回调函数

async function asyncFunctionWithThrow() {
  const [err, user] = await to(UserModel.findById(1));

  if (!user) throw new Error('User not found');
 }

Cookie

小程序不可用

枚举

• 也推荐：adrai/enum

import {BizEnum, BizEnumGroug} from 'jx-cores';

const SexEnum = {
  MALE: BizEnum.$(0, '男'),
  FEMALE: BizEnum.$(1, '女')
};
const SexEnumGroup = BizEnumGroug.$(SexEnum);

var type = res.type;
var sex = SexEnumGroup.valueOf(type);

if (sex) {
  console.log('sex = ', sex.msg);

  if (SexEnum.MALE.equal(type)) {
    // 处理男性情况
  } else if (SexEnum.FEMALE.equal(type)) {
    // 处理女性情况
  }
}

错误

import {BizError} from 'jx-cores';

var error1 = new BizError(); // { err: -3.14, msg: "未定义错误", name: "未知业务"}
error1.named("体验权限").err(1001).msg("您没有体验权限，请联系管理员获取");

error1.is("无体验权限错误") // true
error1.is(1001) // true
error.is(1000) // false

BizError.Failure(1002, "请求超时，请稍后再试", "网络"); 
// { err: 1002, msg: "请求超时，请稍后再试", name: "网络" }

BizError.Failure(2001, "支付密码错误，请输入正确的密码", "支付"); 
// { err: 2001, msg: "支付密码错误，请输入正确的密码", name: "支付"}

事件

import {Event} from 'jx-cores';
var eventor = new Event()

eventor.on('on.some.thing.happen', function () {
  // do something
});

eventor.emit('on.some.thing.happen')

eventor.once('on.some.thing.happen.and.expire', function () {
  // do it once
});

eventor.emit('on.some.thing.happen.and.expire')
eventor.emit('on.some.thing.happen.and.expire')


var handler = function (){}
var handler1 = function (){}

eventor.on('on.another.thing.happen', handler);
eventor.on('on.another.thing.happen', handler1);
eventor.off('on.another.thing.happen', handler);
eventor.offAll('on.another.thing.happen');
eventor.count('on.another.thing.happen'); // 0

Ajax

小程序不可用

日志

基本功能

• 日志级别
• 模块信息、字段信息与格式
• profile 使用方法：https://www.jb51.net/article/59128.htm

重要组件

| 组件名称 | 对应类名 | 功能描述 | | ------ | ------ | ------ | | 日志器 | Logger | 提供了应用程序可一直使用的接口 | | 处理器 | Handler | 将logger创建的日志记录发送到合适的目的输出 | | 过滤器 | Filter| 提供了更细粒度的控制工具来决定输出哪条日志记录，丢弃哪条日志记录 | | 格式器 | Formatter | 决定日志记录的最终输出格式 |

使用说明

Logger.help() // 获取帮助文档

{
  "获取日志对象": "Logger.getLogger('测试')",
  "测试时间": [
    "logger.time('aaa');",
    "logger.timeEnd('aaa');"
  ],
  "表格打印": "logger.table([{a:1},{b:1}]);",
  "图片打印": "logger.image("http://pic16.nipic.com/20110926/6333052_165902361105_2.jpg")",
  "日志打印": [
    "logger.log(', d', ', a', ', b');",
    "logger.info(', d', ', a', ', b');",
    "logger.warn(', d', ', a', ', b');",
    "logger.error(', d', ', a', ', b');"
  ],
  "日志导出": [
    "var logs = logger.flush(2);",
    "console.log(logs);"
  ],
  "日志过滤": [
    "logger.setFilter(new LoggerFilter({",
    "  filter: (lvl, outputs) => {",
    "    if (lvl === Logger.Level.WARN) return true;",
    "    return false;",
    "  }",
    "}));"
  ],
  "日志处理": [
    "logger.setHandler(new LoggerHandler({",
    "  handle: (lvl)=> {",
    "    console.log(`收到日志： ${lvl}`)",
    "  }",
    "}));"
  ],
  "日志格式化": [
    "logger.setFormatter(new LoggerFormatter({",
    "  format: (lvl, outputs) => {",
    "    return `已达标, ${outputs}`;",
    "  }",
    "}))"
  ],
  "格式化输出(不支持object)": [
    "%s, 字符串",
    "%d/%i, 整数",
    "%f, 浮点数",
    "%o/%O, Object对象",
    "%c, css样式"
  ]
}

Session

小程序不可用

信号

import {Signal} from 'jx-cores';

var moduleIntializedSignal = new Signal();

var handler = function (){}
var handler1 = function (){}

moduleIntializedSignal.on(handler)
moduleIntializedSignal.once(handler1)
moduleIntializedSignal.off(handler1)
moduleIntializedSignal.offAll() // 注销所有监听者

moduleIntializedSignal.send({ xxx: {} })

moduleIntializedSignal.on(function (data) {
  // 依然能收到数据
  // do some thing
})

moduleIntializedSignal.dispose(); // 信号结束

Storage

小程序不可用