# nv-error-jserde > nv-error-jserde =============== - error AND json - for compatible with nvlang err-db(which is just a insert-only database to record all errors) Latest version **1.0.1** (published 2022-11-20) · ISC license · 0 weekly downloads ## Install ```sh npm install nv-error-jserde pnpm add nv-error-jserde yarn add nv-error-jserde bun add nv-error-jserde ``` ## Health **Score 15/100 (F)** — status: abandoned. Positive: no vulnerabilities. Warnings: low downloads; no types; no esm support. Negative: abandoned; low maintenance score. ## Facts | | | |---|---| | Version | 1.0.1 | | Published | 2022-11-20 | | First published | 2022-11-20 | | Weekly downloads | 0 | | License | ISC | | TypeScript types | none | | Module format | CommonJS | | Dependencies | 0 | | Unpacked size | 33.5 KB | | Known vulnerabilities | 0 | | Install scripts | no | | Maintainers | ihgazni2 | ## Links - npm: https://www.npmjs.com/package/nv-error-jserde - npm.io page: https://npm.io/package/nv-error-jserde ## Recent versions - 1.0.1 (latest) — 2022-11-20 ## README nv-error-jserde =============== - error AND json - for compatible with nvlang err-db(which is just a insert-only database to record all errors) install ======= - npm install nv-error-jserde usage ===== const {from_json,to_json} = require("nv-error-jserde") example ------- var err = er.creat_er("one-err","unknown"); var erd = er.to_json(err) /* { name: 'Error', message: 'one-err', stack: [ 'Error: one-err', ' at Object.creat_er (/mnt/sda3/NV6-/nverr/nv-error-jserde/cmmn.js:31:43)', ' at REPL3:1:15', ' at Script.runInThisContext (node:vm:129:12)', ' at REPLServer.defaultEval (node:repl:562:29)', ' at bound (node:domain:421:15)', ' at REPLServer.runBound [as eval] (node:domain:432:12)', ' at REPLServer.onLine (node:repl:889:10)', ' at REPLServer.emit (node:events:402:35)', ' at REPLServer.emit (node:domain:475:12)', ' at REPLServer.Interface._onLine (node:readline:487:10)' ], cause: 'unknown' } */ var duped_err = er.from_json(erd) /* > duped_err Error: one-err at Object.creat_er (/mnt/sda3/NV6-/nverr/nv-error-jserde/cmmn.js:31:43) at REPL11:1:15 at Script.runInThisContext (node:vm:129:12) at REPLServer.defaultEval (node:repl:562:29) at bound (node:domain:421:15) at REPLServer.runBound [as eval] (node:domain:432:12) at REPLServer.onLine (node:repl:889:10) at REPLServer.emit (node:events:402:35) at REPLServer.emit (node:domain:475:12) at REPLServer.Interface._onLine (node:readline:487:10) { cause: 'unknown' } */ var cerr = er.creat_er("child-err",err); var cerr2 = er.creat_er("child2-err",cerr); er.get_root_cause(cerr2) /* Error: one-err at Object.creat_er (/mnt/sda3/NV6-/nverr/nv-error-jserde/cmmn.js:31:43) at REPL69:1:15 at Script.runInThisContext (node:vm:129:12) at REPLServer.defaultEval (node:repl:562:29) at bound (node:domain:421:15) at REPLServer.runBound [as eval] (node:domain:432:12) at REPLServer.onLine (node:repl:889:10) at REPLServer.emit (node:events:402:35) at REPLServer.emit (node:domain:475:12) at REPLServer.Interface._onLine (node:readline:487:10) */ var cerr2d = er.to_json(cerr2) /* { name: 'Error', message: 'child2-err', stack: [ 'Error: child2-err', ' at Object.creat_er (/mnt/sda3/NV6-/nverr/nv-error-jserde/cmmn.js:31:43)', ' at REPL8:1:17', ' at Script.runInThisContext (node:vm:129:12)', ' at REPLServer.defaultEval (node:repl:562:29)', ' at bound (node:domain:421:15)', ' at REPLServer.runBound [as eval] (node:domain:432:12)', ' at REPLServer.onLine (node:repl:889:10)', ' at REPLServer.emit (node:events:402:35)', ' at REPLServer.emit (node:domain:475:12)', ' at REPLServer.Interface._onLine (node:readline:487:10)' ], cause: { name: 'Error', message: 'child-err', stack: [ 'Error: child-err', ' at Object.creat_er (/mnt/sda3/NV6-/nverr/nv-error-jserde/cmmn.js:31:43)', ' at REPL7:1:16', ' at Script.runInThisContext (node:vm:129:12)', ' at REPLServer.defaultEval (node:repl:562:29)', ' at bound (node:domain:421:15)', ' at REPLServer.runBound [as eval] (node:domain:432:12)', ' at REPLServer.onLine (node:repl:889:10)', ' at REPLServer.emit (node:events:402:35)', ' at REPLServer.emit (node:domain:475:12)', ' at REPLServer.Interface._onLine (node:readline:487:10)' ], cause: { name: 'Error', message: 'one-err', stack: [Array], cause: 'unknown' } } } */ var duped_cerr2 = er.from_json(cerr2d) /* Error: child2-err at Object.creat_er (/mnt/sda3/NV6-/nverr/nv-error-jserde/cmmn.js:31:43) at REPL8:1:17 at Script.runInThisContext (node:vm:129:12) at REPLServer.defaultEval (node:repl:562:29) at bound (node:domain:421:15) at REPLServer.runBound [as eval] (node:domain:432:12) at REPLServer.onLine (node:repl:889:10) at REPLServer.emit (node:events:402:35) at REPLServer.emit (node:domain:475:12) at REPLServer.Interface._onLine (node:readline:487:10) { cause: Error: child-err at Object.creat_er (/mnt/sda3/NV6-/nverr/nv-error-jserde/cmmn.js:31:43) at REPL7:1:16 at Script.runInThisContext (node:vm:129:12) at REPLServer.defaultEval (node:repl:562:29) at bound (node:domain:421:15) at REPLServer.runBound [as eval] (node:domain:432:12) at REPLServer.onLine (node:repl:889:10) at REPLServer.emit (node:events:402:35) at REPLServer.emit (node:domain:475:12) at REPLServer.Interface._onLine (node:readline:487:10) { cause: Error: one-err at Object.creat_er (/mnt/sda3/NV6-/nverr/nv-error-jserde/cmmn.js:31:43) at REPL3:1:15 at Script.runInThisContext (node:vm:129:12) at REPLServer.defaultEval (node:repl:562:29) at bound (node:domain:421:15) at REPLServer.runBound [as eval] (node:domain:432:12) at REPLServer.onLine (node:repl:889:10) at REPLServer.emit (node:events:402:35) at REPLServer.emit (node:domain:475:12) at REPLServer.Interface._onLine (node:readline:487:10) { cause: 'unknown' } } } */ ### agg err var root_err = er.creat_er("root") var agg_err = er.creat_agger(["e0","e1","e2"],"agg",root_err) /* > agg_err AggregateError: agg at _creat_agger (/mnt/sda3/NV6-/nverr/nv-error-jserde/cmmn.js:38:52) at Object.creat_agger (/mnt/sda3/NV6-/nverr/nv-error-jserde/cmmn.js:39:52) at REPL12:1:18 at Script.runInThisContext (node:vm:129:12) at REPLServer.defaultEval (node:repl:562:29) at bound (node:domain:421:15) at REPLServer.runBound [as eval] (node:domain:432:12) at REPLServer.onLine (node:repl:889:10) at REPLServer.emit (node:events:402:35) at REPLServer.emit (node:domain:475:12) > agg_err.errors [ Error: e0 at creat_er (/mnt/sda3/NV6-/nverr/nv-error-jserde/cmmn.js:31:52) at /mnt/sda3/NV6-/nverr/nv-error-jserde/cmmn.js:39:79 at Array.map () at Object.creat_agger (/mnt/sda3/NV6-/nverr/nv-error-jserde/cmmn.js:39:70) at REPL12:1:18 at Script.runInThisContext (node:vm:129:12) at REPLServer.defaultEval (node:repl:562:29) at bound (node:domain:421:15) at REPLServer.runBound [as eval] (node:domain:432:12) at REPLServer.onLine (node:repl:889:10), Error: e1 at creat_er (/mnt/sda3/NV6-/nverr/nv-error-jserde/cmmn.js:31:52) at /mnt/sda3/NV6-/nverr/nv-error-jserde/cmmn.js:39:79 at Array.map () at Object.creat_agger (/mnt/sda3/NV6-/nverr/nv-error-jserde/cmmn.js:39:70) at REPL12:1:18 at Script.runInThisContext (node:vm:129:12) at REPLServer.defaultEval (node:repl:562:29) at bound (node:domain:421:15) at REPLServer.runBound [as eval] (node:domain:432:12) at REPLServer.onLine (node:repl:889:10), Error: e2 at creat_er (/mnt/sda3/NV6-/nverr/nv-error-jserde/cmmn.js:31:52) at /mnt/sda3/NV6-/nverr/nv-error-jserde/cmmn.js:39:79 at Array.map () at Object.creat_agger (/mnt/sda3/NV6-/nverr/nv-error-jserde/cmmn.js:39:70) at REPL12:1:18 at Script.runInThisContext (node:vm:129:12) at REPLServer.defaultEval (node:repl:562:29) at bound (node:domain:421:15) at REPLServer.runBound [as eval] (node:domain:432:12) at REPLServer.onLine (node:repl:889:10) ] > agg_err.message 'agg' > agg_err.stack 'AggregateError: agg\n' + ' at _creat_agger (/mnt/sda3/NV6-/nverr/nv-error-jserde/cmmn.js:38:52)\n' + ' at Object.creat_agger (/mnt/sda3/NV6-/nverr/nv-error-jserde/cmmn.js:39:52)\n' + ' at REPL12:1:18\n' + ' at Script.runInThisContext (node:vm:129:12)\n' + ' at REPLServer.defaultEval (node:repl:562:29)\n' + ' at bound (node:domain:421:15)\n' + ' at REPLServer.runBound [as eval] (node:domain:432:12)\n' + ' at REPLServer.onLine (node:repl:889:10)\n' + ' at REPLServer.emit (node:events:402:35)\n' + ' at REPLServer.emit (node:domain:475:12)' > agg_err.cause Error: root at Object.creat_er (/mnt/sda3/NV6-/nverr/nv-error-jserde/cmmn.js:31:52) at REPL3:1:19 at Script.runInThisContext (node:vm:129:12) at REPLServer.defaultEval (node:repl:562:29) at bound (node:domain:421:15) at REPLServer.runBound [as eval] (node:domain:432:12) at REPLServer.onLine (node:repl:889:10) at REPLServer.emit (node:events:402:35) at REPLServer.emit (node:domain:475:12) at REPLServer.Interface._onLine (node:readline:487:10) > */ var erd = er.to_json(agg_err) /* > { name: 'AggregateError', message: 'agg', stack: [ 'AggregateError: agg', ' at _creat_agger (/mnt/sda3/NV6-/nverr/nv-error-jserde/cmmn.js:38:52)', ' at Object.creat_agger (/mnt/sda3/NV6-/nverr/nv-error-jserde/cmmn.js:39:52)', ' at REPL12:1:18', ' at Script.runInThisContext (node:vm:129:12)', ' at REPLServer.defaultEval (node:repl:562:29)', ' at bound (node:domain:421:15)', ' at REPLServer.runBound [as eval] (node:domain:432:12)', ' at REPLServer.onLine (node:repl:889:10)', ' at REPLServer.emit (node:events:402:35)', ' at REPLServer.emit (node:domain:475:12)' ], cause: { name: 'Error', message: 'root', stack: [ 'Error: root', ' at Object.creat_er (/mnt/sda3/NV6-/nverr/nv-error-jserde/cmmn.js:31:52)', ' at REPL3:1:19', ' at Script.runInThisContext (node:vm:129:12)', ' at REPLServer.defaultEval (node:repl:562:29)', ' at bound (node:domain:421:15)', ' at REPLServer.runBound [as eval] (node:domain:432:12)', ' at REPLServer.onLine (node:repl:889:10)', ' at REPLServer.emit (node:events:402:35)', ' at REPLServer.emit (node:domain:475:12)', ' at REPLServer.Interface._onLine (node:readline:487:10)' ], cause: null }, errors: [ { name: 'Error', message: 'e0', stack: [Array], cause: null }, { name: 'Error', message: 'e1', stack: [Array], cause: null }, { name: 'Error', message: 'e2', stack: [Array], cause: null } ] } > */ var duped = er.from_json(erd) /* > duped AggregateError: agg at _creat_agger (/mnt/sda3/NV6-/nverr/nv-error-jserde/cmmn.js:38:52) at Object.creat_agger (/mnt/sda3/NV6-/nverr/nv-error-jserde/cmmn.js:39:52) at REPL4:1:18 at Script.runInThisContext (node:vm:129:12) at REPLServer.defaultEval (node:repl:562:29) at bound (node:domain:421:15) at REPLServer.runBound [as eval] (node:domain:432:12) at REPLServer.onLine (node:repl:889:10) at REPLServer.emit (node:events:402:35) at REPLServer.emit (node:domain:475:12) { cause: Error: root at Object.creat_er (/mnt/sda3/NV6-/nverr/nv-error-jserde/cmmn.js:31:52) at REPL3:1:19 at Script.runInThisContext (node:vm:129:12) at REPLServer.defaultEval (node:repl:562:29) at bound (node:domain:421:15) at REPLServer.runBound [as eval] (node:domain:432:12) at REPLServer.onLine (node:repl:889:10) at REPLServer.emit (node:events:402:35) at REPLServer.emit (node:domain:475:12) at REPLServer.Interface._onLine (node:readline:487:10) { cause: null } } > duped.message 'agg' > duped.stack 'AggregateError: agg\n' + ' at _creat_agger (/mnt/sda3/NV6-/nverr/nv-error-jserde/cmmn.js:38:52)\n' + ' at Object.creat_agger (/mnt/sda3/NV6-/nverr/nv-error-jserde/cmmn.js:39:52)\n' + ' at REPL4:1:18\n' + ' at Script.runInThisContext (node:vm:129:12)\n' + ' at REPLServer.defaultEval (node:repl:562:29)\n' + ' at bound (node:domain:421:15)\n' + ' at REPLServer.runBound [as eval] (node:domain:432:12)\n' + ' at REPLServer.onLine (node:repl:889:10)\n' + ' at REPLServer.emit (node:events:402:35)\n' + ' at REPLServer.emit (node:domain:475:12)' > > duped.name 'AggregateError' > duped.cause Error: root at Object.creat_er (/mnt/sda3/NV6-/nverr/nv-error-jserde/cmmn.js:31:52) at REPL3:1:19 at Script.runInThisContext (node:vm:129:12) at REPLServer.defaultEval (node:repl:562:29) at bound (node:domain:421:15) at REPLServer.runBound [as eval] (node:domain:432:12) at REPLServer.onLine (node:repl:889:10) at REPLServer.emit (node:events:402:35) at REPLServer.emit (node:domain:475:12) at REPLServer.Interface._onLine (node:readline:487:10) { cause: null } > duped.errors [ Error: e0 at creat_er (/mnt/sda3/NV6-/nverr/nv-error-jserde/cmmn.js:31:52) at /mnt/sda3/NV6-/nverr/nv-error-jserde/cmmn.js:39:79 at Array.map () at Object.creat_agger (/mnt/sda3/NV6-/nverr/nv-error-jserde/cmmn.js:39:70) at REPL4:1:18 at Script.runInThisContext (node:vm:129:12) at REPLServer.defaultEval (node:repl:562:29) at bound (node:domain:421:15) at REPLServer.runBound [as eval] (node:domain:432:12) at REPLServer.onLine (node:repl:889:10) { cause: null }, Error: e1 at creat_er (/mnt/sda3/NV6-/nverr/nv-error-jserde/cmmn.js:31:52) at /mnt/sda3/NV6-/nverr/nv-error-jserde/cmmn.js:39:79 at Array.map () at Object.creat_agger (/mnt/sda3/NV6-/nverr/nv-error-jserde/cmmn.js:39:70) at REPL4:1:18 at Script.runInThisContext (node:vm:129:12) at REPLServer.defaultEval (node:repl:562:29) at bound (node:domain:421:15) at REPLServer.runBound [as eval] (node:domain:432:12) at REPLServer.onLine (node:repl:889:10) { cause: null }, Error: e2 at creat_er (/mnt/sda3/NV6-/nverr/nv-error-jserde/cmmn.js:31:52) at /mnt/sda3/NV6-/nverr/nv-error-jserde/cmmn.js:39:79 at Array.map () at Object.creat_agger (/mnt/sda3/NV6-/nverr/nv-error-jserde/cmmn.js:39:70) at REPL4:1:18 at Script.runInThisContext (node:vm:129:12) at REPLServer.defaultEval (node:repl:562:29) at bound (node:domain:421:15) at REPLServer.runBound [as eval] (node:domain:432:12) at REPLServer.onLine (node:repl:889:10) { cause: null } ] > */ APIS ======= ### funcs //just to avoid using , is boring for automation const creat_er = (msg:Str, cause:NU|Error) => new _ER(msg,{cause}); const creat_evler = (msg:Str, cause:NU|Error) => new _EVLER(msg,{cause}); const creat_refer = (msg:Str, cause:NU|Error) => new _REFER(msg,{cause}); const creat_rnger = (msg:Str, cause:NU|Error) => new _RNGER(msg,{cause}); const creat_stxer = (msg:Str, cause:NU|Error) => new _STXER(msg,{cause}); const creat_typer = (msg:Str, cause:NU|Error) => new _TYPER(msg,{cause}); const creat_urier = (msg:Str, cause:NU|Error) => new _URIER(msg,{cause}); const _creat_agger = (errs:Array,msg,cause) => new _AGGER(errs,msg,{cause}); const creat_agger = (msgs:Array,agg_msg,cause) => _creat_agger(msgs.map(msg=>creat_er(msg)),agg_msg,cause); //just to avoid using const is_er = (o) => _istof(o,_ER); const is_evler = (o) => _istof(o,_EVLER); const is_refer = (o) => _istof(o,_REFER); const is_rnger = (o) => _istof(o,_RNGER); const is_stxer = (o) => _istof(o,_STXER); const is_typer = (o) => _istof(o,_TYPER); const is_urier = (o) => _istof(o,_URIER); const is_agger = (o) => _istof(o,_AGGER); //just avoid using throw directly in biz code const thrw_msg = (msg) => {throw(creat_er(msg))}; const thrw_evlmsg = (msg) => {throw(creat_evler(msg))}; const thrw_refmsg = (msg) => {throw(creat_refer(msg))}; const thrw_rngmsg = (msg) => {throw(creat_rnger(msg))}; const thrw_stxmsg = (msg) => {throw(creat_stxer(msg))}; const thrw_typmsg = (msg) => {throw(creat_typer(msg))}; const thrw_urimsg = (msg) => {throw(creat_urier(msg))}; const thrw_aggmsg = (msgs)=> {throw(creat_agger(msgs))}; // .cause.cause.... const _get_root_cause_without_check_circular = (err)=> Error const get_root_cause = (err)=> Error const to_json_ignore_cause_and_children = (err)=> Dict const to_json_without_check_circular = (err)=> Dict const to_json = (err)=> Dict // ErrorDict : { name : String message : String stack : String // cause? : Error | String errors? : Array } const is_err_dict = (d)=> ERD_MANDATORY_PROPS.every(k=>d.hasOwnProperty(k)); const is_agger_dict = (d)=>is_err_dict(d) && d.hasOwnProperty("errors"); const _from_json_ignore_nest_without_check = (d: T'is_err_dict(self)) => Error const _from_json_ignore_nest = (d: T'is_err_dict(self)) => Error const _from_json_without_check = (d: T'is_err_dict(self)) => Error const from_json = (d: T'is_err_dict(self)) => Error ### alias AND consts cnst: { _ER: [Function: Error] { stackTraceLimit: 10 }, _AGGER: [Function: AggregateError], _EVLER: [Function: EvalError], _REFER: [Function: ReferenceError], _RNGER: [Function: RangeError], _STXER: [Function: SyntaxError], _TYPER: [Function: TypeError], _URIER: [Function: URIError], NAME_ARY: [ 'Error', 'AggregateError', 'EvalError', 'ReferenceError', 'RangeError', 'SyntaxError', 'TypeError', 'URIError' ], NM2CLS: { Error: [Function], AggregateError: [Function: AggregateError], EvalError: [Function: EvalError], ReferenceError: [Function: ReferenceError], RangeError: [Function: RangeError], SyntaxError: [Function: SyntaxError], TypeError: [Function: TypeError], URIError: [Function: URIError] }, cls2nm: [Function: cls2nm], ERD_MANDATORY_PROPS: [ 'name', 'message', 'stack' ], ERD_OPTIONAL_PROPS: [ 'cause' ], AGGER_ERD_MANDATORY_PROPS: [ 'errors' ], ERRORD: { circular: 'circular', must_be_dict: 'must_be_dict', must_be_erd: 'must_be_erd_with_name_message_stack' }, PROPSD: { name: 'name', message: 'message', stack: 'stack', cause: 'cause', errors: 'errors' } }, LICENSE ======= - ISC --- _Source: https://npm.io/package/nv-error-jserde · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._