11.2.2 Requiring JS

[p-b-west]

Relative requires are resolved by first looking at the current namespace and then resolving a relative path from that name. In the above example we are in demo/app.cljs to the ./bar require resolve to demo/bar.js, so it is identical to (:require ["/demo/bar"]).

IMPORTANT | The files must not be physically located in the same directory. The lookup for the file appears on the classpath instead. This is unlike node which expects relative requires to always resolve to physical files.

Thomas, I find this IMPORTANT comment obscure.

[thheller]

It refers back to the classpath chapter.

But it is basically an internal detail and could probably be left out. It is important from an implementation perspective but not so much for the user.

[thheller]

In node if demo/app.js tried to require("./bar") it would fail.

.
├── package.json
└── src
    └── main
        └── demo
            └── app.js
    └── js
        └── demo
            └── bar.js

Due to the classpath it will work in shadow-cljs.