Flatten JavaScript Object by Mapping Keys Recursively

flatten-object.ts

export function flattenObject(
  obj: object,
  opts: {
    prefix?: string;
    postfix?: string;
    delimiter?: string;
    wordExtractor?: (text: string) => string[];
  }
) {
  const flattened: Record<string, any> = {};

  const wordExtractor = opts.wordExtractor || extractWordsFromCamelCase;
  const prefix = opts.prefix || "";
  const postfix = opts.postfix || "";
  const delimiter = opts.delimiter || ".";

  for (let propertyName of Object.keys(obj)) {
    const targetProperty = obj[propertyName];
    const flattenedKey =
      prefix + wordExtractor(propertyName).join(delimiter);

    if (typeof targetProperty === "object") {
      const flattenedTarget = flattenObject(targetProperty, { delimiter });
      for (const [k, v] of Object.entries(flattenedTarget)) {
        flattened[flattenedKey + delimiter + k + postfix] = v;
      }
    } else {
      flattened[flattenedKey + postfix] = targetProperty;
    }
  }

  return flattened;
}

// Default way to extract words. Assumes input string is in camelCase
function extractWordsFromCamelCase(text: string) {
  return (text.charAt(0).toLowerCase() + text.substring(1))
    .replace(/([A-Z])/g, ",$1")
    .split(",")
    .map((word) => word.toLowerCase());
}

If you'd like arrays not to be flattened by their indices,
Simply replace typeof targetProperty === "object" check with targetProperty?.constructor.name === 'Object'