js-use-core/dist/core.js

JavaScript Comprehensive tool library, including full screen, copy and paste functions

class EventEmitter{constructor(){this.events=new Map,this.maxListeners=10}on(e,t,r){if("function"!=typeof t)throw new Error("Listener must be a function");const s={listener:t,once:r?.once||!1,priority:r?.priority||0};this.events.has(e)||this.events.set(e,[]);const i=this.events.get(e);i.length,this.maxListeners;let n=!1;for(let e=0;e<i.length;e++)if(s.priority>(i[e].priority||0)){i.splice(e,0,s),n=!0;break}return n||i.push(s),this}once(e,t,r){return this.on(e,t,{once:!0,priority:r})}off(e,t){if(!this.events.has(e))return this;const r=this.events.get(e);if(t){const s=r.findIndex(e=>e.listener===t);-1!==s&&(r.splice(s,1),0===r.length&&this.events.delete(e))}else this.events.delete(e);return this}emit(e,...t){if(!this.events.has(e))return!1;const r=this.events.get(e).slice(),s=[];for(const e of r)try{e.listener.apply(this,t),e.once&&s.push(e)}catch(e){}if(s.length>0){const t=this.events.get(e);if(t){for(const e of s){const r=t.indexOf(e);-1!==r&&t.splice(r,1)}0===t.length&&this.events.delete(e)}}return!0}listenerCount(e){return this.events.get(e)?.length||0}listeners(e){return this.events.get(e)?.map(e=>e.listener)||[]}eventNames(){return Array.from(this.events.keys())}removeAllListeners(e){return e?this.events.delete(e):this.events.clear(),this}setMaxListeners(e){if(e<0||!Number.isInteger(e))throw new Error("Max listeners must be a non-negative integer");return this.maxListeners=e,this}getMaxListeners(){return this.maxListeners}prependListener(e,t){return this.on(e,t,{priority:Number.MAX_SAFE_INTEGER})}prependOnceListener(e,t){return this.once(e,t,Number.MAX_SAFE_INTEGER)}}var e,t,r,s;!function(e){e.USER_ERROR="USER_ERROR",e.SYSTEM_ERROR="SYSTEM_ERROR",e.NETWORK_ERROR="NETWORK_ERROR",e.PERMISSION_ERROR="PERMISSION_ERROR",e.CONFIG_ERROR="CONFIG_ERROR",e.VALIDATION_ERROR="VALIDATION_ERROR",e.TIMEOUT_ERROR="TIMEOUT_ERROR",e.UNSUPPORTED_ERROR="UNSUPPORTED_ERROR",e.INTERNAL_ERROR="INTERNAL_ERROR",e.EXTERNAL_ERROR="EXTERNAL_ERROR",e.UNKNOWN_ERROR="UNKNOWN_ERROR"}(e||(e={})),function(e){e.LOW="low",e.MEDIUM="medium",e.HIGH="high",e.CRITICAL="critical"}(t||(t={})),function(e){e.USER_ERROR="USER_ERROR",e.SYSTEM_ERROR="SYSTEM_ERROR",e.NETWORK_ERROR="NETWORK_ERROR",e.PERMISSION_ERROR="PERMISSION_ERROR",e.CONFIG_ERROR="CONFIG_ERROR",e.TIMEOUT_ERROR="TIMEOUT_ERROR",e.VALIDATION_ERROR="VALIDATION_ERROR",e.INTERNAL_ERROR="INTERNAL_ERROR",e.UNKNOWN_ERROR="UNKNOWN_ERROR"}(r||(r={})),function(e){e[e.DEBUG=0]="DEBUG",e[e.INFO=1]="INFO",e[e.WARN=2]="WARN",e[e.ERROR=3]="ERROR"}(s||(s={}));class Logger{constructor(e="Core",t){this.level=s.INFO,this.logs=[],this.maxLogs=1e3,this.enableConsole=!0,this.module=e,t&&(this.level=t.level??s.INFO,this.maxLogs=t.maxLogs??1e3,this.enableConsole=t.enableConsole??!0)}setLevel(e){this.level=e}getLevel(){return this.level}debug(e,t){this.log(s.DEBUG,e,t)}info(e,t){this.log(s.INFO,e,t)}warn(e,t){this.log(s.WARN,e,t)}error(e,t){this.log(s.ERROR,e,t)}log(e,t,r){if(e<this.level)return;const s={level:e,message:t,timestamp:Date.now(),module:this.module,data:r};this.logs.push(s),this.logs.length>this.maxLogs&&this.logs.shift(),this.enableConsole&&this.outputToConsole(s)}outputToConsole(e){new Date(e.timestamp).toISOString(),s[e.level],e.module,e.message,void 0!==e.data&&e.data;switch(e.level){case s.DEBUG:case s.INFO:case s.WARN:case s.ERROR:}}getLogs(){return[...this.logs]}getLogsByLevel(e){return this.logs.filter(t=>t.level===e)}getLogsByTimeRange(e,t){return this.logs.filter(r=>r.timestamp>=e&&r.timestamp<=t)}clear(){this.logs=[]}setMaxLogs(e){if(e<0)throw new Error("Max logs must be non-negative");this.maxLogs=e,this.logs.length>e&&(this.logs=this.logs.slice(-e))}setConsoleOutput(e){this.enableConsole=e}exportLogs(){return JSON.stringify(this.logs,null,2)}importLogs(e){try{const t=JSON.parse(e);Array.isArray(t)&&(this.logs=t.filter(e=>e&&"number"==typeof e.level&&"string"==typeof e.message&&"number"==typeof e.timestamp))}catch(e){this.error("Failed to import logs",e)}}createChild(e){return new Logger(`${this.module}.${e}`,{level:this.level,maxLogs:this.maxLogs,enableConsole:this.enableConsole})}}class i extends Error{constructor(e,t,r){super(t),this.name="CustomError",this.type=e,this.code=r?.code,this.context=r?.context,this.recoverable=r?.recoverable??!1,r?.cause&&(this.cause=r.cause),Error.captureStackTrace&&Error.captureStackTrace(this,i)}}class ErrorHandler{constructor(e){this.errorSolutions=new Map,this.logger=e||new Logger("ErrorHandler"),this.initializeErrorSolutions()}handleError(e,t){const r=this.classifyError(e),s={module:"Unknown",method:"Unknown",timestamp:Date.now(),userAgent:"undefined"!=typeof navigator?navigator.userAgent:"Node.js",...t},i={type:r,severity:this.getErrorSeverity(r),message:e.message,userMessage:this.getUserFriendlyMessage(e,r),originalError:e,context:s,code:this.getErrorCode(e)||this.generateErrorCode(r),recoverable:this.isRecoverableError(e),solutions:this.getErrorSolutions(e),id:this.generateErrorId(),processedAt:Date.now(),relatedErrors:[]};return this.logger.error(`[${r}] ${i.message}`,{error:e.message,stack:e.stack,context:s,recoverable:i.recoverable}),i}createError(e,t,r){const s={module:"Unknown",method:"Unknown",timestamp:Date.now(),userAgent:"undefined"!=typeof navigator?navigator.userAgent:"Node.js",...r?.context};return new i(e,t,{code:r?.code,context:s,recoverable:r?.recoverable,cause:r?.cause})}isRecoverableError(t){if(t instanceof i)return t.recoverable;switch(this.classifyError(t)){case e.NETWORK_ERROR:case e.TIMEOUT_ERROR:return!0;case e.PERMISSION_ERROR:case e.SYSTEM_ERROR:return!1;case e.USER_ERROR:case e.CONFIG_ERROR:return!0;default:return!1}}getErrorSolution(e){const t=this.getErrorCode(e);if(t&&this.errorSolutions.has(t))return this.errorSolutions.get(t);const r=this.classifyError(e);return this.getDefaultSolution(r)}getErrorSolutions(e){const t=this.getErrorSolution(e);return t?[{description:t,steps:[t],automatic:!1,priority:1}]:[]}getErrorSeverity(r){switch(r){case e.USER_ERROR:case e.CONFIG_ERROR:return t.LOW;case e.NETWORK_ERROR:case e.TIMEOUT_ERROR:return t.MEDIUM;case e.PERMISSION_ERROR:case e.VALIDATION_ERROR:return t.HIGH;case e.SYSTEM_ERROR:case e.INTERNAL_ERROR:return t.CRITICAL;default:return t.MEDIUM}}generateErrorCode(e){return`${e}_${Date.now().toString(36)}_${Math.random().toString(36).substr(2,5)}`.toUpperCase()}generateErrorId(){return`error_${Date.now()}_${Math.random().toString(36).substr(2,9)}`}addErrorSolution(e,t){this.errorSolutions.set(e,t)}addErrorSolutions(e){for(const[t,r]of Object.entries(e))this.errorSolutions.set(t,r)}classifyError(t){if(t instanceof i)return t.type;const r=(t.message||"").toLowerCase(),s=(t.name||"").toLowerCase();return r.includes("network")||r.includes("fetch")||r.includes("xhr")||s.includes("networkerror")?e.NETWORK_ERROR:r.includes("timeout")||r.includes("timed out")||s.includes("timeouterror")?e.TIMEOUT_ERROR:r.includes("permission")||r.includes("denied")||r.includes("unauthorized")||r.includes("forbidden")||s.includes("notallowederror")?e.PERMISSION_ERROR:r.includes("not supported")||r.includes("not available")||r.includes("not implemented")||s.includes("notsupportederror")?e.SYSTEM_ERROR:r.includes("invalid")||r.includes("configuration")||r.includes("config")||s.includes("configerror")?e.CONFIG_ERROR:t instanceof TypeError||t instanceof RangeError||r.includes("invalid argument")||r.includes("invalid parameter")?e.USER_ERROR:e.UNKNOWN_ERROR}getUserFriendlyMessage(t,r){switch(r){case e.NETWORK_ERROR:return"网络连接失败，请检查网络连接后重试";case e.TIMEOUT_ERROR:return"操作超时，请稍后重试";case e.PERMISSION_ERROR:return"权限不足，请检查浏览器权限设置";case e.SYSTEM_ERROR:return"当前浏览器不支持此功能，请使用其他浏览器或升级浏览器版本";case e.CONFIG_ERROR:return"配置参数错误，请检查配置";case e.USER_ERROR:return"输入参数错误，请检查输入参数";default:return t.message||"发生未知错误"}}getErrorCode(e){if(e instanceof i)return e.code;const t=e;return t.code||t.errno||void 0}getDefaultSolution(t){switch(t){case e.NETWORK_ERROR:return"请检查网络连接，确保网络正常后重试";case e.TIMEOUT_ERROR:return"请稍后重试，或增加超时时间设置";case e.PERMISSION_ERROR:return"请在浏览器设置中允许相关权限，或使用HTTPS协议";case e.SYSTEM_ERROR:return"请使用支持此功能的现代浏览器，或升级浏览器版本";case e.CONFIG_ERROR:return"请检查配置参数是否正确，参考文档进行配置";case e.USER_ERROR:return"请检查输入参数的类型和格式是否正确";default:return null}}initializeErrorSolutions(){this.errorSolutions.set("ENOTFOUND","域名解析失败，请检查网络连接"),this.errorSolutions.set("ECONNREFUSED","连接被拒绝，请检查服务器状态"),this.errorSolutions.set("ETIMEDOUT","连接超时，请检查网络连接或稍后重试"),this.errorSolutions.set("CERT_UNTRUSTED","SSL证书不受信任，请检查证书配置"),this.errorSolutions.set("MIXED_CONTENT","混合内容错误，请使用HTTPS协议")}}class Cache{constructor(e){this.cache=new Map,this.config={maxSize:e?.maxSize??100,defaultTTL:e?.defaultTTL??3e5,enableLRU:e?.enableLRU??!0,cleanupInterval:e?.cleanupInterval??6e4},this.startCleanup()}set(e,t,r){const s=Date.now(),i={value:t,expireAt:s+(r??this.config.defaultTTL),createdAt:s,accessCount:0,lastAccessed:s};this.cache.size>=this.config.maxSize&&!this.cache.has(e)&&this.evictLRU(),this.cache.set(e,i)}get(e){const t=this.cache.get(e);if(!t)return;const r=Date.now();if(!(r>t.expireAt))return t.accessCount++,t.lastAccessed=r,t.value;this.cache.delete(e)}has(e){const t=this.cache.get(e);return!!t&&(!(Date.now()>t.expireAt)||(this.cache.delete(e),!1))}delete(e){return this.cache.delete(e)}clear(){this.cache.clear()}size(){return this.cache.size}keys(){return Array.from(this.cache.keys())}getInfo(e){const t=this.cache.get(e);if(t){if(!(Date.now()>t.expireAt))return{...t};this.cache.delete(e)}}touch(e,t){const r=this.cache.get(e);if(!r)return!1;const s=Date.now();if(s>r.expireAt)return this.cache.delete(e),!1;const i=t??this.config.defaultTTL;return r.expireAt=s+i,r.lastAccessed=s,!0}async getOrSet(e,t,r){const s=this.get(e);if(void 0!==s)return s;const i=await t();return this.set(e,i,r),i}mset(e,t){for(const[r,s]of e)this.set(r,s,t)}mget(e){return e.map(e=>this.get(e))}mdel(e){let t=0;for(const r of e)this.delete(r)&&t++;return t}getStats(){let e=0,t=0;const r=Date.now();for(const[s,i]of this.cache.entries())e+=i.accessCount,r>i.expireAt&&t++;return{size:this.cache.size,maxSize:this.config.maxSize,hitRate:e>0?(e-t)/e:0,totalAccess:e,expiredCount:t}}cleanup(){const e=Date.now();let t=0;for(const[r,s]of this.cache.entries())e>s.expireAt&&(this.cache.delete(r),t++);return t}evictLRU(){if(!this.config.enableLRU||0===this.cache.size)return;let e=null,t=1/0;for(const[r,s]of this.cache.entries())s.lastAccessed<t&&(t=s.lastAccessed,e=r);e&&this.cache.delete(e)}startCleanup(){this.cleanupTimer&&clearInterval(this.cleanupTimer),this.cleanupTimer=setInterval(()=>{this.cleanup()},this.config.cleanupInterval)}stopCleanup(){this.cleanupTimer&&(clearInterval(this.cleanupTimer),this.cleanupTimer=void 0)}updateConfig(e){if(this.config={...this.config,...e},void 0!==e.cleanupInterval&&this.startCleanup(),void 0!==e.maxSize&&this.cache.size>e.maxSize)for(;this.cache.size>e.maxSize;)this.evictLRU()}destroy(){this.stopCleanup(),this.clear()}}class BaseManager{constructor(e,t="BaseManager"){this.initialized=!1,this.destroyed=!1,this.initializing=!1,this.options=this.mergeDefaultOptions(e),this.logger=new Logger(t,{level:this.options.debug?0:1,enableConsole:this.options.debug}),this.eventEmitter=new EventEmitter,this.errorHandler=new ErrorHandler(this.logger),this.options.cache&&(this.cache=new Cache),this.setupErrorHandling(),this.startAutoInitialization()}on(e,t,r){return this.eventEmitter.on(e,t,r),this}off(e,t){return this.eventEmitter.off(e,t),this}emit(e,...t){return this.eventEmitter.emit(e,...t)}once(e,t,r){return this.eventEmitter.once(e,t,r),this}listenerCount(e){return this.eventEmitter.listenerCount(e)}eventNames(){return this.eventEmitter.eventNames()}handleError(e,t){const r={module:this.constructor.name,method:t},s=this.errorHandler.handleError(e,r);return this.emit("error",s),s}validateInput(e,t){try{if(t.type){const r=typeof e;if(r!==t.type)throw this.errorHandler.createError("USER_ERROR",`Expected ${t.type}, got ${r}`,{context:{method:"validateInput"}})}if(t.required&&null==e)throw this.errorHandler.createError("USER_ERROR","Required parameter is missing",{context:{method:"validateInput"}});if(t.isArray&&!Array.isArray(e))throw this.errorHandler.createError("USER_ERROR","Expected array",{context:{method:"validateInput"}});if(t.properties&&"object"==typeof e&&null!==e)for(const[r,s]of Object.entries(t.properties))if(!this.validateInput(e[r],s))return!1;return!0}catch(e){return this.handleError(e,"validateInput"),!1}}async safeExecute(e,t,r){const s=r??this.options.retries??0;let i=null;for(let r=0;r<=s;r++)try{const s=new Promise((e,r)=>{setTimeout(()=>{r(this.errorHandler.createError("TIMEOUT_ERROR",`Operation timed out after ${this.options.timeout}ms`,{context:{method:t}}))},this.options.timeout)}),i=await Promise.race([e(),s]);return r>0&&this.logger.info(`Operation succeeded after ${r} retries`,{context:t}),i}catch(e){if(i=e,r===s||!this.errorHandler.isRecoverableError(i))throw this.handleError(i,t);const n=Math.min(1e3*Math.pow(2,r),5e3);this.logger.warn(`Operation failed, retrying in ${n}ms (attempt ${r+1}/${s+1})`,{context:t,error:i.message}),await new Promise(e=>setTimeout(e,n))}throw this.handleError(i,t)}getCached(e){return this.cache?.get(e)}setCached(e,t,r){this.cache?.set(e,t,r)}async getOrSetCached(e,t,r){return this.cache?this.cache.getOrSet(e,t,r):t()}async ensureInitialized(){if(this.destroyed)throw this.errorHandler.createError("SYSTEM_ERROR","Manager has been destroyed and cannot be used.",{context:{method:"ensureInitialized"}});if(!this.initialized)if(this.initPromise)try{await this.initPromise,this.initPromise=void 0}catch(e){throw this.errorHandler.createError("SYSTEM_ERROR",`Manager initialization failed: ${e.message}`,{context:{method:"ensureInitialized"}})}else if(!this.initializing){this.initializing=!0;try{await this.initialize()}finally{this.initializing=!1}}}ensureInitializedSync(){if(!this.initialized)throw this.errorHandler.createError("SYSTEM_ERROR","Manager not initialized. Operations requiring initialization should be awaited.",{context:{method:"ensureInitializedSync"}})}ensureNotDestroyed(){if(this.destroyed)throw this.errorHandler.createError("SYSTEM_ERROR","Manager has been destroyed and cannot be used.",{context:{method:"ensureNotDestroyed"}})}async ready(){await this.ensureInitialized()}getStatus(){return{initialized:this.initialized,destroyed:this.destroyed,eventListeners:this.eventNames().reduce((e,t)=>e+this.listenerCount(t),0),cacheSize:this.cache?.size(),initializing:this.initializing||!!this.initPromise}}updateOptions(e){this.options={...this.options,...e},void 0!==e.debug&&(this.logger.setLevel(e.debug?0:1),this.logger.setConsoleOutput(e.debug)),this.emit("optionsUpdated",this.options)}mergeDefaultOptions(e){return{...this.getDefaultOptions(),...e}}setupErrorHandling(){"undefined"!=typeof window?window.addEventListener("unhandledrejection",e=>{this.handleError(new Error(e.reason),"unhandledrejection")}):"undefined"!=typeof process&&process.on("unhandledRejection",e=>{this.handleError(new Error(String(e)),"unhandledRejection")})}startAutoInitialization(){this.initPromise=this.initialize().catch(e=>(this.logger.error("Auto-initialization failed:",e),Promise.reject(e))),this.initPromise.catch(()=>{})}baseDestroy(){this.destroyed||(this.emit("beforeDestroy"),this.eventEmitter.removeAllListeners(),this.cache?.destroy(),this.logger.clear(),this.destroyed=!0,this.initialized=!1,this.emit("destroyed"))}}export{BaseManager,Cache,i as CustomError,ErrorHandler,r as ErrorType,EventEmitter,s as LogLevel,Logger};