febs-browser

// Type definitions for febs /// <reference types="node" /> import { Fetch } from './fetch.d'; declare global { /** * 微信小程序不支持 */ var __debug: boolean; /** * @desc: 当前所在行 (客户端不支持, 为undefined). */ var __line: number; /** * @desc: 当前所在列 (客户端不支持, 为undefined). */ var __column: number; /** * 微信小程序不支持 */ function requestAnimationFrame(cb: (tm: number) => void): any; /** * 微信小程序不支持 */ function cancelAnimationFrame(timer: any): void; } export const __debug:boolean; export interface WeekFmt { '0'?: string; '1'?: string; '2'?: string; '3'?: string; '4'?: string; '5'?: string; '6'?: string; } export interface StrFmt { now?: string; second?: string; minute?: string; hour?: string; day_yesterday?: string; day?: string; month?: string; time?: string; // 超过6个月将使用此格式格式化时间 } /** * @desc: big number type */ export class BigNumber { constructor (v:any); /** * Returns a BigNumber whose value is the absolute value, i.e. the magnitude, of the value of this BigNumber. The * return value is always exact and unrounded. * ```ts * x = new BigNumber(-0.8) * y = x.absoluteValue() // '0.8' * z = y.abs() // '0.8' * ``` */ abs(): BigNumber; /** * Returns a BigNumber whose value is the value of this BigNumber plus `n`. * * The return value is always exact and unrounded. */ add(n: number | string | BigNumber): BigNumber; /** * Returns a BigNumber whose value is the value of this BigNumber minus `n`. * * The return value is always exact and unrounded. */ minus(n: number | string | BigNumber): BigNumber; /** * Returns a BigNumber whose value is the value of this BigNumber times n. * * The return value is always exact and unrounded. */ mul(n: number | string | BigNumber, base?: number): BigNumber; /** * Returns a BigNumber whose value is the value of this BigNumber divided by n, rounded according to the current * DECIMAL_PLACES and ROUNDING_MODE configuration. * * ```ts * x = new BigNumber(355) * y = new BigNumber(113) * x.dividedBy(y) // '3.14159292035398230088' * x.dividedBy(5) // '71' * x.dividedBy(47, 16) // '5' * ``` */ dividedBy(n: number | string | BigNumber): BigNumber; /** * Returns a BigNumber whose value is the value of this BigNumber modulo n, i.e. the integer remainder of dividing * this BigNumber by n. * * The value returned, and in particular its sign, is dependent on the value of the [[Configuration.MODULO_MODE]] * setting of this BigNumber constructor. If it is `1` (default value), the result will have the same sign as this * BigNumber, and it will match that of Javascript's `%` operator (within the limits of double precision) and * BigDecimal's remainder method. * * The return value is always exact and unrounded. * * ```ts * 1 % 0.9 // 0.09999999999999998 * x = new BigNumber(1) * x.modulo(0.9) // '0.1' * y = new BigNumber(33) * y.mod('a', 33) // '3' * ``` **/ mod(n: number | string | BigNumber): BigNumber; /** * Returns a BigNumber whose value is the value of this BigNumber rounded to a whole number in the direction of * positive `Infinity`. * * ```ts * x = new BigNumber(1.3) * x.ceil() // '2' * y = new BigNumber(-1.8) * y.ceil() // '-1' * ``` */ ceil(): BigNumber; /** * Returns a BigNumber whose value is the value of this BigNumber rounded to a whole number in the direction of * negative `Infinity`. * * ```ts * x = new BigNumber(1.8) * x.floor() // '1' * y = new BigNumber(-1.3) * y.floor() // '-2' * ``` */ floor(): BigNumber; /** * Returns a BigNumber whose value is the value of this BigNumber rounded by rounding mode rm to a maximum of dp * decimal places. * * - if dp is omitted, or is null or undefined, the return value is n rounded to a whole number. * - if rm is omitted, or is null or undefined, ROUNDING_MODE is used. * * ```ts * x = 1234.56 * Math.round(x) // 1235 * y = new BigNumber(x) * y.round() // '1235' * y.round(1) // '1234.6' * y.round(2) // '1234.56' * y.round(10) // '1234.56' * y.round(0, 1) // '1234' * y.round(0, 6) // '1235' * y.round(1, 1) // '1234.5' * y.round(1, BigNumber.ROUND_HALF_EVEN) // '1234.6' * y // '1234.56' * ``` * * @param dp integer, 0 to 1e+9 inclusive * @param rm integer, 0 to 8 inclusive */ round(dp?: number, rm?: number): BigNumber; /** * Returns a BigNumber whose value is the value of this BigNumber truncated to a whole number. * * ```ts * x = new BigNumber(123.456) * x.truncated() // '123' * y = new BigNumber(-12.3) * y.trunc() // '-12' * ``` */ truncated(): BigNumber; /** * Returns true if the value of this BigNumber equals the value of `n`, otherwise returns `false`. As with JavaScript, * `NaN` does not equal `NaN`. * * Note: This method uses the [[comparedTo]] internally. * * ```ts * 0 === 1e-324 // true * x = new BigNumber(0) * x.equals('1e-324') // false * BigNumber(-0).eq(x) // true ( -0 === 0 ) * BigNumber(255).eq('ff', 16) // true * * y = new BigNumber(NaN) * y.equals(NaN) // false * ``` */ equals(n: number | string | BigNumber): boolean; /** * Returns `true` if the value of this BigNumber is greater than the value of `n`, otherwise returns `false`. * * Note: This method uses the comparedTo method internally. * * ```ts * 0.1 > (0.3 - 0.2) // true * x = new BigNumber(0.1) * x.greaterThan(BigNumber(0.3).minus(0.2)) // false * BigNumber(0).gt(x) // false * BigNumber(11, 3).gt(11.1, 2) // true * ``` */ greaterThan(n: number | string | BigNumber): boolean; /** * Returns `true` if the value of this BigNumber is greater than or equal to the value of `n`, otherwise returns `false`. * * Note: This method uses the comparedTo method internally. */ greaterThanOrEqualTo(n: number | string | BigNumber): boolean; /** * Returns true if the value of this BigNumber is less than the value of n, otherwise returns false. * * Note: This method uses [[comparedTo]] internally. * * @alias [[lt]] */ lessThan(n: number | string | BigNumber): boolean; /** * Returns true if the value of this BigNumber is less than or equal the value of n, otherwise returns false. * * Note: This method uses [[comparedTo]] internally. */ lessThanOrEqualTo(n: number | string | BigNumber): boolean; /** * Returns true if the value of this BigNumber is a whole number, otherwise returns false. */ isInteger(): boolean; /** * Returns `true` if the value of this BigNumber is `NaN`, otherwise returns `false`. * * Note: The native method isNaN() can also be used. */ isNaN(): boolean; /** * Returns true if the value of this BigNumber is negative, otherwise returns false. * * Note: `n < 0` can be used if `n <= * -Number.MIN_VALUE`. */ isNegative(): boolean; /** * Returns true if the value of this BigNumber is zero or minus zero, otherwise returns false. * * Note: `n == 0` can be used if `n >= Number.MIN_VALUE`. */ isZero(): boolean; /** * Returns a BigNumber whose value is the value of this BigNumber negated, i.e. multiplied by -1. * * ```ts * x = new BigNumber(1.8) * x.negated() // '-1.8' * y = new BigNumber(-1.3) * y.neg() // '1.3' * ``` */ negated(): BigNumber; /** * Returns a BigNumber whose value is the square root of the value of this BigNumber, rounded according to the * current DECIMAL_PLACES and ROUNDING_MODE configuration. * * The return value will be correctly rounded, i.e. rounded * as if the result was first calculated to an infinite number of correct digits before rounding. */ sqrt(): BigNumber; /** * Returns a BigNumber whose value is the value of this BigNumber rounded to sd significant digits using rounding mode rm. * * If sd is omitted or is null or undefined, the return value will not be rounded. * * If rm is omitted or is null or undefined, ROUNDING_MODE will be used. * * ```ts * BigNumber.config({ precision: 5, rounding: 4 }) * x = new BigNumber(9876.54321) * * x.toDigits() // '9876.5' * x.toDigits(6) // '9876.54' * x.toDigits(6, BigNumber.ROUND_UP) // '9876.55' * x.toDigits(2) // '9900' * x.toDigits(2, 1) // '9800' * x // '9876.54321' * ``` * * @param sd integer, 1 to 1e+9 inclusive * @param rm integer, 0 to 8 inclusive */ toDigits(sd?: number, rm?: number): BigNumber; /** * Returns a string representing the value of this BigNumber in normal (fixed-point) notation rounded to dp decimal * places using rounding mode `rm`. * * If the value of this BigNumber in normal notation has fewer than `dp` fraction digits, the return value will be * appended with zeros accordingly. * * Unlike `Number.prototype.toFixed`, which returns exponential notation if a number is greater or equal to 10<sup>21</sup>, this * method will always return normal notation. * * If dp is omitted or is `null` or `undefined`, the return value will be unrounded and in normal notation. This is also * unlike `Number.prototype.toFixed`, which returns the value to zero decimal places. * * It is useful when fixed-point notation is required and the current `EXPONENTIAL_AT` setting causes toString to * return exponential notation. * * If `rm` is omitted or is `null` or `undefined`, `ROUNDING_MODE` is used. * * ```ts * x = 3.456 * y = new BigNumber(x) * x.toFixed() // '3' * y.toFixed() // '3.456' * y.toFixed(0) // '3' * x.toFixed(2) // '3.46' * y.toFixed(2) // '3.46' * y.toFixed(2, 1) // '3.45' (ROUND_DOWN) * x.toFixed(5) // '3.45600' * y.toFixed(5) // '3.45600' * ``` * * @param dp integer, 0 to 1e+9 inclusive * @param rm integer, 0 to 8 inclusive */ toFixed(dp?: number, rm?: number): string; /** * Same as [[valueOf]] * * ```ts * x = new BigNumber('177.7e+457') * y = new BigNumber(235.4325) * z = new BigNumber('0.0098074') * * // Serialize an array of three BigNumbers * str = JSON.stringify( [x, y, z] ) * // "["1.777e+459","235.4325","0.0098074"]" * * // Return an array of three BigNumbers * JSON.parse(str, function (key, val) { * return key === '' ? val : new BigNumber(val) * }) * ``` */ toJSON(): string; /** * Returns a BigNumber whose value is the value of this BigNumber raised to the power `n`, and optionally modulo `a` * modulus `m`. * * If `n` is negative the result is rounded according to the current [[Configuration.DECIMAL_PLACES]] and * [[Configuration.ROUNDING_MODE]] configuration. * * If `n` is not an integer or is out of range: * - If `ERRORS` is `true` a BigNumber Error is thrown, * - else if `n` is greater than `9007199254740991`, it is interpreted as `Infinity`; * - else if n is less than `-9007199254740991`, it is interpreted as `-Infinity`; * - else if `n` is otherwise a number, it is truncated to an integer; * - else it is interpreted as `NaN`. * * As the number of digits of the result of the power operation can grow so large so quickly, e.g. * 123.456<sup>10000</sup> has over 50000 digits, the number of significant digits calculated is limited to the * value of the [[Configuration.POW_PRECISION]] setting (default value: `100`) unless a modulus `m` is specified. * * Set [[Configuration.POW_PRECISION]] to `0` for an unlimited number of significant digits to be calculated (this * will cause the method to slow dramatically for larger exponents). * * Negative exponents will be calculated to the number of decimal places specified by * [[Configuration.DECIMAL_PLACES]] (but not to more than [[Configuration.POW_PRECISION]] significant digits). * * If `m` is specified and the value of `m`, `n` and this BigNumber are positive integers, then a fast modular * exponentiation algorithm is used, otherwise if any of the values is not a positive integer the operation will * simply be performed as `x.toPower(n).modulo(m)` with a `POW_PRECISION` of `0`. * * ```ts * Math.pow(0.7, 2) // 0.48999999999999994 * x = new BigNumber(0.7) * x.toPower(2) // '0.49' * BigNumber(3).pow(-2) // '0.11111111111111111111' * ``` * * @param n integer, -9007199254740991 to 9007199254740991 inclusive */ pow(n: number, m?: number | string | BigNumber): BigNumber; /** * Returns a string representing the value of this BigNumber in the specified base, or base 10 if base is omitted or * is `null` or `undefined`. * * For bases above 10, values from 10 to 35 are represented by a-z (as with `Number.prototype.toString`), 36 to 61 by * A-Z, and 62 and 63 by `$` and `_` respectively. * * If a base is specified the value is rounded according to the current `DECIMAL_PLACES` and `ROUNDING_MODE` * configuration. * * If a base is not specified, and this BigNumber has a positive exponent that is equal to or greater than the * positive component of the current `EXPONENTIAL_AT` setting, or a negative exponent equal to or less than the * negative component of the setting, then exponential notation is returned. * * If base is `null` or `undefined` it is ignored. * * ```ts * x = new BigNumber(750000) * x.toString() // '750000' * BigNumber.config({ EXPONENTIAL_AT: 5 }) * x.toString() // '7.5e+5' * * y = new BigNumber(362.875) * y.toString(2) // '101101010.111' * y.toString(9) // '442.77777777777777777778' * y.toString(32) // 'ba.s' * * BigNumber.config({ DECIMAL_PLACES: 4 }); * z = new BigNumber('1.23456789') * z.toString() // '1.23456789' * z.toString(10) // '1.2346' * ``` * * @param base integer, 2 to 64 inclusive */ toString(base?: number): string; /** * As [[toString]], but does not accept a base argument and includes the minus sign for negative zero.` * * ```ts * x = new BigNumber('-0') * x.toString() // '0' * x.valueOf() // '-0' * y = new BigNumber('1.777e+457') * y.valueOf() // '1.777e+457' * ``` */ valueOf(): string; } // // date. export namespace date { /** * @desc: 判断是否是有效时间. */ function isValidate(date: Date): boolean; /** * @desc: 获取时间的string. * @param localtime: ms. * @param fmt: 格式化, 默认为 'HH:mm:ss' * 年(y)、月(M)、日(d)、12小时(h)、24小时(H)、分(m)、秒(s)、周(E)、季度(q) * 'yyyy-MM-dd hh:mm:ss.S' ==> 2006-07-02 08:09:04.423 * 'yyyy-MM-dd E HH:mm:ss' ==> 2009-03-10 星期二 20:09:04 * 'yyyy-M-d h:m:s.S' ==> 2006-7-2 8:9:4.18 * @param weekFmt: 星期的文字格式, 默认为 {'0':'星期天', '1': '星期一', ..., '6':'星期六'} * @return: string. */ function getTimeString(localtime: number, fmt: string, weekFmt: WeekFmt): string; /** * @desc: 获取指定时间距离现在的时间描述. * 例如, 昨天, 1小时前等. * @param localtime: ms. 小于当前时间, 大于当前时间将显示为 '刚刚'; * @param strFmt: 需要显示的文字. * 默认为 { * now: '刚刚', // 3秒钟以内将显示此信息. * second: '秒前', * minute: '分钟前', * hour: '小时前', * day_yesterday: '昨天', * day: '天前', * month: '个月前', // 6个月内将显示此信息. * time: 'yyyy-M-d h:m:s' // 超过6个月将使用此格式格式化时间 * } * @return: string. */ function getTimeStringFromNow(localtime: number, strFmt: string): string; /** * @desc: getDate('2012-05-09') * @return: Date. */ function getDate(strDate: string): Date /** * @desc: getDate2('20120509') * @return: Date. */ function getDate2(strDate: string): Date; /** * @desc: 获取时间的协调世界时间 string. * @param localtime: ms. (本地时间) * @param fmt: 格式化, 默认为 'HH:mm:ss' * 年(y)、月(M)、日(d)、12小时(h)、24小时(H)、分(m)、秒(s)、周(E)、季度(q) * 'yyyy-MM-dd hh:mm:ss.S' ==> 2006-07-02 08:09:04.423 * 'yyyy-MM-dd E HH:mm:ss' ==> 2009-03-10 星期二 20:09:04 * 'yyyy-M-d h:m:s.S' ==> 2006-7-2 8:9:4.18 * @param weekFmt: 星期的文字格式, 默认为 {'0':'星期天', '1': '星期一', ..., '6':'星期六'} * @return: string. */ function getUTCTimeString(localtime: number, fmt: string, weekFmt: WeekFmt): string; /** * @desc: 通过世界时间获取date. getDateFromUTC('2012-05-09') * @param strDateUTC: 世界日期字符串. '2012-05-09' * @return: Date. */ function getDateFromUTC(strDateUTC: string): Date; /** * @desc: 通过世界时间获取date. getDate2FromUTC('20120509') * @param strDateUTC: 世界日期字符串. '20120509' * @return: Date. */ function getDate2FromUTC(strDateUTC: string): Date; /** * @desc: 通过字符串获取date. getTime('2012-05-09 11:10:12') * @param strTime: 时间字符串. '2012-05-09 11:10:12' * @return: Date. */ function getTime(strTime:string): Date; /** * @desc: 通过时间获取date. getTime2('20120509111012') * @param strTime: 时间字符串. '20120509111012' * @return: Date. */ function getTime2(strTime:string): Date; /** * @desc: 通过世界时间获取date. getTimeFromUTC('2012-05-09 11:10:12') * @param strTimeUTC: 世界时间字符串. '2012-05-09 11:10:12' * @return: Date. */ function getTimeFromUTC(strTimeUTC: string): Date; /** * @desc: 通过世界时间获取date. getTime2FromUTC('20120509111012') * @param strTimeUTC: 世界日期字符串. '20120509111012' * @return: Date. */ function getTime2FromUTC(strTimeUTC: string): Date; } // // utils. export namespace utils { /** * @desc: 模拟sleep. * @return: Promise. * 在ms时间后执行. * @e.g. * febs.utils.sleep(1000).then(()=>{ //1000ms之后resolve. }); */ function sleep(ms: number): Promise<void>; function browserIsMobile(): boolean; function browserIsIOS(): boolean; function browserIsPhone(): boolean; function browserIsWeixin(): boolean; function browserIsIE(): boolean; function browserIEVer(): boolean; /** * @desc: the platform is Windows. */ function platformIsWin():boolean; /** * @desc: the platform is Mac. */ function platformIsMac():boolean; // only in client. function browserIsSupportHtml5(): boolean; /** * @desc: 获取时间的string. * @param time: ms. * @param fmt: 格式化, 默认为 'HH:mm:ss' * 年(y)、月(M)、日(d)、12小时(h)、24小时(H)、分(m)、秒(s)、周(E)、季度(q) * 'yyyy-MM-dd hh:mm:ss.S' ==> 2006-07-02 08:09:04.423 * 'yyyy-MM-dd E HH:mm:ss' ==> 2009-03-10 星期二 20:09:04 * 'yyyy-M-d h:m:s.S' ==> 2006-7-2 8:9:4.18 * @param weekFmt: 星期的文字格式, 默认为 {'0':'星期天', '1': '星期一', ..., '6':'星期六'} * @return: string. */ function getTimeString(time: number, fmt?: string, weekFmt?: WeekFmt): string; /** * @desc: 获取指定时间距离现在的时间描述. * 例如, 昨天, 1小时前等. * @param time: ms. 小于当前时间, 大于当前时间将显示为 '刚刚'; * @param strFmt: 需要显示的文字. * 默认为 { * now: '刚刚', // 3秒钟以内将显示此信息. * second: '秒前', * minute: '分钟前', * hour: '小时前', * day_yesterday: '昨天', * day: '天前', * month: '个月前', // 6个月内将显示此信息. * time: 'yyyy-M-d h:m:s' // 超过6个月将使用此格式格式化时间 * } * @return: string. */ function getTimeStringFromNow(time: number, strFmt?: StrFmt): string; /** * @desc: getDate('2012-05-09') * @return: Date. */ function getDate(strDate: string): Date; /** * @desc: getDate2('20120509') * @return: Date. */ function getDate2(strDate: string): Date; /** * @desc: 合并多个map. * @return: {} */ function mergeMap(...map: any[]): any; /** * @desc: 判断参数是否是null,undefined,NaN * @return: boolean */ function isNull(e: any): boolean; /** * @desc: 将异步回调方式的方法转换成promise, 函数中的this可以为指定值. * 例如: yield denodeify(fs.exists)(path); * @param self: 指定的调用对象 * @return: promise. */ function denodeify(fn: any, self?: any, argumentCount?: number): (...args:any[])=>Promise<any>; /** * @desc: 将异步回调方式的方法转换成promise, 函数中的this可以为指定值. * 例如: yield denodeify(fs.exists)(path); * @param self: 指定的调用对象 * @return: promise. */ function promisify(fn: any, self?: any, argumentCount?: number): (...args:any[])=>Promise<any>; /** * @desc: 进行bigint类型转换. 如果数值超过15位,等同于 new BigNumber(v) */ function bigint(v: any): number|BigNumber; /** * @desc: 判断是否是bigint. */ function bigint_check(v: any): boolean; /** * @desc: a%b. */ function bigint_mod(a:any, b:any): BigNumber|number; /** * @desc: a+b. */ function bigint_add(a: any, b: any): BigNumber; /** * @desc: a-b. */ function bigint_minus(a: any, b: any): BigNumber; /** * @desc: a/b. */ function bigint_dividedBy(a: any, b: any): BigNumber; /** * @desc: a*b. */ function bigint_mul(a: any, b: any): BigNumber; /** * @desc: a==b. */ function bigint_equal(a: any, b: any): boolean; /** * @desc: a>b. */ function bigint_more_than(a: any, b: any): boolean; /** * @desc: a>=b. */ function bigint_more_than_e(a: any, b: any): boolean; /** * @desc: a<b. */ function bigint_less_than(a: any, b: any): boolean; /** * @desc: a<=b. */ function bigint_less_than_e(a: any, b: any): boolean; /** * @desc: 转换bigint->string. * @param fixed: 小数位个数, 默认为0. * @return: string. */ function bigint_toFixed(a: any, fixed?: boolean): string; } // // string. export namespace string { /** * @desc: 判断是否是手机号码. * @return: boolean. */ function isPhoneMobile(str: string): boolean; /** * @desc: 判断是否是email. * @return: boolean. */ function isEmail(str: string): boolean; /** * @desc: 判断是否是英文数字组合. * @return: boolean. */ function isAlphaOrDigit(str: string): boolean; /** * @desc: 判断是否是中文. * @return: boolean. */ function isChinese(str: string): boolean; /** * @desc: 是否为空串. * @return: boolean. */ function isEmpty(s?: string): boolean; /** * @desc: 获得字符串utf8编码后的字节长度. * @return: u32. */ function getByteSize(s?: string): number; /** * @desc: 替换字符串中所有的strSrc->strDest. * @return: string. */ function replace(str: string, strSrc: string, strDest: string): string; /** * @desc: 将utf8字符串转为字节数组. * @return: []. */ function utf8ToBytes(str:string):Array<number>; /** * @desc: 将utf8字节数组转为字符串. */ function bytesToUtf8(utfBytes: Array<number>): string; /** * @desc: utf8Encode. */ function utf8Encode(str: string): string; /** * @desc: utf8Decode. */ function utf8Decode(str: string): string; /** * @desc: 去除两端空格. * @return: string. */ function trim(str: string): string; /** * @desc: 对字符串中的 <>空格"& 标签进行转义为 <, > * @return: string. */ function escapeHtml(str: string): string; } // // crypt. export namespace crypt { /** * @desc: 生成一个uuid (v4 random). * @return: */ function uuid(): string; /** * @desc: 计算字符串的crc32值 * @param crc 可以在这个值得基础上继续计算 * @return: number. */ function crc32(str: string, crc?: number): number; /** * @desc: [客户端调用] 通过文件表单控件进行文件的crc32计算. * @param fileObj: 表单文件对象, 例如表单为: * <form enctype="multipart/form-data"> * <input id="file" type="file" name="file" multiple> * </form> * dom('#file')[0].files[0] 即为第一个文件对象. * @param cb: function(crc32) {}; 计算出来的crc32通过回调函数返回 */ function crc32_file(fileObj: any, cb: (crc32: number) => void): void; /** * @desc: [客户端调用] 通过文件表单控件进行文件的crc32计算. * @param fileObj: 表单文件对象, 例如表单为: * <form enctype="multipart/form-data"> * <input id="file" type="file" name="file" multiple> * </form> * dom('#file')[0].files[0] 即为第一个文件对象. * @param length: 如果<0, 将会计算到文件的末尾. * @param cb: function(crc32) {}; 计算出来的crc32通过回调函数返回 */ function crc32_fileSegment(fileObj: any, offset:number, length:number, cb: (crc32: number) => void): void; /** * @desc: 计算字符串的md5值 * @return: string. */ function md5(str: string | Buffer): string; /** * @desc: 计算字符串的sha1值 * @return: string. */ function sha1(str: string | Buffer): string; /** * @desc: base64编码. * @param arrByte: 字节数组. * @return: string. */ function base64_encode(arrByte: Array<number> | Buffer|string): string; /** * @desc: base64解码. * @return: 字节数组. */ function base64_decode(strBase64: string): Array<number>; } // // net. export namespace net { /** * @desc: 使用jquery.ajax类似参数调用. * (微信小程序不支持) * @param cfg: 允许额外传递一个 progress:function(percent) {} 的参数来获取进度. * @return: */ function ajax(cfg: any): { abort: () => void } /** * @desc: 使用fetch方式进行数据请求. * 如果超時, 可以catch到 'timeout' * @param option: 请求选项. * { method, // 请求方法 get, post, delete 等. mode, // 'no-cors', 'same-origin'等; (可忽略) headers, // 请求header, 例如: { "Content-Type": "application/json", "Accept": 'application/json', } body, // 请求内容. timeout, // 超时 (ms), 默认为5000, credentials, // 携带了credentials='include'则服务器需设置Access-Control-Allow-Credentials } * @return: 返回 Promise; * @e.g. febs.net.fetch(url, {}) .then(response=>response.json()) .then(data=>{}) .catch(err=>{ if (err === 'timeout) // 超时. }); */ const fetch : Fetch; /** * @desc: jsonp方式获取数据. * 如果超時, 可以catch到 'timeout' * (微信小程序不支持) * @param option: 请求选项同fetch. 可以附带如下的更多属性. jsonp只能使用`get`方式. * { jsonpCallback, // jsonp请求时附带到地址中的callback参数, 默认为 'callback'; // 服务端需将查询字符串中的此参数作为返回数据中 `callback`([data])的 callback值 } * @return: 返回 Promise; * @e.g. febs.net.jsonp(url, {}) .then(response=>response.json()) .then(data=>{}) .catch(err=>{ if (err === 'timeout) // 超时. }); */ function jsonp(url: string, option: { method?: string, // 请求方法 get, post, delete 等. mode?: string | 'no-cors' | 'cors' | 'same-origin', // 'no-cors', 'same-origin'等; (可忽略) headers?: any, // 请求header, 例如: // { // "Content-Type": "application/json", // "Accept": 'application/json', // } body?: string, // 请求内容. timeout?: number, // 超时 (ms), 默认为5000, credentials?: 'include' | null | undefined, // 携带了credentials='include'则服务器需设置Access-Control-Allow-Credentials }): Promise<any>; } export type SELECTOR = any; /*string|dom|HTMLElement; */ /** * 微信小程序不支持 */ export interface dom { /** * 支持 * - .name 使用类名构建. * - #name 使用id名构建. * - name 使用tag名构建. * - <div...>...</div> 使用内容构建. * - node. * 不支持带空格多层结构的情况. */ new(selector?: SELECTOR): dom; get(index: number): any; /** * @desc: hasClass */ hasClass(cName: string): boolean; /** * @desc: addClass */ addClass(cName: string): dom; /** * @desc: removeClass */ removeClass(cName: string): dom; /** * @desc: toggleClass */ toggleClass(cName: string): dom; /** * @desc: remove */ remove(): void; /** * @desc: append */ append(selector?: SELECTOR): dom; /** * appendTo */ appendTo(selector?: SELECTOR): dom; /** * @desc: prepend */ prepend(selector?: SELECTOR): dom; /** * @desc: prependTo */ prependTo(selector?: SELECTOR): dom; /** * @desc: before */ before(selector?: SELECTOR): dom; /** * insertBefore */ insertBefore(selector?: SELECTOR): dom; /** * @desc: after */ after(selector?: SELECTOR): dom; /** * @desc: insertAfter */ insertAfter(selector?: SELECTOR): dom; /** * @desc: attr. */ attr(attrName: any, value: any): string; /** * @desc: removeAttr */ removeAttr(name: any): dom; /** * @desc: empty. */ empty(): dom; /** * @desc: html. */ html(v: string): string; /** * @desc: text. */ text(v: string): string; /** * @desc: val. */ val(v: string): string; /** * @desc: css. */ css(name: string, value: string): string; /** * html. */ parent(selector?: SELECTOR): dom; parents(selector?: SELECTOR): dom; children(selector?: SELECTOR): dom; prev(selector?: SELECTOR): dom; next(selector?: SELECTOR): dom; /** * @desc: on. */ on(eventname: string, foo: any): dom; bind(eventname: string, foo: any): dom; live(eventname: string, foo: any): dom; /** * @desc: off. */ off(eventname: string, foo?: any): dom; unbind(eventname: string, foo?: any): dom; die(eventname: string, foo?: any): dom; /** * @desc: one. */ one(event: string, f: any): dom; /** * @desc: trigger. */ trigger(eventname: string, extraParameters?: any): dom; ready(f?: any): dom; unload(f?: any): dom; blur(f?: any): dom; change(f?: any): dom; click(f?: any): dom; dblclick(f?: any): dom; error(f?: any): dom; keydown(f?: any): dom; keypress(f?: any): dom; keyup(f?: any): dom; load(f?: any): dom; mousedown(f?: any): dom; mouseenter(f?: any): dom; mouseleave(f?: any): dom; mousemove(f?: any): dom; mouseout(f?: any): dom; mouseover(f?: any): dom; mouseup(f?: any): dom; scroll(f?: any): dom; select(f?: any): dom; submit(f?: any): dom; [index: number]: dom; } /** * 微信小程序不支持 */ export namespace dom { /** * @desc: 获得视口大小. * @return: {width, height} */ function getViewPort(): { width: number, height: number }; /** * @desc: 获得文档大小. * @return: {width, height} */ function getDocumentPort(): { width: number, height: number }; /** * @desc: 获得document scroll offset. * @return: {top, left} */ function getDocumentOffset(): { top: number, left: number }; /** * @desc: 获取指定元素相对于视口的的offset * @return: */ function getElementOffset(e: any): { left: number, top: number }; /** * @desc: 判断是否是dom对象. * @return: boolean. */ function isDom(e: any): boolean; /** * @desc: 统一处理 addEventListener, attachEvent; 并提供useCapture参数问题. */ function addEventListener(domElement:any, event:string, func:any, useCapture?:boolean):null; /** * @desc: 统一处理 removeEventListener, detachEvent; 并提供useCapture参数问题. */ function removeEventListener(domElement:any, event:string, func:any, useCapture?:boolean):null; } export function $(select: SELECTOR): dom; // // exception. export class exception extends Error { constructor(msg: string, code: string, filename: string, line: number, column?: number); /** @desc: 错误代码 */ code: string; /** @desc: 错误消息 */ msg: string; /** @desc: 错误文件 */ filename: string; /** @desc: 错误所在行 */ line: number; /** @desc: 错误所在列 */ column: number; } export namespace exception { /** @desc: 一般错误. */ const ERROR: string; /** @desc: 参数错误. */ const PARAM: string; /** @desc: 越界 */ const OUT_OF_RANGE: string; }