Utiliser les documentations JavaScript

Il est possible de déclarer des constantes avec le mot-clé const.

const pi = { value: 3.1415, description: "Pi est  le rapport constant de la circonférence d'un cercle à son diamètre dans un plan euclidien" }

pi = { value: 3.1416, description: "Pi, appelé parfois constante d'Archimède, est  le rapport constant de la circonférence d'un cercle à son diamètre dans un plan euclidien" }

Le code ci-dessus renvoie l'erreur TypeError: Assignment to constant variable car pi est protégé par const.

Cependant, la page Types et grammaire du MDN nous apprend que les valeurs d'un objet, même déclaré avec const ne sont pas protégées.

const pi = { value: 3.1415, description: "Pi est  le rapport constant de la circonférence d'un cercle à son diamètre dans un plan euclidien" }

pi.value = 3.1416

Ainsi, ce code ne renvoie pas d'erreur et une valeur présente dans un objet déclaré avec const a été modifiée.

En JavaScript, il faut préciser quand une fonction a besoin de paramètres. Cette page du MDN montre que l'on peut donner des valeurs par défaut aux paramètres de fonction.

/** Cette fonction ajoute un utilisateur à la base de données

  si cette fonction est appelée sans argument "nickname",

  c'est la chaîne de caractère "JohnDoe" qui est donnée par défaut

*/

function addUser (database, id, nickname = 'JohnDoe') {

  database.push([id, nickname])

  console.log('Ajout de ' + id + ' à la base de données.')

  return database

}

let db = [[1, 'Alice']] // Pour l'exemple, "db" remplace une base de données distante.

db = addUser(db, 2, 'Bob')

db = addUser(db, 3)

console.log(db)

Un développeur qui souhaite retenir les heures d'inscriptions à son site web va vite se retrouver face à des problèmes d'incohérences de fuseaux horaires si ses utilisateurs sont dans différentes régions du monde.

Il pourrait être intéressant de stocker, dans la base de données, uniquement l'heure UTC et le fuseau horaire de l'utilisateur.

Pour cela, un nouveau tour sur la page des dates du MDN nous indique qu'il existe une méthode getTimezoneOffset qui retourne la différence en minutes entre l'heure locale de l'utilisateur et l'heure UTC.

/** Cette fonction ajoute un message à une base de données */

function logMessage (database, msg, user, time) {

  database.push([msg, user, time.getTime() + time.getTimezoneOffset() * 60, time.getTimezoneOffset()])

  console.log('Message ajouté à la base de données')

  return database

}

let db = [] // Pour l'exemple, "db" remplace une base de données distante.

db = logMessage(db, 'Un message de Alice', 'Alice', new Date())

console.log(db)

Dans l'exemple ci-dessus, on imagine un service de messagerie qui aurait besoin de stocker les messages d'un utilisateur à une base de données.

La fonction database.push() prend en argument un tableau contenant le message, l'utilisateur, l'heure d'envoi sommé à la différence de minutes à l'heure UTC pour obtenir l'heure UTC et en dernier argument le fuseau horaire.

Ici, getTimezoneOffset() est multiplié par 600 pour obtenir des secondes car time.getTime() est en millisecondes.

JavaScript, contrairement à un grand nombre de langages de programmation, possède un type unique pour les entiers et les flottants. Le MDN nous apprend sur la page Structures de données que le type Number permet en réalité de représenter les nombres de -(2^53 - 1) à 2^53 - 1.

En dehors de cet intervalle, JavaScript ne renvoie pas d'erreur mais ne représente plus les nombres de manière sure. C'est-à-dire qu'ils deviennent des approximations qui peuvent créer des bugs difficiles à corriger.

Sur cette même page, on apprend qu'il existe le type BigInt qui permet justement de représenter les entiers en dehors de l'intervalle de Number. Un BigInt se reconnaît par un « n » à la fin du nombre.

/** Cette variable contient le nombre de lignes

  d'une table de base de données.

  Ici, on imagine 1000000.

*/

let numberOfRows = 2 ** 50

/** On souhaite stocker ce nombre de ligne

  avec le bon type (number/bigint) afin

  de le manipuler ailleurs dans le code

  sans avoir de problèmes.

*/

if (numberOfRows >= Number.MAX_SAFE_INTEGER) {

  numberOfRows = BigInt(numberOfRows)

}

/** On peut désormais continuer ce code sans problème

  de type entre Number et BigInt.

*/

console.log(typeof (numberOfRows))

• concat : pour concaténer au moins deux chaînes ensemble.

const hello = "Bonjour"

const world = "tout le monde"

console.log(hello.concat(' ', world))

// affiche "Bonjour tout le monde"

• includes : renvoie true si une chaîne contient la chaîne donnée comme argument.

const names = ['Alice', 'Jean-Marie', 'Charlie']

for (const name of names) {

  console.log(`Le prénom ${name} ${name.includes('-') ? 'est' : "n'est pas"} composé`)

}

// Pour chaque prénom, affiche qu'il est composé si il inclut le caractère - (trait d'union).

La page de la méthode includes indique aussi que cette dernière est sensible à la casse.

• split : divise une chaîne selon un séparateur et renvoie un tableau avec les différents éléments.

let receivedInfo = 'Luke:Skywalker:luke.sky@rebels.net:Jedi Master'

receivedInfo = receivedInfo.split(':')

const luke = {

  firstname: receivedInfo[0],

  lastname: receivedInfo[1],

  email: receivedInfo[2],

  title: receivedInfo[3]

}

console.log(luke)

• toUpperCase : retourne la chaîne en majuscule, l'exemple précédent pourrait donner :

let receivedInfo = 'Luke:Skywalker:luke.sky@rebels.net:Jedi Master'

receivedInfo = receivedInfo.split(':')

const luke = {

  firstname: receivedInfo[0],

  lastname: receivedInfo[1].toUpperCase(),

  email: receivedInfo[2],

  title: receivedInfo[3]

}

console.log(luke)

Cette erreur est fréquente et facilement compréhensible. Sa page sur le MDN nous indique qu'elle apparaît lorsqu'une variable « x » est référencée mais n'existe pas (pas déclarée) dans la portée utilisée. On y retrouve aussi des exemples pour reproduire cette erreur avec des variables non déclarées ou hors de portée.

Zoom

const hello = 'hello world'

if ('hello' in hello) {

  console.log('hello se trouve dans la chaîne de caractère ' + hello)

}

Le code ci-dessus pourrait paraître normal pour un développeur Python qui s'est habitué à utiliser le mot-clé in pour savoir si une chaîne se trouve dans une autre.

En JavaScript, ce code renvoie une erreur.

Une consultation de la page MDN de cette erreur explique que in ne fonctionne que sur les objets (pour vérifier si une propriété existe), et non sur les chaînes de caractères.

Une erreur de syntaxe est levée lorsqu'une constante n'est pas initialisée. En effet, les constantes doivent être initialisée à la déclaration contrairement aux variables déclarées avec let ou var, même s'il s'agit d'une bonne pratique.

Là-aussi, la page de cette erreur sur le MDN donne des conseils au développeur dans la partie Résoudre le problème, par exemple en suggérant que ce n'est probablement pas une constante qu'il faut déclarer si cette erreur surgit. En effet, une constante est généralement connue au moment de la déclaration..