Une introduction à Node.js

| Nicolargo | Bovino |

Node.js est un framework implémentant, côté serveur, la version 8 du moteur JavaScript de Google (pour une présentation rapide, je vous conseille de parcourir ces quelques slides).

L'objectif de cet article est d'installer Node.js sur votre machine GNU/Linux et d'exécuter votre premier programme (hello.js).

Commentez

- Titre : Une introduction à Node.js

- Auteurs : Nicolargo, Bovino

- Parution : 13 mars 2012

- Licence : Le contenu de cet article est rédigé par Nicolargo et est mis à disposition selon les termes de la Licence Creative Commons Attribution 3.0 non transposé. Les logos Developpez.com, en-tête, pied de page, css, et look & feel de l'article sont Copyright ® 2013 Developpez.com.

Sommaire

- Installation de Node.js

- Un premier exemple, ou le fameux "Hello world !"

- Détail du code

- Les modules avec NPM

- Aller plus loin

- Remerciements

Installation de 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

Un premier exemple, ou le fameux "Hello world !"

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 :

Détail du code

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+'/');
});

Les modules avec NPM

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.

Aller plus loin

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 ;

Remerciements

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.