Function serializeJSStackFrame

lib/internal/source_map/prepare_stack_trace.js:82–118

* Serialize a single call site in the stack trace. * Refer to SerializeJSStackFrame in deps/v8/src/objects/call-site-info.cc for * more details about the default ToString(CallSite). * The CallSite API is documented at https://v8.dev/docs/stack-trace-api. * @param {import('internal/source_map/sou

(sm, callSite, callerCallSite)

 * @returns {string} - the serialized call site
 */
function serializeJSStackFrame(sm, callSite, callerCallSite) {
  // Source Map V3 lines/columns start at 0/0 whereas stack traces
  // start at 1/1:
  const {
    originalLine,
    originalColumn,
    originalSource,
  } = sm.findEntry(callSite.getLineNumber() - 1, callSite.getColumnNumber() - 1);
  if (originalSource === undefined || originalLine === undefined ||
      originalColumn === undefined) {
    return `${callSite}`;
  }
  const name = getOriginalSymbolName(sm, callSite, callerCallSite);
  const originalSourceNoScheme =
    StringPrototypeStartsWith(originalSource, 'file://') ?
      fileURLToPath(originalSource) : originalSource;
  // Construct call site name based on: v8.dev/docs/stack-trace-api:
  const fnName = callSite.getFunctionName() ?? callSite.getMethodName();

  let prefix = '';
  if (callSite.isAsync()) {
    // Promise aggregation operation frame has no locations. This must be an
    // async stack frame.
    prefix = 'async ';
  } else if (callSite.isConstructor()) {
    prefix = 'new ';
  }

  const typeName = callSite.getTypeName();
  const namePrefix = typeName !== null && typeName !== 'global' ? `${typeName}.` : '';
  const originalName = `${fnName || '<anonymous>'}`;
  const mappedName = `${namePrefix}${name || originalName}` || '';
  // Replace the transpiled call site with the original:
  return `${prefix}${mappedName} (` +
    `${originalSourceNoScheme}:${originalLine + 1}:` +
    `${originalColumn + 1})`;
}

// Transpilers may have removed the original symbol name used in the stack
// trace, if possible restore it from the names field of the source map: