prepare_stack_trace.js

'use strict';

const {
  Error,
} = primordials;

const debug = require('internal/util/debuglog').debuglog('source_map');
const { getStringWidth } = require('internal/util/inspect');
const { readFileSync } = require('fs');
const { findSourceMap } = require('internal/source_map/source_map_cache');
const {
  kNoOverride,
  overrideStackTrace,
  maybeOverridePrepareStackTrace
} = require('internal/errors');

// Create a prettified stacktrace, inserting context from source maps
// if possible.
const ErrorToString = Error.prototype.toString; // Capture original toString.
const prepareStackTrace = (globalThis, error, trace) => {
  // API for node internals to override error stack formatting
  // without interfering with userland code.
  // TODO(bcoe): add support for source-maps to repl.
  if (overrideStackTrace.has(error)) {
    const f = overrideStackTrace.get(error);
    overrideStackTrace.delete(error);
    return f(error, trace);
  }

  const globalOverride =
    maybeOverridePrepareStackTrace(globalThis, error, trace);
  if (globalOverride !== kNoOverride) return globalOverride;

  const errorString = ErrorToString.call(error);

  if (trace.length === 0) {
    return errorString;
  }

  let errorSource = '';
  let firstSource;
  let firstLine;
  let firstColumn;
  const preparedTrace = trace.map((t, i) => {
    if (i === 0) {
      firstLine = t.getLineNumber();
      firstColumn = t.getColumnNumber();
      firstSource = t.getFileName();
    }
    let str = i !== 0 ? '\n    at ' : '';
    str = `${str}${t}`;
    try {
      const sm = findSourceMap(t.getFileName(), error);
      if (sm) {
        // Source Map V3 lines/columns use zero-based offsets whereas, in
        // stack traces, they start at 1/1.
        const {
          originalLine,
          originalColumn,
          originalSource
        } = sm.findEntry(t.getLineNumber() - 1, t.getColumnNumber() - 1);
        if (originalSource && originalLine !== undefined &&
            originalColumn !== undefined) {
          const originalSourceNoScheme = originalSource
            .replace(/^file:\/\//, '');
          if (i === 0) {
            firstLine = originalLine + 1;
            firstColumn = originalColumn + 1;
            firstSource = originalSourceNoScheme;
            // Show error in original source context to help user pinpoint it:
            errorSource = getErrorSource(firstSource, firstLine, firstColumn);
          }
          // Show both original and transpiled stack trace information:
          str += `\n        -> ${originalSourceNoScheme}:${originalLine + 1}:` +
            `${originalColumn + 1}`;
        }
      }
    } catch (err) {
      debug(err.stack);
    }
    return str;
  });
  return `${errorSource}${errorString}\n    at ${preparedTrace.join('')}`;
};

// Places a snippet of code from where the exception was originally thrown
// above the stack trace. This logic is modeled after GetErrorSource in
// node_errors.cc.
function getErrorSource(firstSource, firstLine, firstColumn) {
  let exceptionLine = '';
  let source;
  try {
    source = readFileSync(firstSource, 'utf8');
  } catch (err) {
    debug(err);
    return exceptionLine;
  }
  const lines = source.split(/\r?\n/, firstLine);
  const line = lines[firstLine - 1];
  if (!line) return exceptionLine;

  // Display ^ in appropriate position, regardless of whether tabs or
  // spaces are used:
  let prefix = '';
  for (const character of line.slice(0, firstColumn)) {
    prefix += (character === '\t') ? '\t' :
      ' '.repeat(getStringWidth(character));
  }
  prefix = prefix.slice(0, -1); // The last character is the '^'.

  exceptionLine = `${firstSource}:${firstLine}\n${line}\n${prefix}^\n\n`;
  return exceptionLine;
}

module.exports = {
  prepareStackTrace,
};