Getting back to writing articles after spending the better part of a month fighting off a sinus infection and helping my wife get over a nasty cold. Normally I love northeast Ohio, but I’m so over winter right now.
Candidates fail to write proper method signatures. They get confused about what type of list they should use. Some start with List of integers
List<Integer>ints. They fail to see how they will store a
He asks candidates to write test cases. Let’s start with a simple stub file and a test - I’m using Mocha here.
Of course, since we’re just throwing the original array right back out, it immediately bombs. Not so useful! But on the plus side, this gives us a nice test harness for executing the file, so let’s dig into this further. I’m going to
it.skip() our first test here to reduce test clutter while we work our way back into this. First, let’s make sure we’re handling a couple of straightfoward base cases correctly, such as single-element arrays that aren’t a sub-array:
Okay. Now let’s try a multi-element array with no sub-arrays:
Alrighty then… wait, what? Why is it saying that
[1, 2] doesn’t equal
[1, 2]? We need to check using
deepEqual instead of just
equal - it’s a bit much to get into here, but this link goes into a quick overview of the differences. Interestingly, using
equal works fine on single-element arrays and doesn’t try to tell you that
 are equal.
Change the assertion and the tests pass:
Moving on, now we should be able to focus all our attention on the
processArrayItem function since that’s going to be doing most of the rest of the work. Currently, it naively pushes each array item into the result array, assuming that it’s a single element and not a sub-array. Clearly not what we want here so let’s see what we can do about that. We’ll add a test and then write some code to see if we can get it to go green.
So yeah, that didn’t quite work; the recursive function worked perfectly, but since it returned its results all at once. I anticipated this and added a bit of
console.loging; you can see we got back an array that got pushed into the results array as a single element, and puts us right back around where we started.
So… how do we attack this? Since we’re already using Ramda, we could just use the
concat method for this:
That works! Of course, if we’re using Ramda… we could’ve also just called
R.flatten on this and then called it a day. :)
I’m also looking at my original flatten function and realizing it’s a bit redundant. We’re flattening an array; of course it’s going to take array objects! So… we don’t actually need to have everything inside a nested “is this an array?” check. Let’s remove that and replace it with a simple guard clause.
Since we have tests, we can see we didn’t break anything there. Let’s go ahead and try un-skipping that more complicated test and applying that
deepEqual fix to it and see if we get the behavior we’re wanting.
Oh - but we don’t have a test case for that guard clause! We know everything works when we pass in an array. Let’s also make sure we get the expected behavior if we just pass in a bare element - it should “flatten” it into a single element array. I’ll note I’ve broken with good practice here; by the strict approach to TDD, I should have written a test for this prior to even adding that guard clause. However - I think it can be okay to be a little lax while you’re spiking concepts (or blogging :)), but even so, let’s clean this up.
Huh… well, crap. Let’s tweak that guard clause:
… and that gets it. Note that the
instanceof check needs to be wrapped in extra parentheses to negate it within an
if statement; it took me a while to run that one down.
All that aside, we’ve accumulated a bit of clutter here; we don’t actually need the initial check for single-length arrays, since our processArrayItem function will handle that scenario just fine. Let’s go ahead and strip that out and see what happens:
We’re not returning the same object anymore, so we need to fix our test to use
deepEqual there too… and that gets it.
Next up - we don’t actually need to use ramda’s
forEach built in to the array object. It also has a
And to recap, here’s what our tests look like right now - I made a minor tweak to keep the result versus test values consistently ordered across tests, since that’s more readable while debugging.
All of the tests run and pass. It’s a relatively functional approach; our
flatten function doesn’t have any external side effects and we’re not using any explicit ‘for’ loops with an index (I generally dislike these). We could replace the
if statement in the
forEach with a Ramda
cond matcher, but honestly - that feels like massive overkill, especially since we don’t actually need Ramda for anything else. So, in this case, I think I’d advocate keeping it simple and not introducing a substantial dependency that I don’t really need.
The only thing I don’t particularly care for is using the
concat method; it feels like we’re cheating a bit since we’re getting another array back in some cases and shoving it into our results array. This works, and it solves the problem - but I don’t totally like it.
One approach would be adding an accumulator to our
flatten function allowing us to pass in the original result array, if it exists, and simply append more values to that. Let’s try it! We’ll write a quick
accumulatingFlatten function and then just change the
module.exports to return that for the flatten function instead; that’ll let us see if all our tests still work.
Awesome. Still works.
This post got a bit long - I try to post fairly substantial code examples, because I find posts with lots of small snippets hard to follow. Hopefully it’s a useful discussion of how you’d reason your way through a toy problem like this, with some demonstration of testing thrown in for good measure. It bears repeating, though - this is a code golf problem, but please don’t write your own array flattening function for production use. Lodash and Ramda are both well-written, extensively-tested libraries that already have a method for this, and you’re better off just using that.