Assertion de base

L’exemple suivant montre comment utiliser assert() pour enregistrer le message d’erreur « Math is broken ! » lorsque l’assertion (1 + 1 === 3) est fausse, et ne fait rien lorsque l’assertion (1 + 1 === 2) est vraie.

console.assert(1 + 1 === 2, "This won't be logged."); // Assertion is true, nothing happens.
console.assert(1 + 1 === 3, "Math is broken!");

Sortie :

"Math is broken!"

Journalisation des valeurs supplémentaires

L’exemple suivant passe assert() avec des valeurs supplémentaires.

let x = 5, y = 10;
console.assert(x + y === 20, "Expected 20, got", x + y);

Sortie :

"Expected 20, got 15" // (because x + y is 15)

Substitution de message

L’exemple suivant passe assert() avec des valeurs de substitution de chaîne.

let expected = 20, actual = 15;
console.assert(expected === actual, "Expected %d but got %d", expected, actual);

Sortie :

"Expected 20 but got 15"

L’exemple suivant montre à quoi ressemble la sortie chaque fois que la méthode count() est appelée avec une étiquette (par exemple, 'apple' ou 'banana'). Le nombre est suivi séparément pour chaque étiquette.

console.count('apple');
console.count('banana');
console.count('apple');
console.count('apple');
console.count('banana');

Sortie :

apple: 1
banana: 1
apple: 2
apple: 3
banana: 2

L’exemple count() suivant montre à quoi ressemble la sortie lorsqu’une étiquette de compteur n’est pas fournie, héritant d’une étiquette « par défaut ».

console.count();
console.count();
console.count();

Sortie :

default: 1
default: 2
default: 3

L’exemple suivant montre comment réinitialiser le compteur associé à la 5ème itération de l’étiquette par défaut :

function greet(user) {
  console.count();
  return 'hi ${user}'
}

greet("bob");
greet("alice");
greet("alice");
console.count();
console.countReset();

Sortie :

"default: 1"
"default: 2"
"default: 3"
"default: 4"
"default: 0"

Dans l’exemple suivant, si vous passez la variable user en tant qu’argument label avec la chaîne « bob » à la première invocation de console.count() et la chaîne « alice » à la seconde :

function greet(user) {
  console.count(user);
  return'hi ${user}'
}

greet("bob");
greet("alice");
greet("alice");
console.countReset("bob");
console.count("alice");

Sortie. Notez que la réinitialisation de la valeur du compteur « bob » ne modifie que la valeur de ce compteur. La valeur de « alice » est inchangée.

"bob: 1"
"alice: 1"
"alice: 2"
"bob: 0"
"alice: 3"

Dans l’exemple suivant, console.debug() consigne les messages dans les journaux système de l’instance ServiceNow® .

(function executeRule(current, previous /*null when async*/) {
    // Logging at different levels for debugging
    console.debug("Business rule triggered for record: " + current.getDisplayValue());
    
    // Example: Check and log a field value
    if (current.priority == 1) {
        console.debug("High-priority incident detected: " + current.number);
    } else {
        console.debug("Incident priority is not high. Priority: " + current.priority);
    }

    // Perform some logic
    if (current.state == 1) {
        current.state = 2;
        gs.debug("State updated from 'New' to 'In Progress' for record: " + current.number);
    }
})(current, previous);

console.error("An error occurred!");
console.error("Error in module:", "ModuleName");
console.error("Unexpected value: %d", 42);

L’exemple suivant transmet log() pour créer un nouveau bloc imbriqué, puis group() pour consigner les groupes en retrait. Chaque appel suivant à group() met la ligne en retrait à un nouveau niveau. Le script appelle également groupEnd() pour terminer chaque groupe et réduire son retrait d’un niveau.

console.log("Start logging...");
console.group("Group 1");
console.log("Inside Group 1 - Message 1");
console.log("Inside Group 1 - Message 2");
console.group("Nested Group");
console.log("Inside Nested Group - Message 1");
console.groupEnd();
console.log("Back to Group 1 - Message 3");
console.groupEnd();
console.log("End logging...");

Affichage/sortie :

Start logging...
    Group 1
        Inside Group 1 - Message 1
        Inside Group 1 - Message 2
            Nested Group
                Inside Nested Group - Message 1
        Back to Group 1 - Message 3
End logging...

L’exemple suivant montre comment les groupes sont mis en retrait lorsqu’une étiquette de groupe est définie :

console.group("Group 1");
console.log("in group 1");
console.group();
console.log("in group 2");

Sortie :

Group 1
  in group 1
     in group 2

L’exemple suivant montre comment les groupes sont mis en retrait lorsqu’une étiquette de groupe n’est pas définie :

console.group(); // no label passed
console.log("in group 1");
console.group();
console.log("in group 2");

Sortie :

in group 1

     in group 2

L’exemple suivant crée un nouveau bloc imbriqué en appelant group() pour consigner les niveaux indentés. Le script passe groupEnd() pour terminer le groupe et réduire son retrait d’un niveau.

console.log("This is the outer level");
console.group();
console.log("Level 2");
console.group();
console.log("Level 3");
console.warn("More of level 3");
console.groupEnd();
console.log("Back to level 2");
console.groupEnd();
console.log("Back to the outer level");

Sortie :

This is the outer level
    Level 2
        Level 3
        ⚠️ More of level 3
    Back to level 2
Back to the outer level

L’exemple suivant utilise la méthode info() pour consigner deux informations : le numéro d’enregistrement et la priorité du formulaire actuel. Cette méthode est utile pour les vérifications rapides lors du débogage ou de la vérification des données dans le formulaire.

function onLoad() {
    console.info("Form loaded for record:", g_form.getValue("number")); // Log the record number
    console.info("Current priority is:", g_form.getValue("priority"));  // Log the priority
}

L’exemple suivant montre comment utiliser log() pour consigner le numéro d’enregistrement et l’état actuel du formulaire dans les journaux système.

function onLoad() {
    console.log("Form loaded for record:", g_form.getValue("number")); // Log the record number
    console.log("Current state is:", g_form.getValue("state")); // Log the state
}

Ce qui suit montre comment utiliser le temps (« étiquette ») pour démarrer un minuteur avec l’étiquette « étiquette ». La méthode console.timeEnd(« label ») arrête le minuteur avec la même étiquette et consigne le temps écoulé. Dans cet exemple, il mesure le temps nécessaire pour récupérer et journaliser le numéro et la priorité de l’enregistrement.

function onLoad() {
    console.time("Form load processing time"); // Start timing

    // Example: Simulate some processing
    var recordNumber = g_form.getValue("number");
    console.log("Record number is:", recordNumber);

    var priority = g_form.getValue("priority");
    console.log("Priority is:", priority);

    console.timeEnd("Form load processing time"); // End timing and log duration
}

L’exemple suivant montre comment utiliser time(« label ») pour démarrer un minuteur avec l’étiquette « label ». La méthode console.timeEnd(« label ») arrête le minuteur avec la même étiquette ; console.log() enregistre le temps écoulé. Dans cet exemple, il mesure le temps nécessaire pour récupérer et consigne le numéro et la priorité de l’enregistrement dans les journaux système.

function onLoad() {
    console.time("Form load processing time"); // Start timing

    // Example: Simulate some processing
    var recordNumber = g_form.getValue("number");
    console.log("Record number is:", recordNumber);

    var priority = g_form.getValue("priority");
    console.log("Priority is:", priority);

    console.timeEnd("Form load processing time"); // End timing and log duration
}

L’exemple suivant montre comment appeler timeLog() à l’aide de la valeur d’étiquette d’un minuteur précédemment démarré à l’aide de la méthode time( ). La méthode timeLog() consigne la valeur actuelle d’un minuteur.

console.time("reticulating splines");
reticulateSplines();
console.timeLog("reticulating splines");
// reticulating splines: 650ms

Si le nom du minuteur est omis, il est nommé « default » :

console.time();reticulateSplines();
console.timeLog();// default: 780ms

S’il n’y a pas de minuteur correspondant, console.timeLog() consigne un avertissement comme :

Timer "timer name" doesn't exist.

Vous pouvez enregistrer des valeurs supplémentaires dans la console après la sortie du minuteur :

console.time();reticulateSplines();
console.timeLog("default","Hello","world");// default: 780ms Hello world

Dans un autre exemple, console.time('Timer') démarre un minuteur avec l’étiquette « Timer ». console.timeLog('Timer') consigne le temps écoulé ainsi que les messages supplémentaires facultatifs. console.timeEnd('Timer') arrête le minuteur et enregistre le temps total écoulé.

console.time('Timer');

setTimeout(() => {
    console.timeLog('Timer', 'Halfway done');
}, 1000);

setTimeout(() => {
    console.timeLog('Timer', 'Almost done');
    console.timeEnd('Timer');
}, 2000);

Sortie du journal :

Timer: 1000ms Halfway done
Timer: 2000ms Almost done
Timer: 2000ms

L’exemple suivant montre comment trace() consigne l’exemple de trace de message avec la trace de la pile.

function firstFunction() {
    secondFunction();
}

function secondFunction() {
    thirdFunction();
}

function thirdFunction() {
    console.trace('Trace example');
}

firstFunction();

La trace de la pile montre la séquence d’appel : thirdFunction a été appelée par secondFunction, qui a été appelée par firstFunction, et ainsi de suite. Le fichier console.trace ('exemple de trace') consigne l’exemple de trace du message avec la trace de la pile.

Sortie :

Trace example
    at thirdFunction (<filename>:8:13)
    at secondFunction (<filename>:4:5)
    at firstFunction (<filename>:2:5)

L’exemple suivant utilise warn() pour consigner un message d’avertissement, généralement stylisé pour se démarquer (par exemple, avec une icône d’avertissement ou du texte jaune). Cet exemple vérifie la priorité de l’enregistrement : si elle est élevée (priorité ==="1 » ), il enregistre un message d’avertissement. Si elle n’est pas élevée, il enregistre une note moins urgente avec la valeur de priorité actuelle.

function onLoad() {
    var priority = g_form.getValue("priority");

    if (priority === "1") {
        console.warn("Warning: This is a high-priority incident! Immediate attention required.");
    } else {
        console.warn("Note: Priority is not high. Current priority:", priority);
    }
}