Function validateOptions

src/helpers/validate-options.ts:12–31

(
  functionName: string,
  restOptions: Record<string, unknown>,
  // eslint-disable-next-line @typescript-eslint/no-unsafe-function-type
  callsite: Function,
)

 * @param callsite - The function where the validation is called from (e.g., render, renderHook)
 */
export function validateOptions(
  functionName: string,
  restOptions: Record<string, unknown>,
  // eslint-disable-next-line @typescript-eslint/no-unsafe-function-type
  callsite: Function,
): void {
  const unknownKeys = Object.keys(restOptions);
  if (unknownKeys.length > 0) {
    // Pass the callsite function (e.g., render) to remove it from stack
    // This leaves only where the user called the function from (e.g., test file)
    const stackTraceError = new ErrorWithStack('STACK_TRACE_ERROR', callsite);
    const stackLines = stackTraceError.stack ? stackTraceError.stack.split('\n') : [];
    // Skip the first line (Error: STACK_TRACE_ERROR) to show the actual call sites
    // The remaining lines show where the user called the function from
    const stackTrace = stackLines.length > 1 ? `\n\n${stackLines.slice(1).join('\n')}` : '';
    logger.warn(
      `Unknown option(s) passed to ${functionName}: ${unknownKeys.join(', ')}${stackTrace}`,
    );
  }
}