Here’s a pretty straightforward problem…
I’ve got a bunch of NextJS projects in the air that depend on this template, which uses the Redux Toolkit for state management. I’m writing ES6 code that is getting transpiled to ES5 during build, and testing it with Mocha + Chai.
I’ve written a lot of tests on both back-end and front-end processes, but none over Redux. No excuses… I’m pretty new to Redux and have been focused on learning and using it at the expense of testing it, which is just as dumb as it sounds.
Anyway, now I’m making heavy use of Redux Toolkit’s
createEntityAdapter and I am totally out of excuses. So yesterday I started writing tests, and I immediately ran into trouble.
TL/DR: If you’re testing ES6 code referencing Redux in a transpiled build environment and have installed the new JSX Transform, you can save yourself a lot of trouble by putting your tests into JSX files.
By the time you read this, I will have incorporated all this stuff into my template, so for context here’s a link to the most recent release that doesn’t yet address this problem.
Some points to note:
The project is a CommonJS package. It has to be, because on build Babel is going to transpile all of our sweet ES6 code down into ES5.
It’s a React project, so there are a lot of JSX files, which thanks to the new JSX Transform know how to behave like ES6 code.
Because we’re in CommonJS land, Node will assume that any JS file in the project is a CommonJS module, meaning it won’t support any ES6 features like
importstatements. So if we want to write an ES6 module, we have to put it into an MJS file. This includes tests, which of course will want to
importall of our sweet ES6 code.
Now here’s something odd. If you look at the /state directory, where I keep all my Redux code, you will notice two things:
- I’m performing ES6-style imports.
- The files all have JS extensions.
These are all JS files because they grew up around a bunch of JS sample code. Nothing ever broke, so I never thought about fixing it.
Weird, right? I still don’t understand exactly why that is, but there it is.
In its state as linked above, everything works fine. The project builds, the front end works, and the one dummy test executes and passes. No problems.
Now let’s introduce some entity state.
I don’t want this to become a whole disquisition on
createEntityAdapter, so just know that this is a layer in the Redux Toolkit that gives you what amounts to a NoSQL database inside Redux. Super useful. But since you are now interacting with your Redux Store via this intermediate layer—which you need to configure—it makes sense to add some test support.
I’m going to make three changes in the repo:
I’m going to add a new
entitySlice.jsto manage state for a generalized entity record that consists of a unique entityKey and timestamps indicating when the record was created and last updated. We’ll add actions to let us add, update, and remove entities, and a selector that lets us fetch an array of all entities or just one by entityKey. Why is this a JS file? I’m just following the weird pattern I already described above.
I’m going to update
store.jsto integrate the new entitySlice into the Redux store. Why is this a JS file? Same reason.
I’m going to write
Here’s the commit. Pretty straightforward, right?
The project built just fine. My first indication I had a problem was when I tried to TEST it. The Mocha command line just gave up without offering anything useful, but Mocha Test Explorer offered this in the sidebar:
Doesn’t look like much, but clicking on it gave me this:
Now that’s interesting! On the face of it, it looks like the weirdness I described above—where somehow I get to use ES6 syntax in my Redux-related JS files—has finally come back to bite me.
Ok, fair enough. Probably long past time I took care of that anyway. So I refactored all of my Redux-related JS files to MJS extensions, including any
include references to them.
Here’s the commit. That ought to do it, right?
Not so fast. The project still builds, but now Mocha shows a different error:
Now that just seems perverted. Why is the Redux Toolkit a CommonJS module? Seems like they would have worked that out by now. Nevertheless, there’s a workaround right in the error message, let’s try it out.
I replaced each Redux Toolkit import with the two-step suggested in the error message. Here’s the commit. NOW we’re good, right?
No. Not good. Now the BUILD fails! Here’s the error:
I tried a couple of desperate moves (i.e.
import * as ReduxToolkit from...) with similar results. No joy.
I mean Redux is only the single most popular state management system in modern software development. W the actual F is going on here?
Yes, we do not currently ship our package in a fully Node-ESM compatible way. (Frankly this entire situation has been incredibly confusing for me every time I try to do research on it.)
I’ve been advised that making any changes to our setup along those lines, such as adding an exports field, would be considered a breaking change that requires a major version. As such, it’s not something we can really even consider until whenever we get around to working on an RTK 2.0 version, and currently there’s no specific timeline for when we’ll try to do that.
See #958 for some related notes.
So it appears that right now the only reliable way to use Redux from ES6 code is by laundering it through a transpiler. Which, with all due respect to Mark and team at ReduxJS who are putting out an incredible product for freesies, is NOT okay.
Translation: Not the way I wish software worked! Lord knows I know how hard this is, and I don’t mean to cast any aspersions on the Redux team! They’re doing a bang-up job and for free. Scholars and gentlemen, every one of them. I just wish this were easier. Now quit punching me, Twitter!
Anyway… what to do?
There’s another article I haven’t written yet, and it’s about testing React code using Mocha + Chai and the React Testing Library in a NextJS project. But the problem I ran into was superficially similar: React components expressed in JS files got completely different results pre-Babel when imported by test scrips vs post-Babel in the build process. The error messages were all on the ES6/CommonJS boundary.
The TL/DR on that one was laughably simple: I just converted all my React components to JSX files (which they probably should have been to begin with) and let the new JSX Transform do its thing. At the end, the tests ran and the build succeeded. Problem solved.
So this got me to thinking…
My Redux tests have nothing to do with React. But they do seem to need the kind of special handling that the JSX transform provides. What if I just converted all my MJS test files (at least the ones that reference Redux) to JSX files?
So I did that. Here’s the commit. And the result?
Works perfectly! All the tests show up where they belong in the Mocha Test Explorer sidebar and they run as expected. The project builds and runs as expected.
But what’s the larger lesson here?
The map is not the territory. A JSX file is not a React component, and it has no obligation to contain one. It’s just a bunch of text that will be parsed in a particular way, according to your development environment’s configuration. If you have a use case where that parsing would be beneficial, then use a JSX file.
P.S. In my rush to get this done and get back to work, I committed my test file before actually RUNNING the tests. So of course there were some typos. This release ties everything up with a bow, and all the tests actually pass.