Question

适合移动端的 语言增强 模块。

Usage

通过 edp 引入模块：

edp import saber-lang

require( [ 'saber-lang' ], function( lang ) {
    var targetObj = { x: 1, y: 2 };
    var sourceObj = { y: 3, z: 4 };
    lang.extend( targetObj, sourceObj );

    console.log( targetObj ); // { x: 1, y: 3, z: 4 }
});

API

Base

Base 部分是最基础的语言增强函数，在 require('saber-lang') 时加载。

.extend( target, …source )

对象属性拷贝。

.inherits( subClass, superClass )

为类型构造器建立继承关系。

.curry( fn, …args )

为函数提前绑定前置参数（柯里化）。

.bind( fn, thisArg, …args )

为函数绑定this与前置参数。

Type

Type 部分是较常用的类型检查方法，需指定完整路径引入 require('saber-lang/type')。

.type( obj )

获取变量类型。支持的返回值:

• boolean
• number
• string
• function
• array
• date
• regexp
• object
• error

.isPlainObject( obj )

检测变量是否为简单对象。

.isEmptyObject( obj )

检测变量是否为空的简单对象。

.isEmpty( obj )

检测变量是否为空值类型。 注: {}、[] 也属于空值类型。

Function

Function 类的语言增强函数都需要指定完整路径引入，如 require('saber-lang/function/throttle')。

.throttle( fn, wait [, options] )

函数节流 (忽略指定间隔内的函数调用)。

• fn {Function} 执行函数
• wait {number} 下次执行前需等待的 毫秒 数(即 节流阀值 )
• options {Object=} 配置对象
  • options.leading {boolean=} 是否首次立即执行一次 fn, 默认 true
  • options.trailing {boolean=} 是否停止后延迟执行一次 fn, 默认 true
  • options.context {*=} fn 执行时的上下文环境, 默认 this

.debounce( fn, wait [, immediate] )

函数去抖 (指定间隔内的调用被延迟到下个间隔执行)。

• fn {Function} 执行函数
• wait {number} 需要延迟等待的间隔( 毫秒 )
• immediate {boolean=} 是否延迟启动前先立即调用执行 fn

aspect.mixin( obj )

为指定对象混入 AOP 功能。

• before

obj.before( method, fn[, context] )

在 `obj` 的 `method` 方法调用前，先调用 `fn` 函数。

* `fn` 执行时的 `形参` 与 `obj[ method ]` 的一致
* `context` 指定时，`fn` 的 `this` 指向 `context`
* `fn` 返回 `false` 时，`中断`后续的所有调用

• after

obj.after( method, fn[, context] )

在 `obj` 的 `method` 方法调用后，调用 `fn` 函数。

* `fn` 执行时的 `形参` 与 `obj[ method ]` 的一致
* `context` 指定时，`fn` 的 `this` 指向 `context`

,