API serveurs - natives

Dans cette section, nous allons voir quelques exemples d’APIs natives de Node.js.

API native File System

L’API File System est une API native de Node.js qui permet de manipuler les fichiers et les répertoires.

fs.mjs

// Example de l'API native NodeJs File System

// Importation du module fs
import fs from 'fs';

// Création d'un fichier
fs.writeFile('example.txt', 'Hello, World!', (err) => {
    if (err) throw err;
    console.log('File created successfully');
});

// Lecture d'un fichier
fs.readFile('example.txt', 'utf8', (err, data) => {
    if (err) throw err;
    console.log(data);
});

// Renommer un fichier
fs.rename('example.txt', 'example2.txt', (err) => {
    if (err) throw err;
    console.log('File renamed successfully');
});

Pour exécuter ce code, il faudra créer un fichier fs.mjs et l’exécuter avec Node.js en ligne de commande :

node fs.mjs

Prenez un moment pour lire et tester ce code sur votre machine, cela vous permettra de vérifier que Node.js est bien installé et fonctionne correctement.

Remarque

L’utilisation d’un fichier .mjs permet d’utiliser les modules ES6 dans Node.js sans avoir à définir un fichier de configuration (comme package.json ou tsconfig.json).

API native HTTP

L’API HTTP est une API native de Node.js qui permet de créer des serveurs web et de faire des requêtes HTTP.

http.mjs

// Exemple d'utilisation de l'API HTTP native de Node.js qui permet de créer des serveurs web et de faire des requêtes HTTP

import http from 'http';

// Création d'un serveur web
const server = http.createServer((req, res) => {
    // On définit le code de statut de la réponse à 200 (OK)
    res.statusCode = 200;
    // On définit le type de contenu de la réponse à text/plain
    res.setHeader('Content-Type', 'text/plain');
    // On envoie la réponse au client
    res.end('Hello World\n');
});

// Le serveur écoute sur le port 3000
server.listen(3000,  () => {
    console.log('Server running at http://localhost:3000/');
});

Pour exécuter ce code, il faudra créer un fichier http.mjs et l’exécuter avec Node.js en ligne de commande :

node http.mjs
> Server running at http://localhost:3000/

Prenez un moment pour lire et tester ce code sur votre machine.

API native Events

L’API Events est une API native de Node.js qui permet de gérer des événements.

events.mjs

// Exemple d'utilisation de l'API Events native de Node.js qui permet de gérer des événements.

// Import du module Events de Node.js
import EventEmitter from 'events';

// Création d'un nouvel objet EventEmitter
const eventEmitter = new EventEmitter();

// On écoute l'événement 'hello' et on affiche le message reçu
eventEmitter.on('hello', (message) => {
    console.log(`Message reçu : ${message}`);
});

// On émet l'événement 'hello' avec le message 'Hello World!'
eventEmitter.emit('hello', 'Hello World!');

// On émet l'événement 'hello' avec le message 'Bonjour le monde!'
eventEmitter.emit('hello', 'Bonjour le monde!');

Pour exécuter ce code, il faudra créer un fichier events.mjs et l’exécuter avec Node.js en ligne de commande :

node events.mjs

Prenez un moment pour lire et tester ce code sur votre machine.

Conclusion

• Les APIs natives de Node.js permettent de réaliser des opérations système, réseau, sur les fichiers, etc.
• Elles sont intégrées à Node.js et ne nécessitent pas d’installation supplémentaire.
• Il ne faut pas confondre le Javascript client et le Javascript serveur, qui s’exécutent dans des environnements différents (navigateur vs Node.js).

Dans la section suivante, nous allons voir des exemples d’API tierces.