EventArg Class

promiseEvent中事件回调的EventArg(e)参数对象;通过EventArg可以对事件进行阻止冒泡、promise、事件删除还有结果传递等控制； EventArg针对上下文对象（比较trigger和flowController）下，具有的独立的方法；

Methods

Properties

Events

Defined in: src\base\aop.js:178
Module: AOP

Methods

reject

reject
(
  • err
)

Defined in src\base\aop.js:207

拒绝契约，在任何一个事件中reject都会停止所有后续promiseEvent的执行

Parameters:

nametypeflagdescription
err Object

拒绝参数

Example:

            var pCalls = st.promiseEvent(),
                result = [];

            pCalls.add("c1", function(e, name) {
                //延迟100ms
                setTimeout(function() {
                    //拒绝promise,并返回结果
                    e.reject(name + ',reject!');
                }, 100);

                //返回promise
                return e.promise();
            });

            //使用when来监控promiseEvent的执行，使用fail捕获reject
            $.when(pCalls.fire("call")).fail(function(data) {
                expect(data).toBe('call,reject!');

            });

remove

remove () chainable

Defined in src\base\aop.js:216

删除当前事件；与promiseEvent.add的'once'模式，不同在于可以手动进行控制

Example:

            var calls = st.promiseEvent,
                result = [];

            calls.add("onceTest", function(e) {
                //删除"onceTest"这个事件；
                e.remove
            });
            //执行后才会触发删除
            calls.fire();

            //"onceTest"已经不在calls中
            expect(calls.has("onceTest")).toBe(false);

resolve

resolve
(
  • [result]
)

Defined in src\base\aop.js:194

完成契约

Parameters:

nametypeflagdescription
[result] Object optional

返回结果

Example:

            var result = [],obj = st.attachTrigger({
                test: function(name) {
                    result.push(name);
                }
            });

            obj.onBefore('test', 'testBefore', function(e, name) {
                setTimeout(function() {
                    result.push(name + '-before1');
                    e.resolve();
                }, 100);
                return e.promise();
            })

            obj.onBefore('test', 'testBefore2', function(e, name) {
                result.push(name + '-before2');
            })

            obj.on('test', 'testBefore2', function(e, name) {
                setTimeout(function() {
                    result.push(name + '-after');
                    e.resolve();
                }, 100);
                return e.promise();
            })

            $.when(obj.test('call')).done(function() {
                expect(result.join(',')).toBe('call-before1,call-before2,call,call-after');

            })
            var pCalls = st.promiseEvent(),
                result = [];

            pCalls.add("c1", function(e, name) {
                setTimeout(function() {
                    e.resolve(name + '-c1');
                }, 100);
                return e.promise();
            });

            pCalls.add("c2", function(e, name) {
                return e.result + '-c2';
            });

            pCalls.add("c3", function(e, name) {
                setTimeout(function() {
                    e.resolve(e.result + '-c3');
                }, 100);
                return e.promise();
            });

            $.when(pCalls.fire("call")).done(function(data) {
                expect(data).toBe('call-c1-c2-c3');

            });
            var noBlockCalls2 = st.promiseEvent(),
                result = [];
            //第一个回调延迟100
            noBlockCalls2.add("c1", function(e) {
                setTimeout(function() {
                    result.push('c1');
                    e.resolve();
                }, 100);
                //在返回promise的时候，指定noBlock模式
                return e.promise("noBlock");
            });
            //第二个正常执行
            noBlockCalls2.add("c2", function(e) {
                result.push('c2');
            });
            //第三个回调延迟100
            noBlockCalls2.add("c3", function(e) {
                setTimeout(function() {
                    result.push('c3');
                    e.resolve();
                }, 100);
                return e.promise();
            });

            $.when(noBlockCalls2.fire()).done(function(data) {
                //最终执行顺序是c2-c1-c3
                expect(result + '').toBe('c2,c1,c3');

            });

stopPropagation

stopPropagation () chainable

Defined in src\base\aop.js:184

停止所有后续事件执行

Example:

            var calls = st.promiseEvent,
                result = [];

            calls.add("c1", function(e) {
                //停止执行
                e.stopPropagation
            }).add("c2", function() {
                result.push("c2");
            });
            calls.fire();
            expect(result.length).toBe(0);
Top