?HAMA

Navigation

Breadcrumbs

Create

Edit File Size: 2.56 KB

/proc/thread-self/root/proc/self/root/opt/alt/alt-nodejs16/root/lib/node_modules/npm/lib/utils/explain-eresolve.js

Text Base64

// this is called when an ERESOLVE error is caught in the exit-handler,
// or when there's a log.warn('eresolve', msg, explanation), to turn it
// into a human-intelligible explanation of what's wrong and how to fix.
const { writeFileSync } = require('fs')
const { explainEdge, explainNode, printNode } = require('./explain-dep.js')

// expl is an explanation object that comes from Arborist.  It looks like:
// Depth is how far we want to want to descend into the object making a report.
// The full report (ie, depth=Infinity) is always written to the cache folder
// at ${cache}/eresolve-report.txt along with full json.
const explain = (expl, color, depth) => {
  const { edge, dep, current, peerConflict, currentEdge } = expl

const out = []
  const whileInstalling = dep && dep.whileInstalling ||
    current && current.whileInstalling ||
    edge && edge.from && edge.from.whileInstalling
  if (whileInstalling) {
    out.push('While resolving: ' + printNode(whileInstalling, color))
  }

// it "should" be impossible for an ERESOLVE explanation to lack both
  // current and currentEdge, but better to have a less helpful error
  // than a crashing failure.
  if (current) {
    out.push('Found: ' + explainNode(current, depth, color))
  } else if (peerConflict && peerConflict.current) {
    out.push('Found: ' + explainNode(peerConflict.current, depth, color))
  } else if (currentEdge) {
    out.push('Found: ' + explainEdge(currentEdge, depth, color))
  } else /* istanbul ignore else - should always have one */ if (edge) {
    out.push('Found: ' + explainEdge(edge, depth, color))
  }

out.push('\nCould not resolve dependency:\n' +
    explainEdge(edge, depth, color))

if (peerConflict) {
    const heading = '\nConflicting peer dependency:'
    const pc = explainNode(peerConflict.peer, depth, color)
    out.push(heading + ' ' + pc)
  }

return out.join('\n')
}

// generate a full verbose report and tell the user how to fix it
const report = (expl, color, fullReport) => {
  const orNoStrict = expl.strictPeerDeps ? '--no-strict-peer-deps, ' : ''
  const fix = `Fix the upstream dependency conflict, or retry
this command with ${orNoStrict}--force, or --legacy-peer-deps
to accept an incorrect (and potentially broken) dependency resolution.`

writeFileSync(fullReport, `# npm resolution error report

${new Date().toISOString()}

${explain(expl, false, Infinity)}

${fix}

Raw JSON explanation object:

${JSON.stringify(expl, null, 2)}
`, 'utf8')

return explain(expl, color, 4) +
    `\n\n${fix}\n\nSee ${fullReport} for a full report.`
}

module.exports = {
  explain,
  report,
}

Exit & Reset Text mode: syntax highlighting auto-detects file type.

Name	Size	Perms	Modified	Actions
completion DIR	-	drwxr-xr-x	2026-03-19 07:09:42	Edit Download recursive recursive
config DIR	-	drwxr-xr-x	2026-03-19 07:09:42	Edit Download recursive recursive
ansi-trim.js	173 B	lrw-r--r--	2026-03-09 06:51:26	Edit Download recursive recursive
audit-error.js	978 B	lrw-r--r--	2026-03-09 06:51:26	Edit Download recursive recursive
cmd-list.js	2.46 KB	lrw-r--r--	2026-03-09 06:51:26	Edit Download recursive recursive
completion.sh	1.85 KB	lrwxr-xr-x	2026-03-09 06:51:26	Edit Download recursive recursive
did-you-mean.js	1.46 KB	lrw-r--r--	2026-03-09 06:51:26	Edit Download recursive recursive
display.js	2.84 KB	lrw-r--r--	2026-03-09 06:51:26	Edit Download recursive recursive
error-message.js	12.64 KB	lrw-r--r--	2026-03-09 06:51:26	Edit Download recursive recursive
exit-handler.js	6.77 KB	lrw-r--r--	2026-03-09 06:51:26	Edit Download recursive recursive
explain-dep.js	3.73 KB	lrw-r--r--	2026-03-09 06:51:26	Edit Download recursive recursive
explain-eresolve.js	2.56 KB	lrw-r--r--	2026-03-09 06:51:26	Edit Download recursive recursive
format-bytes.js	629 B	lrw-r--r--	2026-03-09 06:51:26	Edit Download recursive recursive
format-search-stream.js	3.93 KB	lrw-r--r--	2026-03-09 06:51:26	Edit Download recursive recursive
get-identity.js	740 B	lrw-r--r--	2026-03-09 06:51:26	Edit Download recursive recursive
is-windows.js	233 B	lrw-r--r--	2026-03-09 06:51:26	Edit Download recursive recursive
log-file.js	7.64 KB	lrw-r--r--	2026-03-09 06:51:26	Edit Download recursive recursive
log-shim.js	1.68 KB	lrw-r--r--	2026-03-09 06:51:26	Edit Download recursive recursive
npm-usage.js	1.95 KB	lrw-r--r--	2026-03-09 06:51:26	Edit Download recursive recursive
open-url-prompt.js	1.54 KB	lrw-r--r--	2026-03-09 06:51:26	Edit Download recursive recursive
open-url.js	1.17 KB	lrw-r--r--	2026-03-09 06:51:26	Edit Download recursive recursive
otplease.js	1.23 KB	lrw-r--r--	2026-03-09 06:51:26	Edit Download recursive recursive
ping.js	252 B	lrw-r--r--	2026-03-09 06:51:26	Edit Download recursive recursive
pulse-till-done.js	412 B	lrw-r--r--	2026-03-09 06:51:26	Edit Download recursive recursive
queryable.js	9.58 KB	lrw-r--r--	2026-03-09 06:51:26	Edit Download recursive recursive
read-user-info.js	1.99 KB	lrw-r--r--	2026-03-09 06:51:26	Edit Download recursive recursive
reify-finish.js	876 B	lrw-r--r--	2026-03-09 06:51:26	Edit Download recursive recursive
reify-output.js	4.96 KB	lrw-r--r--	2026-03-09 06:51:26	Edit Download recursive recursive
replace-info.js	807 B	lrw-r--r--	2026-03-09 06:51:26	Edit Download recursive recursive
tar.js	3.73 KB	lrw-r--r--	2026-03-09 06:51:26	Edit Download recursive recursive
timers.js	3.18 KB	lrw-r--r--	2026-03-09 06:51:26	Edit Download recursive recursive
update-notifier.js	4.45 KB	lrw-r--r--	2026-03-09 06:51:26	Edit Download recursive recursive
validate-lockfile.js	1023 B	lrw-r--r--	2026-03-09 06:51:26	Edit Download recursive recursive
web-auth.js	558 B	lrw-r--r--	2026-03-09 06:51:26	Edit Download recursive recursive

Directory Contents