How to Lowercase Keys of an Object in JavaScript or Node.js

When interacting with data from different sources, like your local data and third-party services, the data has different styles and formats. Let’s say you’re using a camelCase format and other sources use everything in UPPERCASE.

Independently of the situation, you may want to transform all keys of an object to lowercase. This tutorial shows you how to do that!

Node.js Series Overview

  1. String Replace All Appearances
  2. Remove All Whitespace From a String in JavaScript
  3. Generate a Random ID or String in Node.js or JavaScript
  4. Remove Extra Spaces From a String in JavaScript or Node.js
  5. Remove Numbers From a String in JavaScript or Node.js
  6. Get the Part Before a Character in a String in JavaScript or Node.js
  7. Get the Part After a Character in a String in JavaScript or Node.js
  8. How to Check if a Value is a String in JavaScript or Node.js
  9. Check If a String Includes All Strings in JavaScript/Node.js/TypeScript
  10. Check if a Value is a String in JavaScript and Node.js
  11. Limit and Truncate a String to a Given Length in JavaScript and Node.js
  12. Split a String into a List of Characters in JavaScript and Node.js
  13. How to Generage a UUID in Node.js
  14. Reverse a String in JavaScript or Node.js
  15. Split a String into a List of Lines in JavaScript or Node.js
  16. Split a String into a List of Words in JavaScript or Node.js
  17. Detect if a String is in camelCase Format in Javascript or Node.js
  18. Check If a String Is in Lowercase in JavaScript or Node.js
  19. Check If a String is in Uppercase in JavaScript or Node.js
  20. Get the Part After First Occurrence in a String in JavaScript or Node.js
  21. Get the Part Before First Occurrence in a String in JavaScript or Node.js
  22. Get the Part Before Last Occurrence in a String in JavaScript or Node.js
  23. Get the Part After Last Occurrence in a String in JavaScript or Node.js
  24. How to Count Words in a File
  25. How to Shuffle the Characters of a String in JavaScript or Node.js
  26. Append Characters or Words to a String in JavaScript or Node.js
  27. Check if a String is Empty in JavaScript or Node.js
  28. Ensure a String Ends with a Given Character in JavaScript or Node.js
  29. Left-Trim Characters Off a String in JavaScript or Node.js
  30. Right-Trim Characters Off a String in JavaScript or Node.js
  31. Lowercase the First Character of a String in JavaScript or Node.js
  32. Uppercase the First Character of a String in JavaScript or Node.js
  33. Prepend Characters or Words to a String in JavaScript or Node.js
  34. Check if a String is a Number
  35. Convert a String to Buffer
  36. Prevent Line Breaks in String Template Literals
  37. How to Implement a Custom `toString` Method
  38. What Is `Symbol.toStringTag` and How to Use It (Coming soon)

Lowercase All Keys of an Object in JavaScript

You can use built-in features of JavaScript to lowercase all keys of an object. Modern browsers and Node.js support the Object.entries() method to return an array of the object’s key-value pairs. Then you can iterate over these key-value-pairs using Array#reduce() to create a new object with all keys lowercase.

Here’s a utility function to lowercase all keys in a JavaScript object:

/**
 * Lowercase all top-level keys of the given `object` to lowercase.
 *
 * @returns {Object}
 */
function lowercaseKeys(obj) {  
  if (!isObject(obj)) {
    throw new Error(`You must provide an object to "lowercaseKeys". Received "${typeof obj}"`)
  }

  return Object
    .entries(obj)
    .reduce((carry, [key, value]) => {
      carry[key.toLowerCase()] = value;

      return carry;
    }, {});
}

/**
 * Determine whether the given `value` is an object.
 *
 * @param {*} value
 *
 * @returns {value is object}
 */
function isObject (value) {  
  return Object.prototype.toString.call(value) === '[object Object]'
}
Find more details about the `isObject` helper function in a dedicated tutorial here on Future Studio: [Check If a Value Is an Object in JavaScript or Node.js](https://futurestud.io/tutorials/check-if-a-value-is-an-object-in-javascript-or-node-js)  

Please notice: the lowercaseKeys function only lowercases the top-level keys of the object. It’s not recursively going through the object and instead touches the top-level keys only.

Here’s an example of lowercasing all top-level keys of an object:

const fileImport = {  
  fileLocation: '/user/marcus/downloads/data_import.xlsx',
  createdAt: 1610685464300,
  Nested: {
    // the `lowercaseKeys` function does not touch nested objects
  }
}

const lowercasedFileImport = lowercaseKeys(fileImport)  
// {
//   filelocation: '/user/marcus/downloads/data_import.xlsx',
//   createdat: 1610685464300,
//   nested: {
//     … untouched
//   } 
// }

Enjoy lowercasing keys of JavaScript objects!

Explore the Library

Find interesting tutorials and solutions for your problems.