File: /home/frenchy/www/french-american.org/releases/20210303111656Z/node_modules/errlop/source/index.js
'use strict'
/**
* Only accept codes that are numbers, otherwise discard them
* @param {*} code
* @returns {number}
* @private
*/
function parseCode(code) {
const number = Number(code)
if (isNaN(number)) return null
return number
}
/**
* Fetch the code from the value
* @param {Object|Error} value
* @returns {boolean}
* @private
*/
function fetchCode(value) {
return (
value &&
(parseCode(value.exitCode) ||
parseCode(value.errno) ||
parseCode(value.code))
)
}
/**
* Prevent [a weird error on node version 4](https://github.com/bevry/errlop/issues/1) and below.
* @param {*} value
* @returns {boolean}
* @private
*/
function isValid(value) {
/* eslint no-use-before-define:0 */
return value instanceof Error || Errlop.isErrlop(value)
}
/**
* Create an instance of an error, using a message, as well as an optional parent.
* If the parent is provided, then the `fullStack` property will include its stack too
* @class Errlop
* @constructor
* @param {Errlop|Error|Object|string} input
* @param {Errlop|Error} [parent]
* @public
*/
class Errlop extends Error {
constructor(input, parent) {
if (!input) throw new Error('Attempted to create an Errlop without a input')
// Instantiate with the above
super(input.message || input)
/**
* Duck typing as node 4 and intanceof does not work for error extensions
* @type {Errlop}
* @public
*/
this.klass = Errlop
/**
* The parent error if it was provided.
* If a parent was provided, then use that, otherwise use the input's parent, if it exists.
* @type {Error?}
* @public
*/
this.parent = parent || input.parent
/**
* An array of all the ancestors. From parent, to grand parent, and so on.
* @type {Array<Error>}
* @public
*/
this.ancestors = []
let ancestor = this.parent
while (ancestor) {
this.ancestors.push(ancestor)
ancestor = ancestor.parent
}
// this code must support node 0.8, as well as prevent a weird bug in node v4: https://travis-ci.org/bevry/editions/jobs/408828147
let exitCode = fetchCode(input)
if (exitCode == null) exitCode = fetchCode(this)
for (
let index = 0;
index < this.ancestors.length && exitCode == null;
++index
) {
const error = this.ancestors[index]
if (isValid(error)) exitCode = fetchCode(error)
}
/**
* A numeric code to use for the exit status if desired by the consumer.
* It cycles through [input, this, ...ancestors] until it finds the first [exitCode, errno, code] that is valid.
* @type {Number?}
* @public
*/
this.exitCode = exitCode
/**
* The stack for our instance alone, without any parents.
* If the input contained a stack, then use that.
* @type {string}
* @public
*/
this.orphanStack = (input.stack || this.stack).toString()
/**
* The stack which now contains the accumalated stacks of its ancestors.
* This is used instead of an alias like `fullStack` or the like, to ensure existing code that uses `err.stack` doesn't need to be changed to remain functional.
* @type {string}
* @public
*/
this.stack = [this.orphanStack, ...this.ancestors].reduce(
(accumulator, error) =>
`${accumulator}\n↳ ${error.orphanStack || error.stack || error}`
)
}
/**
* Syntatic sugar for Errlop class creation.
* Enables `Errlop.create(...args)` to achieve `new Errlop(...args)`
* @param {...*} args
* @returns {Errlop}
* @static
* @public
*/
static create(...args) {
return new this(...args)
}
/**
* Check whether or not the value is an Errlop instance
* @param {*} value
* @returns {boolean}
* @static
* @public
*/
static isErrlop(value) {
return value && (value instanceof this || value.klass === this)
}
/**
* Ensure that the value is an Errlop instance
* @param {*} value
* @returns {Errlop}
* @static
* @public
*/
static ensure(value) {
return this.isErrlop(value) ? value : this.create(value)
}
}
module.exports = Errlop