@sentry/core/build/cjs/utils/weakRef.js

Base implementation for all Sentry JavaScript SDKs

Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });

const worldwide = require('./worldwide.js');

/**
 * Interface representing a weak reference to an object.
 * This matches the standard WeakRef interface but is defined here
 * because WeakRef is not available in ES2020 type definitions.
 */

/**
 * Creates a weak reference to an object if WeakRef is available,
 * otherwise returns the object directly.
 *
 * This is useful for breaking circular references while maintaining
 * compatibility with environments that don't support WeakRef (e.g., older browsers).
 *
 * @param value - The object to create a weak reference to
 * @returns A WeakRef wrapper if available, or the original object as fallback
 */
function makeWeakRef(value) {
  try {
    // @ts-expect-error - WeakRef may not be in the type definitions for older TS targets
    const WeakRefImpl = worldwide.GLOBAL_OBJ.WeakRef;
    if (typeof WeakRefImpl === 'function') {
      return new WeakRefImpl(value);
    }
  } catch {
    // WeakRef not available or construction failed
  }
  return value;
}

/**
 * Resolves a potentially weak reference, returning the underlying object
 * or undefined if the reference has been garbage collected.
 *
 * @param ref - A MaybeWeakRef or undefined
 * @returns The referenced object, or undefined if GC'd or ref was undefined
 */
function derefWeakRef(ref) {
  if (!ref) {
    return undefined;
  }

  // Check if this is a WeakRef (has deref method)
  if (typeof ref === 'object' && 'deref' in ref && typeof ref.deref === 'function') {
    try {
      return ref.deref();
    } catch {
      // deref() failed - treat as GC'd
      return undefined;
    }
  }

  // Direct reference fallback
  return ref ;
}

exports.derefWeakRef = derefWeakRef;
exports.makeWeakRef = makeWeakRef;
//# sourceMappingURL=weakRef.js.map