Skip to content Skip to footer

Console.table(): Level Up Your JavaScript Debugging Game

Ahoy, fellow JavaScript aficionados! Today, we’re diving into the nifty little gem that is console.table(). If you’re like me, you’ve probably spent a good chunk of your coding life using console.log() to spit out values and debug your code. But what if I told you there’s a way to make your console output look like it’s ready for a black-tie event? That’s where console.table() struts in.

What’s console.table() and Why Should You Care?

console.table() is a console function that takes an array or an object and displays it as a table in the console window. It’s a part of the Console API, and it’s particularly handy when you need to display a collection of data in a structured and readable format.

Here’s the kicker: it works out of the box in most modern browsers and Node.js environments. No need to install anything, no need to import any third-party libraries. It’s right there, waiting to make your debugging sessions a little less “what on earth is going on?” and a lot more “Ah, I see what’s happening here!”

Basic Usage of console.table()

Let’s kick things off with a simple example. Imagine you’ve got an array of objects representing a bunch of cool cats and their favorite treats. Here’s how you’d typically log it:

const coolCats = [
  { name: 'Whiskers', treat: 'Tuna' },
  { name: 'Paws', treat: 'Salmon' },
  { name: 'Socks', treat: 'Chicken' }


That’ll get you a JSON-like output that’s kind of okay to read. But now, let’s put on our fancy pants and use console.table():


Bam! You’ve got yourself a table where each row is a cat, and the columns are the properties of the cat objects. It’s neat, it’s tidy, and it’s way easier to compare and contrast data.

Customizing console.table() Output

Did I mention you can customize the columns that get displayed? Suppose you’re only interested in the names of the cool cats. Just pass a second argument with the column names you want to include:

console.table(coolCats, ['name']);

Now your table will only show the ‘name’ column. Super handy when you’re dealing with objects that have more properties than a Monopoly board.

When to Use console.table()

“Sure, it looks pretty,” you might say, “but when would I actually use it?” Great question! console.table() shines when you’re dealing with arrays of objects where each object has the same properties. It’s perfect for:

  • Viewing database query results
  • Debugging lists of entities in a game
  • Displaying structured data fetched from an API

Imagine you’re working on a React app and you’ve just fetched an array of user data from your backend. Instead of squinting at a wall of JSON, you can simply:

  .then(response => response.json())
  .then(data => console.table(data));

And voilĂ ! You’ve got a beautifully formatted table of user data that’s much easier to digest.

Console.table() in Node.js

What about Node.js, you ask? Fear not, console.table() has got your back there too. It works just the same, helping you debug your server-side data like a pro. Here’s a quick example using an array of book objects:

const books = [
  { title: 'JavaScript: The Good Parts', author: 'Douglas Crockford' },
  { title: 'You Don't Know JS', author: 'Kyle Simpson' },
  { title: 'Eloquent JavaScript', author: 'Marijn Haverbeke' }


Run your script with node myScript.js, and you’ll see your book data laid out in a neat table right in your terminal.

Browser Compatibility

Before you go off to the races with console.table(), a quick note on compatibility. While it’s widely supported in major browsers, always check MDN’s Console.table() compatibility chart to ensure it works in the environments you’re targeting. It’s rare, but you might find an old browser lurking in the shadows that isn’t quite up to snuff.

Alright, folks! That’s the first half of our console.table() journey. We’ve covered the basics, some customization options, and where this function fits into your debugging toolkit. Stay tuned for the second half, where we’ll dive into advanced usage, troubleshooting, and some pro tips to make console.table() your new best friend in JavaScript development.

Advanced Usage: Diving Deeper into console.table()

Now that we’ve covered the basics, let’s take a deeper dive into some advanced tricks with console.table(). If you thought we were fancy before, you ain’t seen nothing yet!

Sorting Data in console.table()

One of the lesser-known features of console.table() is that you can click on the column headers in the console to sort the table by that column. This isn’t something you can control programmatically, but it’s a nifty feature when manually inspecting data.

Nesting Objects and Arrays

console.table() can handle nested objects and arrays to a certain extent. When you have an array of objects with nested data, the table will display the nested structure as a stringified version. It’s not perfect, but it can give you a quick overview of the data structure.

const nestedCats = [
  { name: 'Fluffy', details: { age: 5, breed: 'Persian' } },
  { name: 'Mittens', details: { age: 3, breed: 'Maine Coon' } }


Limitations and Performance Considerations

While console.table() is incredibly useful, it’s not without its limitations. Large datasets can slow down your console and make the output unwieldy. If you’re dealing with a massive amount of data, it might be better to stick with traditional logging or use pagination in your data display.

Also, remember that console.table() is primarily a development tool. You should avoid using it in production code, as it can impact performance and potentially expose sensitive data.

Troubleshooting Common Issues

Sometimes, you might run into issues where console.table() doesn’t display data as expected. Here are a few common problems and how to fix them:

  • Empty or incomplete tables: Make sure the data you’re passing is not empty and that it’s in the correct format (an array of objects or an object).
  • [Object object] in cells: This happens when trying to display objects or functions directly. Ensure that you’re only trying to display primitive values or provide a custom formatter to handle complex types.

Pro Tips for console.table() Mastery

Ready to level up your console.table() game? Here are some pro tips:

  • Custom Formatting: While console.table() doesn’t allow for custom styles out of the box, you can get creative with your data before passing it to the function. Use computed properties or map through your data to format it just the way you want before displaying it.

  • Combining with For super-organized debugging, combine console.table() with or console.groupCollapsed() to group related tables together.

  • Debugging Loops: When debugging loops that modify data, you can use console.table() inside the loop to see how your data changes with each iteration.

Practical Examples

Let’s look at some practical examples where console.table() can be a game-changer:

Example 1: Debugging a Sorting Function

You’ve written a function to sort books by their title. Use console.table() to check the sorted list:

const sortedBooks = books.sort((a, b) => a.title.localeCompare(b.title));

Example 2: Visualizing API Data

You’re working with a complex API response and want to visualize the data quickly:

  .then(response => response.json())
  .then(data => {
    const simplifiedData = => ({
      value: item.details.value

Example 3: Tracking State Changes in Redux

When using Redux for state management, console.table() can help visualize state changes after actions are dispatched:

store.subscribe(() => {


console.table() is a powerful yet underutilized tool in the JavaScript developer’s debugging arsenal. It brings clarity and structure to your console output, making it easier to understand and debug your data. By mastering console.table(), you can save time, reduce frustration, and maybe even impress a few colleagues along the way.

Remember, the key to effective debugging is not just having the right tools but knowing how to use them. With console.table(), you’re well-equipped to tackle your JavaScript data visualization challenges with style and grace. Happy coding, and may your console always be as elegant as your code!