{"_id":"explain-error","_rev":"4573542","name":"explain-error","description":"wrap errors in explainations.","dist-tags":{"latest":"1.0.4"},"maintainers":[{"name":"dominictarr","email":"dominic.tarr@gmail.com"}],"time":{"modified":"2026-04-10T15:35:12.000Z","created":"2014-11-18T12:34:37.311Z","1.0.4":"2017-05-20T10:15:52.640Z","1.0.3":"2016-07-10T01:47:21.975Z","1.0.2":"2016-07-10T01:44:08.191Z","1.0.1":"2014-11-18T12:39:53.658Z","1.0.0":"2014-11-18T12:34:37.311Z"},"users":{},"author":{"name":"Dominic Tarr","email":"dominic.tarr@gmail.com","url":"http://dominictarr.com"},"repository":{"type":"git","url":"git://github.com/dominictarr/explain-error.git"},"versions":{"1.0.4":{"name":"explain-error","description":"wrap errors in explainations.","version":"1.0.4","homepage":"https://github.com/dominictarr/explain-error","repository":{"type":"git","url":"git://github.com/dominictarr/explain-error.git"},"scripts":{"test":"set -e; for t in test/*.js; do node $t; done"},"author":{"name":"Dominic Tarr","email":"dominic.tarr@gmail.com","url":"http://dominictarr.com"},"license":"MIT","devDependencies":{"level-errors":"^1.0.4"},"gitHead":"986470f37a70a683bd6b9bab491914245fb59761","bugs":{"url":"https://github.com/dominictarr/explain-error/issues"},"_id":"explain-error@1.0.4","_shasum":"a793d3ac0cad4c6ab571e9968fbbab6cb2532929","_from":".","_npmVersion":"4.2.0","_nodeVersion":"7.8.0","_npmUser":{"name":"dominictarr","email":"dominic.tarr@gmail.com"},"dist":{"shasum":"a793d3ac0cad4c6ab571e9968fbbab6cb2532929","size":2169,"noattachment":false,"key":"/explain-error/-/explain-error-1.0.4.tgz","tarball":"http://registry.cnpm.dingdandao.com/explain-error/download/explain-error-1.0.4.tgz"},"maintainers":[{"name":"dominictarr","email":"dominic.tarr@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/explain-error-1.0.4.tgz_1495275352514_0.5112675398122519"},"directories":{},"publish_time":1495275352640,"_hasShrinkwrap":false,"_cnpm_publish_time":1495275352640,"_cnpmcore_publish_time":"2021-12-16T18:33:56.466Z"},"1.0.3":{"name":"explain-error","description":"wrap errors in explainations.","version":"1.0.3","homepage":"https://github.com/dominictarr/explain-error","repository":{"type":"git","url":"git://github.com/dominictarr/explain-error.git"},"scripts":{"test":"set -e; for t in test/*.js; do node $t; done"},"author":{"name":"Dominic Tarr","email":"dominic.tarr@gmail.com","url":"http://dominictarr.com"},"license":"MIT","gitHead":"8d0c70e030207e6a372ef3527767db699b362523","bugs":{"url":"https://github.com/dominictarr/explain-error/issues"},"_id":"explain-error@1.0.3","_shasum":"f4e2b21152120d94db36d93bef03a5c42bfedce9","_from":".","_npmVersion":"3.8.9","_nodeVersion":"6.2.0","_npmUser":{"name":"dominictarr","email":"dominic.tarr@gmail.com"},"dist":{"shasum":"f4e2b21152120d94db36d93bef03a5c42bfedce9","size":1994,"noattachment":false,"key":"/explain-error/-/explain-error-1.0.3.tgz","tarball":"http://registry.cnpm.dingdandao.com/explain-error/download/explain-error-1.0.3.tgz"},"maintainers":[{"name":"dominictarr","email":"dominic.tarr@gmail.com"}],"_npmOperationalInternal":{"host":"packages-12-west.internal.npmjs.com","tmp":"tmp/explain-error-1.0.3.tgz_1468115241550_0.9341711369343102"},"directories":{},"publish_time":1468115241975,"_hasShrinkwrap":false,"_cnpm_publish_time":1468115241975,"_cnpmcore_publish_time":"2021-12-16T18:33:56.684Z"},"1.0.2":{"name":"explain-error","description":"wrap errors in explainations.","version":"1.0.2","homepage":"https://github.com/dominictarr/explain-error","repository":{"type":"git","url":"git://github.com/dominictarr/explain-error.git"},"scripts":{"test":"set -e; for t in test/*.js; do node $t; done"},"author":{"name":"Dominic Tarr","email":"dominic.tarr@gmail.com","url":"http://dominictarr.com"},"license":"MIT","gitHead":"f988f79c9dd8feff381d3a5c6de690f383304d72","bugs":{"url":"https://github.com/dominictarr/explain-error/issues"},"_id":"explain-error@1.0.2","_shasum":"d7a78dd9f6d3e638343b96aecece5481d5864f93","_from":".","_npmVersion":"3.8.9","_nodeVersion":"6.2.0","_npmUser":{"name":"dominictarr","email":"dominic.tarr@gmail.com"},"dist":{"shasum":"d7a78dd9f6d3e638343b96aecece5481d5864f93","size":1997,"noattachment":false,"key":"/explain-error/-/explain-error-1.0.2.tgz","tarball":"http://registry.cnpm.dingdandao.com/explain-error/download/explain-error-1.0.2.tgz"},"maintainers":[{"name":"dominictarr","email":"dominic.tarr@gmail.com"}],"_npmOperationalInternal":{"host":"packages-12-west.internal.npmjs.com","tmp":"tmp/explain-error-1.0.2.tgz_1468115047711_0.5680257929489017"},"directories":{},"publish_time":1468115048191,"_hasShrinkwrap":false,"_cnpm_publish_time":1468115048191,"_cnpmcore_publish_time":"2021-12-16T18:33:56.885Z"},"1.0.1":{"name":"explain-error","description":"wrap errors in explainations.","version":"1.0.1","homepage":"https://github.com/dominictarr/explain-error","repository":{"type":"git","url":"git://github.com/dominictarr/explain-error.git"},"scripts":{"test":"set -e; for t in test/*.js; do node $t; done"},"author":{"name":"Dominic Tarr","email":"dominic.tarr@gmail.com","url":"http://dominictarr.com"},"license":"MIT","gitHead":"bee6c3bff66a7bc59e1f485437d1e742eb799a0a","bugs":{"url":"https://github.com/dominictarr/explain-error/issues"},"_id":"explain-error@1.0.1","_shasum":"c77cca5fa73e5653232ad55b1cc9593c6893eee5","_from":".","_npmVersion":"1.4.26","_npmUser":{"name":"dominictarr","email":"dominic.tarr@gmail.com"},"maintainers":[{"name":"dominictarr","email":"dominic.tarr@gmail.com"}],"dist":{"shasum":"c77cca5fa73e5653232ad55b1cc9593c6893eee5","size":2003,"noattachment":false,"key":"/explain-error/-/explain-error-1.0.1.tgz","tarball":"http://registry.cnpm.dingdandao.com/explain-error/download/explain-error-1.0.1.tgz"},"directories":{},"publish_time":1416314393658,"_hasShrinkwrap":false,"_cnpm_publish_time":1416314393658,"_cnpmcore_publish_time":"2021-12-16T18:33:57.088Z"},"1.0.0":{"name":"explain-error","description":"wrap errors in explainations.","version":"1.0.0","homepage":"https://github.com/dominictarr/explain-error","repository":{"type":"git","url":"git://github.com/dominictarr/explain-error.git"},"scripts":{"test":"set -e; for t in test/*.js; do node $t; done"},"author":{"name":"Dominic Tarr","email":"dominic.tarr@gmail.com","url":"http://dominictarr.com"},"license":"MIT","gitHead":"2a18c24d9c361d2d91bc6d9ede862265bfa14fc5","bugs":{"url":"https://github.com/dominictarr/explain-error/issues"},"_id":"explain-error@1.0.0","_shasum":"37e66be4b22848ee9d8df9e958167d33309404b4","_from":".","_npmVersion":"1.4.26","_npmUser":{"name":"dominictarr","email":"dominic.tarr@gmail.com"},"maintainers":[{"name":"dominictarr","email":"dominic.tarr@gmail.com"}],"dist":{"shasum":"37e66be4b22848ee9d8df9e958167d33309404b4","size":2002,"noattachment":false,"key":"/explain-error/-/explain-error-1.0.0.tgz","tarball":"http://registry.cnpm.dingdandao.com/explain-error/download/explain-error-1.0.0.tgz"},"directories":{},"publish_time":1416314077311,"_hasShrinkwrap":false,"_cnpm_publish_time":1416314077311,"_cnpmcore_publish_time":"2021-12-16T18:33:57.265Z"}},"readme":"# explain-error\n\nwrap errors in explainations.\n\nIn node sometimes something fails because of some internal detail,\nbut then this error may be passed back somewhere else, too often,\ncontext is lost.\n\n## example\n\n``` js\nvar explain = require('explain-error')\n\n//stat a file that does not exist. this will error, add an explaination.\nfunction explainedError(cb) {\n  require('fs').stat('neoatuhrcoahkrcophkr', function (err) {\n    if(err) cb(explain(err, 'asked for a file that certainly did not exist'))\n    else cb()\n  })\n}\n\n//show that this works even with multiple layers of explainations.\nexplainedError(function (err) {\n  throw explain(err, 'called an function that was expected to fail')\n})\n```\n\noutput:\n\n`fs.stat` does not show where it was called from,\nbut at least now you know what happened after that.\n\n```\nError: called an function that was expected to fail\n    at /home/dominic/c/explain-error/example.js:11:9\n    at /home/dominic/c/explain-error/example.js:5:13\n  Error: asked for a file that certainly did not exist\n    at /home/dominic/c/explain-error/example.js:5:16\n    at Object.oncomplete (fs.js:107:15)\n  Error: ENOENT, stat neoatuhrcoahkrcophkr\n\n```\n\n## parsing stack traces\n\nof course, this adds lines to your errors that will do not look like normal js errors.\nwill this break all your tools? if so please post an issue.\n\n## License\n\nMIT\n","_attachments":{},"homepage":"https://github.com/dominictarr/explain-error","bugs":{"url":"https://github.com/dominictarr/explain-error/issues"},"license":"MIT"}