When creating web applications, developers can use functional programming, which offers benefits such as data immutability, concurrency, stability, and scalability. Functional programming is best supported by languages like Clojure but not by JavaScript. The good news is that ClojureScript compiles Clojure code into JavaScript, which can be executed in a browser or Node.js.
In this article, we’ll learn about ClojureScript, its advantages over Vanilla JavaScript, and its differences from other languages. The included code samples will show you how to get started and create a program with ClojureScript on your local machine.
Jump ahead:
To follow along with this tutorial, you’ll need:
ClojureScript is a compiler for Clojure that compiles to JavaScript and creates web applications. The difference between ClojureScript and Clojure is that Clojure targets Java-based environments, while ClojureScript targets JavaScript.
Programs written in Clojure can be compiled to or emit JavaScript code using the ClojureScript compiler, which also supports JavaScript libraries. Essentially, ClojureScript combines JavaScript’s interoperability with Clojure’s vast benefits. Hence, ClojureScript compiles to JavaScript code and runs in the browser or Node.js.
ClojureScript uses the Google Closure tool, which manages libraries and dependencies and also minimizes code size. It’s important to note that with ClojureScript, code is stored as data. At the time of writing, the latest version is v1.11.60.
ClojureScript offers several advantages compared to other apps that only use JavaScript, including:
Although multiple languages can be compiled in JavaScript, ClojureScript has some major differences when compared to the others. Let’s take a look:
CoffeeScript is like Python and Ruby and has a straightforward syntax that aids in development. Its primary goal is to increase productivity by reducing verbosity. However, ClojureScript increases the program’s overall speed while CoffeeScript does not.
Dart is a type-safe language that makes apps for several platforms and compiles to JavaScript. It was developed by Google to replace JavaScript and has a verbose syntax. However, ClojureScript, which supports the code as data philosophy, has a significantly more straightforward syntax that is understandable by both humans and machines. As a result, it has a robust macro system.
While TypeScript and JavaScript have comparable syntaxes and semantics to ClojureScript, they differ from one another. In essence, TypeScript is static-typed JavaScript and inherits almost all of JavaScript’s issues. Unfortunately, layering a type system can only go so far as to address those issues. While JavaScript carries the baggage of having bad semantics and other issues, ClojureScript is a superior language because it yields more reusable code.
Similar to how TypeScript compiles to JavaScript, PureScript is strictly functional and rigorously typed. PureScript is written in Haskell and has a Haskell-like syntax, but was created to work with Node.js while ClojureScript is written in Clojure.
Next, we’ll start configuring ClojureScript for our project. Make sure that you have installed the prerequisites.
Depending on your OS, there are different requirements for installing ClojureScript. To find the installation commands that work with your OS, consult the official documentation. For simple project interaction, ClojureScript offers REPLs.
Create a directory to host your project to use ClojureScript. Then, launch your terminal and enter:
mkdir clojure-program
By permitting and implementing modularity through namespaces, ClojureScript enables you to logically arrange functions and variables for later use inside your program. Declaring namespaces and referencing functions in modules is easy if your project follows the naming convention. To do this, we’ll make a unique namespace for this project.
Create an src folder in the directory using your favorite code editor to store the project’s source code. Then, inside of your src, make a new folder named cljscript_program that will hold your app.cljs ClojureScript file.
Then, in the app.cljs, make a namespace with the ns keyword and the filename that produces the following message:
(ns cljscript_program.app)
(println "My first ClojureScript program!")
Next, make a deps.edn file in the project directory with a list of every dependency that your project has. ClojureScript is the sole dependency you’ll use for this program.
{:deps {org.clojure/clojurescript {:mvn/version "1.11.54"}}}
The cljs.main namespace is required to run your ClojureScript program. It contains functions with multiple usecases to initiate an interactive REPL session. Depending on the task, you can access and specify numerous arguments and flags with cljs.main.
Run the following command to see a list of available command-line arguments:
clj -M -m cljs.main --help
The arguments will be listed in your terminal once you run the command:
To compile, run, and launch an REPL session for your ClojureScript program, run the command in the project directory for your OS.
For Windows OS, run this command:
java -cp "cljs.jar;src" cljs.main --compile hello-world.core --repl
For macOS or Linux OS:
clj -M --main cljs.main --compile cljscript_program.app --repl
Let’s review the arguments we specified:
--main: specifies and invokes cljs.main, which contains the functions needed to run your program--repl: starts an REPL session allowing you to communicate with your program while it is executing--compile: Builds your programFollowing the program execution, .cpcache and out will be generated in the project directory, and an REPL session will launch in the terminal. We should also write the following to the prompt as the string My first ClojureScript program!:
It will display a browser window at localhost:9000:
Now that your program is up and running, you can write code and interact with it via the REPL.
Using the defn naming function, create a ClojureScript function in app.cljs that returns the total of two numbers and binds to the variable total:
(defn total [x y] (+ x y) )
You’ll require the following clauses to run your program and communicate with it in your REPL:
require: lets you define how many namespaces to load:reload: loads the namespace:as: enables you to specify a shorter version name to be used as a namespace referenceThere are various methods in ClojureScript for requiring your namespace. Run the following command from the REPL prompt:
(require '[cljscript_program.app :as cljscript] :reload)
This command requires and creates the alias cljscript, then reloads your namespace.
After that, use the alias as a reference to invoke the function defined in your namespace.
(cljscript/total 20 40)
You should see 60 displayed in your terminal after selecting the enter key at the prompt:
In this article, we investigated ClojureScript and its advantages over Vanilla JavaScript. We covered how ClojureScript differs from CoffeeScript, Dart, TypeScript, and PureScript in how it compiles to JavaScript. We also showed how to install and run a ClojureScript program.
Install LogRocket via npm or script tag. LogRocket.init() must be called client-side, not
server-side
Learn more →
$ npm i --save logrocket
// Code:
import LogRocket from 'logrocket';
LogRocket.init('app/id');
// Add to your HTML:
<script src="https://cdn.lr-ingest.com/LogRocket.min.js"></script>
<script>window.LogRocket && window.LogRocket.init('app/id');</script>
Would you be interested in joining LogRocket's developer community?
Join LogRocket’s Content Advisory Board. You’ll help inform the type of content we create and get access to exclusive meetups, social accreditation, and swag.
Sign up now
Use NVM, Node Version Manager, to switch between Node.js versions, simplifying your development process.
Tired of version conflicts with Node.js? NVM lets you switch between multiple versions easily, ensuring your projects always run smoothly with the right environment.
sort()method: From basics to custom sortingDiscover how to sort arrays in JavaScript using sort() and toSorted(), including customization and language-sensitive sorting techniques.
With Redis’ license change and the launch of Valkey 8.0 as an alternative, this guide covers key differences and migration steps.
