Une introduction à Node.js

Il n'existe pas, à l'heure à laquelle je rédige ce billet (NDLR 22/09/2011), de "package" officiel de Node.js pour Debian/Ubuntu. L'installation est cependant assez simple. Pour installer la dernière version (stable) depuis le dépôt officiel GIT, il suffit de saisir les commandes suivantes :

mkdir ~/src
cd ~/src
git clone https://github.com/joyent/node.git
cd ~/src/node
git checkout v0.6.12
sudo mkdir /opt/node
./configure --prefix=/opt/node
make
sudo make install
echo 'export PATH=$PATH:/opt/node/bin' >> ~/.profile
echo 'export NODE_PATH=/opt/node:/opt/node/lib/node_modules' >> ~/.profile
source ~/.profile

L'installation va se faire dans le répertoire /opt/node.

Pour vérifier que Node.js est bien installé sur votre machine :

# node -v
v0.6.12

On commence par éditer un fichier hello.js contenant le code suivant :

//
// A JavaScript based on Node.js and VNStat
//
// Nicolas Hennion (aka) Nicolargo
//
// GPL v3.0
//
 
var http = require('http');
var url = require('url');
var spawn = require ('child_process').spawn;
 
//**********
// Variables
//**********
 
var listenport = 1337;
 
//**********
// Functions
//**********
 
// Chomp function (delete the \n)
String.prototype.chomp = function () {
    return this.replace(/(\n|\r)+$/, '');
};
 
// HTTP request
function onRequest(req, res) {
    console.log("New request: "+req.url);
    res.writeHead(200, {'Content-Type': 'text/plain'});
    res.write('Hello World');
    res.end();
};
 
//*************
// Main program
//*************
 
// Create the HTTP server
http.createServer(onRequest).listen(listenport);
 
// Get the hostname (FQDN)
var listenaddress = spawn('hostname', ['-f']);
listenaddress.stdout.on('data', function (data) {
    var fqdn = new String(data);
    console.log('Server running listenning http://'+fqdn.chomp()+':'+listenport+'/');
});

Puis on lance le nœud (node) avec la commande :

# node ./hello.js
 
Server running listenning http://VotreMachine:1337/

Il ne reste plus (après avoir autorisé les requêtes vers le port TCP 1337 si vous avez un Firewall sur votre machine de test) qu'à pointer une page du navigateur Web vers l'URL donnée par la commande pour voir affiché le résultat :

On commence par initialiser les fonctions de Node.js dont on a besoin (voir la liste dans la documentation officielle). Pour notre exemple, nous avons besoin de générer un serveur HTTP (http) et de lancer une commande système (spawn) récupérant le nom FQDN de la machine.

var http = require('http');
var spawn = require ('child_process').spawn;

Après la définition d'une variable globale (contenant le numéro TCP du port d'écoute du serveur) ainsi que d'une fonction enlevant le caractère de retour à la ligne d'une chaîne (chomp), on passe au vif du sujet en générant un serveur HTTP :

// Create the HTTP server
http.createServer(function (req, res) {
    res.writeHead(200, {'Content-Type': 'text/plain'});
    res.end('Hello World\n');
}).listen(listenport);

Cette commande est "forké" (elle génère donc un daemon HTTP écoutant sur le port listenport et renvoyant le message texte 'Hello World'). Enfin on affiche dans la console l'URL du serveur :

// Get the hostname (FQDN)
var listenaddress = spawn('hostname', ['-f']);
listenaddress.stdout.on('data', function (data) {
    var fqdn = new String(data);
    console.log('Server running listenning http://'+fqdn.chomp()+':'+listenport+'/');
});

Pour étendre les fonctions de base de Node.js, il faut utiliser l'utilitaire NPM (Node Package Manager). Grâce à lui, il est possible d'ajouter des packages à Node.js.

Pour installer NPM :

curl http://npmjs.org/install.sh | sudo sh -c 'export PATH=$PATH:/opt/node/bin ; export NODE_PATH=/opt/node:/opt/node/lib/node_modules ; sh'

Je vous laisse ensuite regarder la documentation puis la liste des packages disponibles.

Bien évidemment, ce billet n'est qu'une simple introduction à ce framework (d'où le titre). Le code donné en exemple peut sûrement être optimisé, mais son objectif est avant tout pédagogique. Je reviendrai rapidement sur ce sujet en proposant des développements basés sur Node.js pour la supervision de nos belles machines.

Sources ayant inspiré ce billet :

• le site officiel de Node.js ;
• Node.js : le livre du débutant ;

L'équipe Web remercie Nicolargo pour la rédaction de ce tutoriel.

Nous tenons à remercier ClaudeLELOUP et FirePrawn pour leur relecture attentive de cet article.