fastevent 0.0.1 → 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (40) hide show
  1. package/.changeset/README.md +8 -0
  2. package/.changeset/config.json +11 -0
  3. package/.github/workflows/publish.yaml +50 -0
  4. package/.vscode/launch.json +20 -0
  5. package/CHANGELOG.md +7 -0
  6. package/LICENSE +21 -0
  7. package/bench.png +0 -0
  8. package/dist/index.d.mts +201 -0
  9. package/dist/index.d.ts +201 -0
  10. package/dist/index.js +2 -0
  11. package/dist/index.js.map +1 -0
  12. package/dist/index.mjs +2 -0
  13. package/dist/index.mjs.map +1 -0
  14. package/package.json +34 -12
  15. package/readme.md +282 -0
  16. package/src/__benchmarks__/index.ts +3 -0
  17. package/src/__benchmarks__/multi-level.ts +40 -0
  18. package/src/__benchmarks__/sample.ts +40 -0
  19. package/src/__benchmarks__/wildcard.ts +41 -0
  20. package/src/__tests__/emit.test.ts +81 -0
  21. package/src/__tests__/emitAsync.test.ts +65 -0
  22. package/src/__tests__/isPathMatched.test.ts +205 -0
  23. package/src/__tests__/many.test.ts +23 -0
  24. package/src/__tests__/meta.test.ts +29 -0
  25. package/src/__tests__/off.test.ts +214 -0
  26. package/src/__tests__/onany.test.ts +173 -0
  27. package/src/__tests__/once.test.ts +71 -0
  28. package/src/__tests__/retain.test.ts +66 -0
  29. package/src/__tests__/scope.test.ts +111 -0
  30. package/src/__tests__/waitFor.test.ts +109 -0
  31. package/src/__tests__/wildcard.test.ts +186 -0
  32. package/src/event.ts +455 -5
  33. package/src/index.ts +3 -1
  34. package/src/scope.ts +88 -0
  35. package/src/types.ts +50 -0
  36. package/src/typestest.ts +102 -0
  37. package/src/utils/isPathMatched.ts +40 -0
  38. package/src/utils/removeItem.ts +16 -0
  39. package/tsconfig.json +112 -0
  40. package/tsup.config.ts +19 -0
package/dist/index.mjs ADDED
@@ -0,0 +1,2 @@
1
+ var p=Object.defineProperty;var L=(o,e,t)=>e in o?p(o,e,{enumerable:true,configurable:true,writable:true,value:t}):o[e]=t;var l=(o,e)=>p(o,"name",{value:e,configurable:true});var u=(o,e,t)=>L(o,typeof e!="symbol"?e+"":e,t);var c=class c{constructor(e,t){u(this,"emitter");u(this,"prefix");this.emitter=e,this.prefix=t,t.length>0&&!t.endsWith(e.options.delimiter)&&(this.prefix=t+e.options.delimiter);}_getScopeListener(e){let t=this.prefix;if(t.length===0)return e;let s=l(function(i,{type:r}){return r.startsWith(t)&&(r=r.substring(t.length)),e(i,{type:r})},"scopeListener");return e.__wrappedListener=s,e}_getScopeType(e){return e===void 0?void 0:this.prefix+e}on(){let e=[...arguments];return e[0]=this._getScopeType(e[0]),e[1]=this._getScopeListener(e[1]),this.emitter.on(...e)}once(){return this.on(arguments[0],arguments[1],1)}onAny(e){let t=this.prefix+"**";return this.on(t,e)}offAll(){this.emitter.offAll(this.prefix);}off(){let e=arguments;typeof e[0]=="string"&&(e[0]=this._getScopeType(e[0])),this.emitter.off(...e);}clear(){this.offAll();}emit(){let e=arguments[0],t=arguments[1],s=arguments[2];return this.emitter.emit(this._getScopeType(e),t,s)}waitFor(){let e=arguments[0],t=arguments[1];return this.emitter.waitFor(this._getScopeType(e),t)}scope(e){return this.emitter.scope(this._getScopeType(e))}};l(c,"FastEventScope");var _=c;function d(o,e){if(o.length!==e.length&&o.length>0&&e[e.length-1]!=="**")return false;let t=[...e];e.length>0&&e[e.length-1]==="**"&&t.splice(e.length-1,1,...Array.from({length:o.length-e.length+1}).fill("*"));for(let s=0;s<o.length;s++)if(t[s]!=="*"&&t[s]!==o[s])return false;return true}l(d,"isPathMatched");function v(o,e){let t=[];for(;;){let s=o.findIndex(i=>e(i));if(s===-1){t.push(s);break}o.splice(s,1);}return t}l(v,"removeItem");var a=class a{constructor(e){u(this,"listeners",{__listeners:[]});u(this,"_options");u(this,"_delimiter","/");u(this,"_context");u(this,"_retainedEvents",new Map);this._options=Object.assign({delimiter:"/",context:null,ignoreErrors:true},e),this._delimiter=this._options.delimiter,this._context=this._options.context||this;}get options(){return this._options}_addListener(e,t,s){return this._forEachNodes(e,i=>{i.__listeners.push(s&&s>0?[t,s]:t),typeof this._options.onAddListener=="function"&&this._options.onAddListener(e,t);})}_forEachNodes(e,t){if(e.length===0)return;let s=this.listeners;for(let i=0;i<e.length;i++){let r=e[i];if(r in s||(s[r]={__listeners:[]}),i===e.length-1){let n=s[r];return t(n,s),n}else s=s[r];}}_removeListener(e,t,s){s&&v(e.__listeners,i=>{i=Array.isArray(i)?i[0]:i;let r=i===s;return r&&typeof this._options.onRemoveListener=="function"&&this._options.onRemoveListener(t,s),r});}on(){let e=arguments[0],t=arguments[1],s=arguments[2];if(e.length===0)throw new Error("event type cannot be empty");if(e==="**")return this.onAny(t);let i=e.split(this._delimiter),r=this._addListener(i,t,s);return r&&!e.includes("*")&&this._emitForLastEvent(e),{off:l(()=>r&&this._removeListener(r,i,t),"off")}}once(){return this.on(arguments[0],arguments[1],1)}onAny(e){return this.listeners.__listeners.push(e),{off:l(()=>this._removeListener(this.listeners,[],e),"off")}}off(){let e=arguments,t=typeof e[0]=="function"?void 0:e[0],s=typeof e[0]=="function"?e[0]:e[1],i=t?t.split(this._delimiter):[],r=t?t.includes("*"):false;if(t&&!r)this._traverseToPath(this.listeners,i,n=>{s?this._removeListener(n,i,s):t&&(n.__listeners=[]);});else {let n=r?[]:i;this._traverseListeners(this.listeners,n,(h,f)=>{(s!==void 0||r&&d(h,i))&&(s?this._removeListener(f,i,s):f.__listeners=[]);});}}offAll(e){if(e){let t=this._getListenerNode(e.split(this._delimiter));t&&(t.__listeners=[]),this._removeRetainedEvents(e);}else this._retainedEvents.clear(),this.listeners={__listeners:[]};}_getListenerNode(e){let t;return this._forEachNodes(e,s=>{t=s;}),t}_removeRetainedEvents(e){e||this._retainedEvents.clear(),e?.endsWith(this._delimiter)&&(e+=this._delimiter),this._retainedEvents.delete(e);for(let t of this._retainedEvents.keys())t.startsWith(e)&&this._retainedEvents.delete(t);}clear(){this.offAll();}_getMeta(e){return this._options.meta?Object.assign({},this._options.meta,e):e}_emitForLastEvent(e){if(this._retainedEvents.has(e)){let t=this._retainedEvents.get(e),s=e.split(this._delimiter);this._traverseToPath(this.listeners,s,i=>{this._executeListeners(i,t,this._getMeta({type:e}));}),this._executeListeners(this.listeners,t,this._getMeta({type:e}));}}_traverseToPath(e,t,s,i=0,r){if(i>=t.length){s(e);return}let n=t[i];if(r===true){this._traverseToPath(e,t,s,i+1,true);return}n in e&&this._traverseToPath(e[n],t,s,i+1),"*"in e&&this._traverseToPath(e["*"],t,s,i+1),"**"in e&&this._traverseToPath(e["**"],t,s,i+1,true);}_traverseListeners(e,t,s){let i=e;t&&t.length>0&&this._traverseToPath(e,t,n=>{i=n;});let r=l((n,h,f)=>{h(f,n);for(let[m,g]of Object.entries(n))m.startsWith("__")||g&&r(g,h,[...f,m]);},"traverseNodes");r(i,s,[]);}_executeListener(e,t,s){try{return typeof e.__wrappedListener=="function"?e.__wrappedListener.call(this._context,t,s):e.call(this._context,t,s)}catch(i){if(i._trigger=s.type,typeof this._options.onListenerError=="function"&&this._options.onListenerError.call(this,s.type,i),this._options.ignoreErrors)return i;throw i}}_executeListeners(e,t,s){if(!e||!e.__listeners)return [];let i=0,r=e.__listeners,n=[];for(;i<r.length;){let h=r[i];Array.isArray(h)?(n.push(this._executeListener(h[0],t,s)),h[1]--,h[1]===0&&(r.splice(i,1),i--)):n.push(this._executeListener(h,t,s)),i++;}return n}emit(){let e=arguments[0],t=arguments[1],s=arguments[2],i=arguments[3]||{},r=e.split(this._delimiter);s&&this._retainedEvents.set(e,t);let n=[];return this._traverseToPath(this.listeners,r,h=>{n.push(...this._executeListeners(h,t,this._getMeta({...i,type:e})));}),n.push(...this._executeListeners(this.listeners,t,this._getMeta({...i,type:e}))),n}async emitAsync(){let e=arguments[0],t=arguments[1],s=arguments[2],i=arguments[3]||{};return (await Promise.allSettled(this.emit(e,t,s,this._getMeta({...i,type:e})))).map(n=>n.status==="fulfilled"?n.value:n.reason)}waitFor(){let e=arguments[0],t=arguments[1];return new Promise((s,i)=>{let r,n,h=l(f=>{clearTimeout(r),n.off(),s(f);},"listener");t&&t>0&&(r=setTimeout(()=>{n&&n.off(),i(new Error("wait for event<"+e+"> is timeout"));},t)),n=this.on(e,h);})}scope(e){return new _(this,e)}};l(a,"FastEvent");var y=a;export{y as FastEvent,_ as FastEventScope};//# sourceMappingURL=index.mjs.map
2
+ //# sourceMappingURL=index.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/scope.ts","../src/utils/isPathMatched.ts","../src/utils/removeItem.ts","../src/event.ts"],"names":["FastEventScope","constructor","emitter","prefix","length","endsWith","options","delimiter","_getScopeListener","listener","scopePrefix","scopeListener","__name","payload","type","startsWith","substring","__wrappedListener","_getScopeType","undefined","on","args","arguments","once","onAny","offAll","off","clear","emit","retain","waitFor","timeout","scope","_FastEventScope","isPathMatched","path","pattern","fPattern","splice","Array","from","fill","i","removeItem","arr","condition","index","findIndex","item","push","FastEvent","listeners","__listeners","_options","_delimiter","_context","_retainedEvents","Map","Object","assign","context","ignoreErrors","_addListener","parts","count","_forEachNodes","node","onAddListener","callback","current","part","_removeListener","isArray","isRemove","onRemoveListener","Error","split","includes","_emitForLastEvent","hasWildcard","_traverseToPath","entryParts","_traverseListeners","entry","entryNode","_getListenerNode","_removeRetainedEvents","delete","key","keys","_getMeta","extra","meta","has","get","_executeListeners","lastFollowing","traverseNodes","parentPath","childNode","entries","_executeListener","call","e","_trigger","onListenerError","result","set","results","emitAsync","Promise","allSettled","map","status","value","reason","resolve","reject","tid","subscriber","clearTimeout","setTimeout","_FastEvent"],"mappings":"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","file":"index.mjs","sourcesContent":["import { FastEvent } from \"./event\";\nimport { FastEventListener, FastEvents, FastEventSubscriber } from \"./types\";\n\nexport class FastEventScope<\n Events extends FastEvents = FastEvents, \n Types extends keyof Events = keyof Events,\n Meta = unknown\n>{\n constructor(public emitter:FastEvent<Events,Types,Meta>,public prefix:string){\n if(prefix.length>0 && !prefix.endsWith(emitter.options.delimiter!)){\n this.prefix = prefix + emitter.options.delimiter\n } \n }\n private _getScopeListener(listener:FastEventListener):FastEventListener{\n const scopePrefix = this.prefix\n if(scopePrefix.length===0) return listener\n const scopeListener = function(payload:any,{type}:{type:string}){\n if(type.startsWith(scopePrefix)){ \n type = type.substring(scopePrefix.length)\n }\n return listener(payload,{type})\n } \n // 当启用scope时对监听器进行包装\n //@ts-ignore\n listener.__wrappedListener = scopeListener\n return listener\n }\n private _getScopeType(type:string){\n return type===undefined ? undefined : this.prefix + type\n } \n \n public on<T extends string>(type: T, listener: FastEventListener<T,Events[T],Meta>, count?:number ): FastEventSubscriber \n public on<T extends Types=Types>(type: T, listener: FastEventListener<T,Events[T],Meta>, count?:number ): FastEventSubscriber \n public on(type: '**', listener: FastEventListener<any,any,Meta>): FastEventSubscriber\n public on(): FastEventSubscriber{\n const args = [...arguments] as [any,any,any]\n args[0] = this._getScopeType(args[0])\n args[1] = this._getScopeListener(args[1])\n return this.emitter.on(...args)\n }\n\n public once<T extends string>(type: T, listener: FastEventListener<T,Events[T],Meta> ): FastEventSubscriber\n public once<T extends Types = Types>(type: T, listener: FastEventListener<Types,Events[T],Meta> ): FastEventSubscriber \n public once(): FastEventSubscriber{\n return this.on(arguments[0],arguments[1],1)\n }\n\n onAny<P=any>(listener: FastEventListener<Types,P,Meta>): FastEventSubscriber {\n const type = this.prefix + '**'\n return this.on(type as any,listener)\n } \n offAll(){\n this.emitter.offAll(this.prefix)\n } \n off(listener: FastEventListener<any, any,any>):void \n off(type: string, listener: FastEventListener<any, any, any>):void\n off(type: Types, listener: FastEventListener<any, any, any>):void\n off(type: string):void\n off(type: Types):void\n off(){\n const args = arguments as unknown as [any,any]\n if(typeof(args[0])==='string'){\n args[0] = this._getScopeType(args[0])\n }\n this.emitter.off(...args)\n } \n clear(){\n this.offAll()\n }\n public emit<R=any>(type:string,payload?:any,retain?:boolean):R[]\n public emit<R=any>(type:Types,payload?:Events[Types],retain?:boolean):R[]\n public emit<R=any>():R[]{\n const type = arguments[0] as string\n const payload = arguments[1] \n const retain = arguments[2] as boolean\n return this.emitter.emit(this._getScopeType(type)!,payload,retain)\n }\n public waitFor<R=any>(type:string,timeout?:number):Promise<R>\n public waitFor<R=any>(type:Types,timeout?:number):Promise<R>\n public waitFor<R=any>():Promise<R>{\n const type = arguments[0] as string\n const timeout = arguments[1] as number\n return this.emitter.waitFor(this._getScopeType(type)!,timeout)\n }\n public scope(prefix:string){\n return this.emitter.scope(this._getScopeType(prefix)!)\n }\n}","\n/**\n * \n * 判断path是否与pattern匹配\n * \n * isPathMatched(\"a.b.c\",\"a.b.c\") == true\n * isPathMatched(\"a.b.c\",\"a.b.*\") == true\n * isPathMatched(\"a.b.c\",\"a.*.*\") == true\n * isPathMatched(\"a.b.c\",\"*.*.*\") == true\n * isPathMatched(\"a.b.c\",\".b.*\") == true\n * isPathMatched(\"a.b.c.d\",\"a.**\") == true\n * \n * - '**' 匹配后续的\n * - '*' 匹配任意数量的字符,包括零个字符\n * \n * @param path \n * @param pattern \n */\nexport function isPathMatched(path:string[],pattern:string[]):boolean{\n if(path.length !== pattern.length && (path.length>0 && pattern[pattern.length-1]!=='**') ){\n return false;\n }\n let fPattern = [...pattern]\n if(pattern.length >0 && pattern[pattern.length-1] === '**'){\n fPattern.splice(pattern.length-1,1,...Array.from<string>({\n length: path.length-pattern.length+1\n }).fill('*'))\n }\n for(let i=0;i<path.length;i++){\n if(fPattern[i]==='*'){\n continue\n }\n if(fPattern[i]!==path[i]){\n return false\n }\n }\n return true\n}\n\n ","\n\nexport function removeItem(arr:any[],condition:(item:any)=>boolean){\n let index:number[] = []\n while (true) {\n const i = arr.findIndex((item)=>{ \n return condition(item)\n })\n if(i === -1) {\n index.push(i)\n break\n } \n arr.splice(i,1)\n }\n return index\n}","import { FastEventScope } from './scope';\nimport { \n FastEventListener, \n FastEventOptions, \n FastEvents, \n FastListeners, \n FastListenerNode, \n FastEventSubscriber, \n ScopeEvents,\n FastEventMeta\n} from './types'; \nimport { isPathMatched } from './utils/isPathMatched';\nimport { removeItem } from './utils/removeItem';\n \nexport class FastEvent<\n Events extends FastEvents = FastEvents, \n Types extends keyof Events = keyof Events,\n Meta = unknown\n>{\n public listeners : FastListeners = { __listeners: [] } as unknown as FastListeners\n private _options : FastEventOptions\n private _delimiter : string = '/'\n private _context : any\n private _retainedEvents : Map<string,any> = new Map<string,any>() \n constructor(options?:FastEventOptions<Meta>) { \n this._options = Object.assign({\n delimiter : '/',\n context : null,\n ignoreErrors : true\n }, options)\n this._delimiter = this._options.delimiter!\n this._context = this._options.context || this\n }\n get options(){ return this._options }\n private _addListener(parts:string[],listener:FastEventListener<any,any>,count?:number):FastListenerNode | undefined{\n return this._forEachNodes(parts,(node)=>{\n node.__listeners.push(count && count >0 ? [listener,count]: listener)\n if(typeof(this._options.onAddListener)==='function'){\n this._options.onAddListener(parts,listener)\n }\n }) \n }\n /**\n * \n * 根据parts路径遍历侦听器树,并在最后的节点上执行回调函数\n * \n * @param parts \n * @param callback \n * @returns \n */\n private _forEachNodes(parts:string[],callback:(node:FastListenerNode,parent:FastListenerNode)=>void):FastListenerNode | undefined{\n if(parts.length === 0) return \n let current = this.listeners\n for(let i=0;i<parts.length;i++){\n const part = parts[i]\n if(!(part in current)){\n current[part] = {\n __listeners: []\n } as unknown as FastListeners\n }\n if(i===parts.length-1){ \n const node = current[part]\n callback(node,current)\n return node\n }else{ \n current = current[part]\n }\n }\n return undefined\n } \n\n\n /**\n * 从监听器节点中移除指定的事件监听器\n * @private\n * @param node - 监听器节点\n * @param listener - 需要移除的事件监听器\n * @description 遍历节点的监听器列表,移除所有匹配的监听器。支持移除普通函数和数组形式的监听器\n */\n private _removeListener(node: FastListenerNode, path:string[],listener: FastEventListener<any,any,any>): void {\n if(!listener) return \n removeItem(node.__listeners,(item:any)=>{\n item = Array.isArray(item) ? item[0] : item \n const isRemove = item === listener \n if(isRemove && typeof(this._options.onRemoveListener)==='function'){\n this._options.onRemoveListener(path,listener)\n }\n return isRemove\n }) \n }\n public on<T extends string>(type: T, listener: FastEventListener<T,Events[T],Meta>, count?:number ): FastEventSubscriber\n public on<T extends Types=Types>(type: T, listener: FastEventListener<Types,Events[T],Meta>, count?:number ): FastEventSubscriber\n public on<P=any>(type: '**', listener: FastEventListener<Types,P,Meta>): FastEventSubscriber\n public on(): FastEventSubscriber{\n const type = arguments[0] as string\n const listener = arguments[1] as FastEventListener \n const count = arguments[2] as number\n if(type.length===0) throw new Error('event type cannot be empty')\n\n if(type==='**'){\n return this.onAny(listener)\n }\n\n const parts = type.split(this._delimiter);\n const node = this._addListener(parts,listener,count)\n \n // Retain不支持通配符\n if(node && !type.includes('*')) this._emitForLastEvent(type) \n\n return {\n off: ()=>node && this._removeListener(node,parts,listener)\n }\n } \n\n public once<T extends string>(type: T, listener: FastEventListener<T,Events[T],Meta> ): FastEventSubscriber\n public once<T extends Types=Types>(type: T, listener: FastEventListener<Types,Events[T],Meta> ): FastEventSubscriber\n public once(): FastEventSubscriber{\n return this.on(arguments[0],arguments[1],1)\n }\n\n /**\n * 注册一个监听器,用于监听所有事件\n * @param listener 事件监听器函数,可以接收任意类型的事件数据\n * @returns {FastEventSubscriber} 返回一个订阅者对象,包含 off 方法用于取消监听\n * @example\n * ```ts\n * const subscriber = emitter.onAny((eventName, data) => {\n * console.log(eventName, data);\n * });\n * \n * // 取消监听\n * subscriber.off();\n * ```\n */\n onAny<P=any>(listener: FastEventListener<string,P,Meta>): FastEventSubscriber {\n const listeners = this.listeners.__listeners\n listeners.push(listener)\n return {\n off:()=>this._removeListener(this.listeners,[],listener)\n }\n }\n\n off(listener: FastEventListener<any, any, any>):void \n off(type: string, listener: FastEventListener<any, any, any>):void\n off(type: Types, listener: FastEventListener<any, any, any>):void\n off(type: string):void\n off(type: Types):void\n off(){\n const args = arguments\n const type = typeof(args[0])==='function' ? undefined : args[0]\n const listener = typeof(args[0])==='function' ? args[0] : args[1]\n const parts = type ? type.split(this._delimiter) : []\n const hasWildcard= type ? type.includes('*') : false\n if(type && !hasWildcard){\n this._traverseToPath(this.listeners,parts,(node)=>{\n if(listener){ // 只删除指定的监听器\n this._removeListener(node,parts,listener)\n }else if(type){\n node.__listeners=[]\n }\n })\n }else{ // 仅删除指定的侦听器\n const entryParts:string[] = hasWildcard ? [] : parts\n this._traverseListeners(this.listeners,entryParts,(path,node)=>{ \n if(listener!==undefined || (hasWildcard && isPathMatched(path,parts))){\n if(listener){\n this._removeListener(node,parts,listener)\n }else{\n node.__listeners=[]\n } \n }\n })\n }\n }\n \n /**\n * 移除所有事件监听器\n * @param entry - 可选的事件前缀,如果提供则只移除指定前缀下的的监听器\n * @description \n * - 如果提供了prefix参数,则只清除该前缀下的所有监听器\n * - 如果没有提供prefix,则清除所有监听器\n * - 同时会清空保留的事件(_retainedEvents)\n * - 重置监听器对象为空\n\n * @example\n * \n * ```ts\n * emitter.offAll(); // 清除所有监听器\n * emitter.offAll('a/b'); // 清除a/b下的所有监听器\n * \n */\n offAll(entry?: string) { \n if(entry){\n const entryNode = this._getListenerNode(entry.split(this._delimiter))\n if(entryNode) entryNode.__listeners = []\n this._removeRetainedEvents(entry)\n }else{ \n this._retainedEvents.clear() \n this.listeners = { __listeners: [] } as unknown as FastListeners\n }\n }\n\n private _getListenerNode(parts:string[]):FastListenerNode | undefined{\n let entryNode: FastListenerNode | undefined\n this._forEachNodes(parts,(node)=>{\n entryNode = node\n })\n return entryNode\n }\n /**\n * 移除保留的事件\n * @param prefix - 事件前缀。如果不提供,将清除所有保留的事件。\n * 如果提供前缀,将删除所有以该前缀开头的事件。\n * 如果前缀不以分隔符结尾,会自动添加分隔符。\n * @private\n */\n private _removeRetainedEvents(prefix?: string) {\n if (!prefix) this._retainedEvents.clear()\n if(prefix?.endsWith(this._delimiter)){\n prefix+=this._delimiter\n } \n this._retainedEvents.delete(prefix!)\n for(let key of this._retainedEvents.keys()){\n if(key.startsWith(prefix!)){\n this._retainedEvents.delete(key)\n }\n }\n } \n clear(){\n this.offAll()\n }\n private _getMeta(extra:Record<string,any>){\n if(!this._options.meta) return extra\n return Object.assign({},this._options.meta,extra) as FastEventMeta<any,any> \n }\n private _emitForLastEvent(type:string){ \n if(this._retainedEvents.has(type)){\n const payload = this._retainedEvents.get(type)\n const parts = type.split(this._delimiter); \n this._traverseToPath(this.listeners,parts,(node)=>{ \n this._executeListeners(node,payload,this._getMeta({type}))\n }) \n // onAny侦听器保存在根节点中,所以需要执行\n this._executeListeners(this.listeners,payload,this._getMeta({type}))\n } \n }\n\n /**\n * 遍历监听器节点树\n * @param node 当前遍历的监听器节点\n * @param parts 事件名称按'.'分割的部分数组\n * @param callback 遍历到目标节点时的回调函数\n * @param index 当前遍历的parts数组索引,默认为0\n * @param lastFollowing 当命中**时该值为true, 注意**只能作在路径的最后面,如a.**有效,而a.**.b无效\n * @private\n * \n * 支持三种匹配模式:\n * - 精确匹配: 'a.b.c'\n * - 单层通配: 'a.*.c' \n * - 多层通配: 'a.**'\n */\n private _traverseToPath(node: FastListenerNode, parts: string[], callback: (node: FastListenerNode) => void, index: number = 0, lastFollowing?:boolean): void {\n\n if (index >= parts.length) {\n callback(node)\n return\n } \n const part = parts[index] \n\n if(lastFollowing===true){\n this._traverseToPath(node, parts, callback, index + 1,true)\n return\n }\n\n if (part in node) {\n this._traverseToPath(node[part], parts, callback, index + 1)\n }\n\n if ('*' in node) {\n this._traverseToPath(node['*'], parts, callback, index + 1)\n }\n // \n if ('**' in node) {\n this._traverseToPath(node['**'], parts, callback, index + 1,true)\n }\n }\n\n private _traverseListeners(node: FastListenerNode, entry:string[], callback: (path:string[],node: FastListenerNode) => void): void {\n let entryNode: FastListenerNode = node\n // 如果指定了entry路径,则按照路径遍历\n if (entry && entry.length > 0) { \n this._traverseToPath(node, entry,(node)=>{\n entryNode= node\n });\n }\n const traverseNodes = (node: FastListenerNode, callback: (path:string[],node: FastListenerNode) => void,parentPath:string[])=>{\n callback(parentPath, node); \n for(let [key,childNode] of Object.entries(node)){\n if(key.startsWith(\"__\")) continue\n if(childNode){\n traverseNodes(childNode as FastListenerNode, callback,[...parentPath,key]);\n }\n }\n }\n // 如果没有指定entry或entry为空数组,则递归遍历所有节点\n traverseNodes(entryNode, callback,[]);\n } \n\n private _executeListener(listener:any, payload: any,meta: FastEventMeta<any,any> ):any{\n try{\n if(typeof(listener.__wrappedListener)==='function'){\n return listener.__wrappedListener.call(this._context,payload,meta)\n }else{\n return listener.call(this._context,payload,meta)\n }\n }catch(e:any){\n e._trigger = meta.type\n if(typeof(this._options.onListenerError)==='function'){\n this._options.onListenerError.call(this,meta.type,e)\n }\n // 如果忽略错误,则返回错误对象\n if(this._options.ignoreErrors){\n return e\n }else{\n throw e\n }\n }\n }\n\n /**\n * 执行监听器节点中的所有监听函数\n * @param node - FastListenerNode类型的监听器节点\n * @param payload - 事件携带的数据\n * @param type - 事件类型\n * @returns 返回所有监听函数的执行结果数组\n * @private\n * \n * @description\n * 遍历执行节点中的所有监听函数:\n * - 对于普通监听器,直接执行并收集结果\n * - 对于带次数限制的监听器(数组形式),执行后递减次数,当次数为0时移除该监听器\n */\n private _executeListeners(node: FastListenerNode, payload: any, meta: Meta): any[] {\n if (!node || !node.__listeners) return []\n let i = 0\n const listeners = node.__listeners\n let result:any[] = []\n while(i<listeners.length){\n const listener = listeners[i]\n if(Array.isArray(listener)){\n result.push(this._executeListener(listener[0],payload,meta)) \n listener[1]-- \n if(listener[1]===0) {\n listeners.splice(i,1)\n i-- // 抵消后面的i++\n }\n }else{\n result.push(this._executeListener(listener,payload,meta)) \n } \n i++ \n }\n return result\n }\n\n public emit<R=any>(type:string,payload?:any,retain?:boolean,meta?:Meta):R[]\n public emit<R=any>(type:Types,payload?:Events[Types],retain?:boolean,meta?:Meta):R[]\n public emit<R=any>():R[]{\n const type = arguments[0] as string\n const payload = arguments[1] as any\n const retain = arguments[2] as boolean\n const meta = (arguments[3] || {}) as Meta\n\n const parts = type.split(this._delimiter); \n if(retain) {\n this._retainedEvents.set(type,payload)\n } \n const results:any[] = []\n this._traverseToPath(this.listeners,parts,(node)=>{ \n results.push(...this._executeListeners(node,payload,this._getMeta({...meta,type})))\n }) \n // onAny侦听器保存在根节点中,所以需要执行 \n results.push(...this._executeListeners(this.listeners,payload,this._getMeta({...meta,type})))\n return results\n }\n\n public async emitAsync<R=any>(type:string,payload?:any,retain?:boolean,meta?:Meta):Promise<[R|Error][]>\n public async emitAsync<R=any>(type:Types,payload?:Events[Types],retain?:boolean,meta?:Meta):Promise<[R|Error][]>\n public async emitAsync<P=any>():Promise<[P|Error][]>{\n const type = arguments[0] as string\n const payload = arguments[1] as any\n const retain = arguments[2] as boolean\n const meta = (arguments[3] || {}) as Meta\n\n const results = await Promise.allSettled(this.emit<P>(type,payload,retain,this._getMeta({...meta,type})))\n return results.map((result)=>{\n if(result.status==='fulfilled'){\n return result.value\n }else{\n return result.reason\n }\n })\n }\n\n /**\n * 等待指定事件发生\n * \n * @param type \n * @param timeout 超时时间,单位毫秒,默认为 0,表示无限等待\n */\n public waitFor<R=any>(type:string,timeout?:number):Promise<R>\n public waitFor<R=any>(type:Types,timeout?:number):Promise<R>\n public waitFor<R=any>():Promise<R>{\n const type = arguments[0] as string\n const timeout = arguments[1] as number\n return new Promise<R>((resolve,reject)=>{\n let tid:any\n let subscriber:FastEventSubscriber\n const listener = (payload:any)=>{\n clearTimeout(tid)\n subscriber.off() \n resolve(payload) \n }\n if(timeout && timeout>0){\n tid = setTimeout(()=>{\n subscriber && subscriber.off()\n reject(new Error('wait for event<'+ type +'> is timeout'))\n },timeout)\n }\n subscriber = this.on(type,listener) \n }) \n }\n\n /**\n * 创建事件域\n * \n * 注意:\n * \n * 事件域与当前事件对象共享相同的侦听器表\n * 也就是说,如果在事件域中触发事件,当前事件对象也会触发该事件\n * 两者工不是完全隔离的,仅是事件侦听和触发时的事件类型不同而已\n * \n * const emitter = new FastEvent()\n * \n * const scope= emitter.scope(\"a/b\")\n * \n * scope.on(\"x\",()=>{}) == emitter.on(\"a/b/x\",()=>{})\n * scope.emit(\"x\",1) == emitter.emit(\"a/b/x\",1) \n * scope.offAll() == emitter.offAll(\"a/b\")\n * \n */\n scope<T extends string>(prefix:T){ \n return new FastEventScope<ScopeEvents<Events,T>>(this as unknown as FastEvent<ScopeEvents<Events,T>>,prefix)\n }\n\n} "]}
package/package.json CHANGED
@@ -1,17 +1,39 @@
1
1
  {
2
2
  "name": "fastevent",
3
- "version": "0.0.1",
3
+ "version": "1.0.0",
4
4
  "description": "fast event emitter",
5
- "main": "index.js",
6
- "private":false,
7
- "access":"public",
8
- "scripts": {
9
- "test": "echo \"Error: no test specified\" && exit 1"
5
+ "main": "dist/index.js",
6
+ "module": "dist/index.mjs",
7
+ "private": false,
8
+ "access": "public",
9
+ "homepage": "https://github.com/zhangfisher/fastevent.git",
10
+ "repository": {
11
+ "type": "git",
12
+ "url": "git+https://github.com/zhangfisher/fastevent.git"
13
+ },
14
+ "keywords": [
15
+ "eventemitter"
16
+ ],
17
+ "author": "zhangfisher",
18
+ "license": "MIT",
19
+ "devDependencies": {
20
+ "@changesets/cli": "^2.28.1",
21
+ "@swc/core": "^1.11.16",
22
+ "@type-challenges/utils": "^0.1.1",
23
+ "@vitest/coverage-v8": "3.1.1",
24
+ "eventemitter2": "^6.4.9",
25
+ "tinybench": "^4.0.1",
26
+ "tsup": "^8.4.0",
27
+ "tsx": "^4.19.3",
28
+ "typescript": "^5.8.2",
29
+ "vitest": "^3.1.1"
10
30
  },
11
- "keywords": [],
12
- "author": "",
13
- "license": "ISC",
14
- "dependencies": {
15
- "alien-signals": "^1.0.13"
31
+ "scripts": {
32
+ "test": "vitest",
33
+ "test:coverage": "vitest --coverage",
34
+ "build": "tsup",
35
+ "bench": "tsx src/__benchmarks__/index.ts",
36
+ "changeset": "changeset",
37
+ "release": "pnpm build && changeset version && changeset publish"
16
38
  }
17
- }
39
+ }
package/readme.md ADDED
@@ -0,0 +1,282 @@
1
+ # FastEvent
2
+
3
+ FastEvent 是一个功能强大的`TypeScript`事件管理库,提供了灵活的事件订阅和发布机制,支持事件通配符、作用域、异步事件等特性。
4
+
5
+ 对比`EventEmitter2`,`FastEvent`具有以下优势:
6
+
7
+ - 在含通配符发布与订阅时,`FastEvent`的性能比`EventEmitter2`高 `1+`倍左右。
8
+ - `FastEvent`包大小为 `6.3xkb`,而`EventEmitter2`为 `43.4kb`。
9
+ - `FastEvent`拥有更丰富的功能。
10
+
11
+ # 安装
12
+
13
+ 使用 npm 安装:
14
+
15
+ ```bash
16
+ npm install fastevent
17
+ ```
18
+
19
+ 或使用 yarn:
20
+
21
+ ```bash
22
+ yarn add fastevent
23
+ ```
24
+
25
+ # 快速入门
26
+
27
+ ## 基本使用
28
+
29
+ ```typescript
30
+ import { FastEvent } from 'fastevent';
31
+
32
+ // 创建事件实例
33
+ const events = new FastEvent();
34
+
35
+ // 订阅事件
36
+ events.on('user/login', (user) => {
37
+ console.log('用户登录:', user);
38
+ });
39
+
40
+ // 发布事件
41
+ events.emit('user/login', { id: 1, name: 'Alice' });
42
+ ```
43
+
44
+ # 指南
45
+
46
+ ## 事件通配符
47
+
48
+ FastEvent 支持两种通配符:
49
+ - `*`: 匹配单层路径
50
+ - `**`: 匹配多层路径
51
+
52
+ ```typescript
53
+ const events = new FastEvent();
54
+
55
+ // 匹配 user/*/login
56
+ events.on('user/*/login', (data) => {
57
+ console.log('任何用户类型的登录:', data);
58
+ });
59
+
60
+ // 匹配 user 下的所有事件
61
+ events.on('user/**', (data) => {
62
+ console.log('所有用户相关事件:', data);
63
+ });
64
+
65
+ // 触发事件
66
+ events.emit('user/admin/login', { id: 1 }); // 两个处理器都会被调用
67
+ events.emit('user/admin/profile/update', { name: 'New' }); // 只有 ** 处理器会被调用
68
+ ```
69
+
70
+ ## 事件作用域
71
+
72
+ 作用域允许你在特定的命名空间下处理事件:
73
+
74
+ ```typescript
75
+ const events = new FastEvent();
76
+
77
+ // 创建用户相关的作用域
78
+ const userScope = events.scope('user');
79
+
80
+ // 在作用域中订阅事件
81
+ userScope.on('login', (data) => {
82
+ console.log('用户登录:', data);
83
+ });
84
+
85
+ // 等同于 events.emit('user/login', data)
86
+ userScope.emit('login', { id: 1 });
87
+ ```
88
+
89
+ ## 一次性事件
90
+
91
+ 使用 `once` 订阅只触发一次的事件:
92
+
93
+ ```typescript
94
+ const events = new FastEvent();
95
+
96
+ events.once('startup', () => {
97
+ console.log('应用启动');
98
+ });
99
+
100
+ events.emit('startup'); // 输出: 应用启动
101
+ events.emit('startup'); // 无输出,监听器已被移除
102
+ ```
103
+
104
+ ## 异步事件
105
+
106
+ 支持异步事件处理:
107
+
108
+ ```typescript
109
+ const events = new FastEvent();
110
+
111
+ events.on('data/fetch', async () => {
112
+ const response = await fetch('https://api.example.com/data');
113
+ return await response.json();
114
+ });
115
+
116
+ // 异步发布事件
117
+ const results = await events.emitAsync('data/fetch');
118
+ console.log('所有处理器的结果:', results);
119
+ ```
120
+
121
+ ## 事件等待
122
+
123
+ 使用 `waitFor` 等待特定事件发生:
124
+
125
+ ```typescript
126
+ const events = new FastEvent();
127
+
128
+ async function waitForLogin() {
129
+ try {
130
+ // 等待登录事件,超时时间 5 秒
131
+ const userData = await events.waitFor('user/login', 5000);
132
+ console.log('用户已登录:', userData);
133
+ } catch (error) {
134
+ console.log('登录等待超时');
135
+ }
136
+ }
137
+
138
+ waitForLogin();
139
+ // 稍后触发登录事件
140
+ events.emit('user/login', { id: 1, name: 'Alice' });
141
+ ```
142
+
143
+ ## 保留事件数据
144
+
145
+ 保留最后一次事件数据,新的订阅者会立即收到该数据:
146
+
147
+ ```typescript
148
+ const events = new FastEvent();
149
+
150
+ // 发布事件并保留
151
+ events.emit('config/update', { theme: 'dark' }, true);
152
+
153
+ // 之后的订阅者会立即收到保留的数据
154
+ events.on('config/update', (config) => {
155
+ console.log('配置:', config); // 立即输出: 配置: { theme: 'dark' }
156
+ });
157
+ ```
158
+
159
+ ## 多级事件
160
+
161
+ 支持发布和订阅多级事件。
162
+
163
+ 默认使用 `/` 作为事件路径分隔符,你也可以使用自定义的分隔符:
164
+
165
+ ```typescript
166
+ const events = new FastEvent({
167
+ delimiter: '.'
168
+ });
169
+ ```
170
+
171
+ ## 全局事件监听
172
+
173
+ 使用 `onAny` 监听所有事件:
174
+
175
+ ```typescript
176
+ const events = new FastEvent();
177
+
178
+ events.onAny((data, meta) => {
179
+ console.log(`事件 ${meta.type} 被触发:`, data);
180
+ });
181
+
182
+ events.emit('user/login', { id: 1 }); // 输出: 事件 user/login 被触发: { id: 1 }
183
+ events.emit('system/error', 'Connection failed'); // 输出: 事件 system/error 被触发: Connection failed
184
+ ```
185
+
186
+ ## 元数据(Meta)
187
+
188
+ 元数据是一种为事件提供额外上下文信息的机制。你可以在全局范围内设置元数据,也可以为单个事件添加特定的元数据。
189
+
190
+ ### 全局元数据
191
+
192
+ 在创建 FastEvent 实例时设置全局元数据:
193
+
194
+ ```typescript
195
+ const events = new FastEvent({
196
+ meta: {
197
+ version: '1.0',
198
+ environment: 'production'
199
+ }
200
+ });
201
+
202
+ events.on('user/login', (data, meta) => {
203
+ console.log('事件数据:', data);
204
+ console.log('元数据:', meta); // 包含 type、version 和 environment
205
+ });
206
+ ```
207
+
208
+ ### 事件特定元数据
209
+
210
+ 在发布事件时可以传递额外的元数据,它会与全局元数据合并:
211
+
212
+ ```typescript
213
+ const events = new FastEvent({
214
+ meta: { app: 'MyApp' }
215
+ });
216
+
217
+ // 在发布事件时添加特定的元数据
218
+ events.emit('order/create',
219
+ { orderId: '123' }, // 事件数据
220
+ false, // 不保留
221
+ { timestamp: Date.now() } // 事件特定的元数据
222
+ );
223
+
224
+ // 监听器接收合并后的元数据
225
+ events.on('order/create', (data, meta) => {
226
+ console.log('订单:', data); // { orderId: '123' }
227
+ console.log('元数据:', meta); // { type: 'order/create', app: 'MyApp', timestamp: ... }
228
+ });
229
+ ```
230
+
231
+ ## 错误处理
232
+
233
+ FastEvent 提供了错误处理机制:
234
+
235
+ ```typescript
236
+ const events = new FastEvent({
237
+ ignoreErrors: true, // 默认为 true,不会抛出错误
238
+ onListenerError: (type, error) => {
239
+ console.error(`处理事件 ${type} 时发生错误:`, error);
240
+ }
241
+ });
242
+
243
+ events.on('process', () => {
244
+ throw new Error('处理失败');
245
+ });
246
+
247
+ // 不会抛出错误,而是触发 onListenerError
248
+ events.emit('process');
249
+ ```
250
+
251
+ ## 自定义选项
252
+
253
+ FastEvent 构造函数支持多个选项:
254
+
255
+ ```typescript
256
+ const events = new FastEvent({
257
+ // 事件路径分隔符,默认为 '/'
258
+ delimiter: '.',
259
+ // 事件处理器的上下文
260
+ context: null,
261
+ // 元数据,会传递给所有事件处理器
262
+ meta: { version: '1.0' },
263
+
264
+ // 错误处理
265
+ ignoreErrors: true,
266
+ onListenerError: (type, error) => {
267
+ console.error(`事件错误:`, type, error);
268
+ },
269
+
270
+ // 监听器添加/移除的回调
271
+ onAddListener: (path, listener) => {
272
+ console.log('添加监听器:', path);
273
+ },
274
+ onRemoveListener: (path, listener) => {
275
+ console.log('移除监听器:', path);
276
+ }
277
+ });
278
+ ```
279
+
280
+ # 性能
281
+
282
+ ![](./bench.png)
@@ -0,0 +1,3 @@
1
+ import "./sample"
2
+ import "./multi-level"
3
+ import "./wildcard"
@@ -0,0 +1,40 @@
1
+ import { Bench } from 'tinybench';
2
+ import { FastEvent } from '../event';
3
+ import { EventEmitter2 } from 'eventemitter2';
4
+
5
+
6
+ const bench = new Bench({
7
+ time: 1000,
8
+ iterations: 100,
9
+ });
10
+ const fastEmitter = new FastEvent()
11
+ const emitter2 = new EventEmitter2({
12
+ wildcard: true,
13
+ delimiter: '.'
14
+ })
15
+
16
+ bench
17
+ .add('[FastEvent] 多级路径事件的发布与订阅', () => {
18
+ return new Promise<void>((resolve) => {
19
+ const subscriber = fastEmitter.on('a/b/c/d/e/f', () => {
20
+ resolve()
21
+ })
22
+ fastEmitter.emit('a/b/c/d/e/f', 1)
23
+ subscriber.off()
24
+ })
25
+ })
26
+ .add('[EventEmitter2] 多级路径事件的发布与订阅', () => {
27
+ return new Promise<void>((resolve) => {
28
+ const subscriber = emitter2.on('a.b.c.d.e.f', () => {
29
+ resolve()
30
+ },{objectify:true})
31
+ emitter2.emit('a.b.c.d.e.f', 1)
32
+ // @ts-ignore
33
+ subscriber.off()
34
+ })
35
+ }) ;
36
+ //
37
+ (async () => {
38
+ await bench.run();
39
+ console.table(bench.table());
40
+ })();
@@ -0,0 +1,40 @@
1
+ import { Bench } from 'tinybench';
2
+ import { FastEvent } from '../event';
3
+ import { EventEmitter2 } from 'eventemitter2';
4
+
5
+
6
+ const bench = new Bench({
7
+ time: 1000,
8
+ iterations: 100,
9
+ });
10
+ const fastEmitter = new FastEvent()
11
+ const emitter2 = new EventEmitter2({
12
+ wildcard: true,
13
+ delimiter: '.'
14
+ })
15
+
16
+ bench
17
+ .add('[FastEvent] 发布与订阅', () => {
18
+ return new Promise<void>((resolve) => {
19
+ const subscriber= fastEmitter.on('x', () => {
20
+ resolve()
21
+ })
22
+ fastEmitter.emit('x', 1)
23
+ subscriber.off()
24
+ })
25
+ })
26
+ .add('[EventEmitter2] 发布与订阅', () => {
27
+ return new Promise<void>((resolve) => {
28
+ const subscriber= emitter2.on('x', () => {
29
+ resolve()
30
+ })
31
+ emitter2.emit('x', 1)
32
+ // @ts-ignore
33
+ subscriber.off()
34
+ })
35
+ }) ;
36
+ //
37
+ (async () => {
38
+ await bench.run();
39
+ console.table(bench.table());
40
+ })();
@@ -0,0 +1,41 @@
1
+ import { Bench } from 'tinybench';
2
+ import { FastEvent } from '../event';
3
+ import { EventEmitter2 } from 'eventemitter2';
4
+
5
+ const bench = new Bench({
6
+ time: 2000,
7
+ iterations: 200,
8
+ });
9
+ const fastEmitter = new FastEvent()
10
+ const emitter2 = new EventEmitter2({
11
+ wildcard: true,
12
+ delimiter: '.'
13
+ })
14
+
15
+
16
+
17
+ bench
18
+ .add('[FastEvent] 通配符发布与订阅', () => {
19
+ return new Promise<void>((resolve) => {
20
+ const subscriber= fastEmitter.on('a/b/c/*', () => {
21
+ resolve()
22
+ })
23
+ fastEmitter.emit('a/b/c/x', 1)
24
+ subscriber.off()
25
+ })
26
+ })
27
+ .add('[EventEmitter2] 通配符发布与订阅', () => {
28
+ return new Promise<void>((resolve) => {
29
+ const subscriber = emitter2.on('a.b.c.*', () => {
30
+ resolve()
31
+ },{objectify:true})
32
+ emitter2.emit('a.b.c.x', 1)
33
+ // @ts-ignore
34
+ subscriber.off()
35
+ })
36
+ });
37
+ //
38
+ (async () => {
39
+ await bench.run();
40
+ console.table(bench.table());
41
+ })();
@@ -0,0 +1,81 @@
1
+ import { describe, test, expect } from "vitest"
2
+ import { FastEvent } from "../event"
3
+
4
+ describe("简单发布与订阅",async ()=>{
5
+ test("简单发布订阅事件",()=>{
6
+ const emitter = new FastEvent()
7
+ emitter.on("x",(payload,{type})=>{
8
+ expect(type).toBe("x")
9
+ expect(payload).toBe(1)
10
+ })
11
+ emitter.emit("x",1)
12
+ })
13
+ test("简单发布订阅事件后取消",()=>{
14
+ const emitter = new FastEvent()
15
+ const events:string[]=[]
16
+ const subscriber = emitter.on("x",(payload,{type})=>{
17
+ expect(type).toBe("x")
18
+ expect(payload).toBe(1)
19
+ events.push(type)
20
+ })
21
+ emitter.emit("x",1)
22
+ expect(events).toEqual(["x"])
23
+ subscriber.off()
24
+ emitter.emit("x",1)
25
+ emitter.emit("x",1)
26
+ emitter.emit("x",1)
27
+ expect(events).toEqual(["x"])
28
+ })
29
+ test("发布订阅层级事件",()=>{
30
+ const emitter = new FastEvent()
31
+ const events:string[]=[]
32
+ emitter.on("a.b.c",(payload,{type})=>{
33
+ expect(type).toBe("a.b.c")
34
+ expect(payload).toBe(1)
35
+ events.push(type)
36
+ })
37
+ emitter.emit("a",1)
38
+ emitter.emit("a.b",1)
39
+ emitter.emit("a.b.c",1)
40
+ expect(events).toEqual(["a.b.c"])
41
+ })
42
+ test("返回事件执行结果",()=>{
43
+ const emitter = new FastEvent()
44
+ for(let i=1;i<=10;i++){
45
+ emitter.on("x",()=>{
46
+ return i
47
+ })
48
+ }
49
+ const results = emitter.emit("x",1)
50
+ expect(results).toEqual([1,2,3,4,5,6,7,8,9,10])
51
+ })
52
+ test("侦听器执行出错返回事件执行结果",async ()=>{
53
+ const emitter = new FastEvent()
54
+ for(let i=1;i<=10;i++){
55
+ emitter.on("x",()=>{
56
+ if(i % 2 ==0) throw new Error("custom")
57
+ return i
58
+ })
59
+ }
60
+ const results = emitter.emit("x",1)
61
+ for(let i=1;i<=10;i++){
62
+ if(i % 2 ==0) expect(results[i-1]).toBeInstanceOf(Error)
63
+ else expect(results[i-1]).toBe(i)
64
+ }
65
+ })
66
+ test("侦听器执行出错时emit出错",async ()=>{
67
+ const emitter = new FastEvent({ignoreErrors:false})
68
+ const err = new Error("custom")
69
+ for(let i=1;i<=10;i++){
70
+ emitter.on("x",()=>{
71
+ if(i % 2 ==0) throw err
72
+ return i
73
+ })
74
+ }
75
+ expect(()=>emitter.emit("x",1)).toThrow(err);
76
+ // @ts-ignore, 当执行侦听器出错时会在错误对象上挂载一个_listener属性代表当前执行的侦听器路径
77
+ expect(err._trigger).toBe("x")
78
+
79
+ })
80
+ })
81
+