I recently created my first script in Node JS, which automates user creation on a Nuxeo server. I’d like to share my experience about it. Objective of this blog is to let you understand what are the basic things we need to know when using Node JS.
How execution looks like?
Before implementing the script, you need to understand how the script will be executed. A Node JS script can be executed from command line as follows:
When using a new dependency, you need to declare it in the
There’re several ways to declare it: if it’s a normal dependency, declare it
in the “dependencies” node; if it’s a development dependency, declare it in
the “devDependencies” node. More explanation about them, see StackOverflow -
What’s the difference between dependencies, devDependencies and peerDependencies
in npm package.json file? For example, using library “prompt” can be
declared as follows:
After having declared your new dependencies, you can do a
npm install to
install them. The dependencies will then installed into the
directory. If you don’t understand expression “^1.0.0”, take a look at Npm
semver calculator: it can do the calculation for you.
Arguments are important because they allow user to provide data dynamically.
Arguments are handled by
process.argv, which is an array. Use it to check
whether user provides correct number of arguments, and consume arguments. Note
node is the first argument (index=0), your script is the 2nd argument
(index=1), so user arguments start at index 2.
Template literals are string literals allowing embedded expressions. You can use
multi-line strings and string interpolation features with them. For example,
create a username using variable
For more detail, see MDN: Template literals.
Iteration: For-Loop, ForEach, and Map
When doing automation in script, a collection of elements is often used: a map, an array, a set, etc. It’s important to understand how to iterate over these objects. There’re 3 major ways to do it: using a for-loop statement, the forEach() method, or the map() method.
The Promise object represents the eventual completion (or failure) of an asynchronous operation, and its resulting value. Since it’s asynchronous, we need to have a clear timeline in our head, and be very careful about the implementation.
In my script, user creations are HTTP requests, represented as a collection of
promises. I use
Promise.all() to group all the creation promises together, and
consider them as a single promise. This single promise is resolved when all the
user creations have been resolved. As for failure, Promise.all() fails fast—it
rejects with the reason of the first promise that rejects.
In this post, we talked about the basics of creating a simple script in Node.JS, including execution syntax, dependency declaration, using arguments, template literals, different iterations and promises for asynchronous operations. Hope you enjoy this post, see you next time.