Konsole : Bereichsbezogen, global

Die Konsolen -API bietet Methoden zum Protokollieren von Nachrichten im Systemprotokoll, zum Erstellen und Stoppen von Timern, zum Erstellen und Protokollieren von Zählern, zum Protokollieren von Stack Traces und zum Gruppieren/Organisieren von zugehörigen Inhalten.

Konsolen -API-Methoden bieten die gleichen Protokollierungsfunktionen wie die Glide-System-API (z. B. gs.info, gs.warn und gs.debug), ermöglichen jedoch Entwicklern, die mit der Protokollierung von Nachrichten mithilfe von Konsolenmethoden vertraut sind, eine reflektivere Verwendung. Auf dem Server können sowohl Konsolen -API- als auch Glide-System -API-Methoden verwendet werden.

Alle Konsolen -API-Methoden sind statisch und eine ServiceNow® -Implementierung der Konsolen-APIvon (Microsoft Developer Network) MDN. Diese API wird als Teil des -Basissystems ServiceNow bereitgestellt und erfordert kein Plugin für den globalen Zugriff. Um diese Klasse in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie den Namespace-Bezeichner sn_console. Aktivieren Sie das Plugin „Console“ (com.glide.console), um auf die Konsolen -API zuzugreifen.

Protokollierungsfunktionen

Protokolle, die mit Konsolen -API-Methoden wie Assert(), Error(), Debug(), Warn(), Info()und Log()erstellt wurden, werden in den Systemprotokollen protokolliert. Insbesondere können Sie in der Anwenderoberfläche Systemprotokolle finden, indem Sie zu navigieren Alle > Systemprotokolle > Systemprotokoll. Unter diesem Menüelement können Sie alle Protokolle oder bestimmte Protokolltypen wie Anwendungsprotokolle, Fehler, Skriptprotokollanweisungen usw. anzeigen. Durch Filtern der Spalte „Quelle“ in der Ansicht „Alle Protokolle“ finden Sie Ihre Einträge schneller.

Zeichenfolgenersetzungen

Sie können null oder mehr Ersetzungszeichenfolgen als ersten Parameter in vielen Konsolen- API-Methoden verwenden, insbesondere in denen, mit denen Sie Nachrichten protokollieren können, z. B. Assert(), Error(), Debug(), Warn(), Info()und Protokoll ().

Ersetzungszeichenfolgen in der Konsolen -API sind Platzhalter, die Sie in einer Protokollnachricht verwenden, um Werte wie Zeichenfolgen oder Zahlen dynamisch einzufügen. Wenn der Code ausgeführt wird, werden diese Platzhalter durch tatsächliche Werte ersetzt, die Sie als zusätzliche Argumente übergeben, und zwar in der Reihenfolge, in der sie angegeben werden. Sie machen Ihre Protokolle flexibler und lesbarer, ohne dass Zeichenfolgen manuell verkettet werden müssen.

Häufige Ersetzungszeichenfolgen:

• %s: Fügt eine Zeichenfolge ein.
• %d oder %i: Fügt eine Zahl ein (Ganzzahl oder Dezimalzahl).
• %f: Fügt eine Gleitkommazahl ein.
• %o: Fügt ein Objekt ein.
• %c: Wendet CSS-Stile auf das Protokoll an (nützlich für die Formatierung der Konsolenausgabe).

Hier ist ein einfaches Beispielskript mit Ersetzungszeichenfolgen:

const name = "Alex";
const age = 25;

console.log("Hello, my name is %s and I am %d years old.", name, age);

Beispielausgabe:

Hello, my name is Alex and I am 25 years old.

Hier ist ein Beispiel für die Verwendung von Ersetzungszeichenfolgen mit CSS-Stilen:

const user = { name: "Alex", role: "Developer" };
console.log("User info: %o", user); // Logs the object
console.log("%cStyled message", "color: blue; font-weight: bold;"); // Adds styles

In der Ausgabe wird die Nachricht „User Info: { Name: „Alex“, Rolle: „Developer“ } in Blau und Fett formatiert.

Mithilfe von Timern

Sie können Konsolen- API-Timer verwenden, um die Dauer eines bestimmten Vorgangs zu berechnen. Um einen Timer zu starten, rufen Sie Konsole – time(Zeichenfolgenbezeichnung) an und weisen ihm mit dem Parameter label einen Namen zu. Sie können maximal 10.000 Timer pro Seite haben. Um einen Timer anzuhalten und die verstrichene Zeit in Millisekunden abzurufen, rufen Sie Konsole – timeEnd(String label) auf, indem Sie den Namen des Timers als Parameter übergeben.

Sie können beispielsweise einen Timer starten, um die verstrichene Zeit zu messen, indem Sie time("Process Duration")aufrufen und dann timeEnd("Process Duration")aufrufen. Darüber hinaus berechnet der Code, wie viel Zeit seit dem Start des Timers verstrichen ist und wann die erste und die zweite Aktion durch Übergabe von Konsole – timeLog(String label, Object valN) im Skript abgeschlossen wurden, und gibt sie aus.

console.time("Process Duration");

alert("Step 1: Click to continue."); // Simulates the first action
console.timeLog("Process Duration", "After Step 1");

alert("Step 2: Do other actions"); // Simulates additional actions
console.timeLog("Process Duration", "After Step 2");

console.timeEnd("Process Duration");

Ausgabe:

• Nach der ersten Warnung:

  Process Duration: 2.345ms After Step 1

• Nach der zweiten Warnung:

  Process Duration: 7.890ms After Step 2

• Wenn der Timer endet:

  Process Duration: 10.123ms

Konsole – Assert(Boolesche Assertion, Objekt val1...valN, Zeichenfolge msg, Zeichenfolge subst1...substN)

Protokolliert eine Fehlermeldung im Systemprotokoll, wenn die Assertion „falsch“ ist. Diese Methode führt keine Aktion aus, wenn die Assertion wahr ist.

Tabelle : 1. Parameter

Name	Typ	Beschreibung
Assertion	Boolean	Optional. Kennzeichnung, die angibt, ob eine allgemeine Meldung protokolliert werden soll, die auf einen Assertionsfehler in Systemprotokollen hinweist. Gültige Werte: true: Protokolliert die Fehlermeldung der Assertion nicht. false: Protokolliert die Assertionsfehlermeldung. Standardwert: false
msg	Zeichenfolge	Erforderlich, wenn val1...valN nicht verwendet wird. Meldung, die in den Systemprotokollen angezeigt werden soll, wenn die Assertion fehlschlägt. Akzeptiert eine Zeichenfolge, die null oder mehr Ersetzungswerte enthält, die mit dem Parameter subst1 through substN festgelegt werden können. Weitere Informationen finden Sie unter „Zeichenfolgenersetzungen“ in Konsole : Bereichsbezogen, global.
subst1...substN	Zeichenfolge	Optional. JavaScript-Werte, durch die Ersetzungszeichenfolgen in msgersetzt werden sollen. Diese Werte werden in der Reihenfolge protokolliert oder angezeigt, in der sie angegeben wurden. Wenn mehr Ersetzungswerte vorhanden sind als Ersetzungszeichenfolgen vorhanden sind, werden die zusätzlichen Werte selbst geschrieben und nach der Nachricht (msg) auf die gleiche Weise angehängt wie wenn keine Formatzeichenfolge vorhanden ist. Weitere Informationen finden Sie unter „Ersetzungszeichenfolgen verwenden“ in Konsole : Bereichsbezogen, global.
val1...valN	Objekt	Erforderlich, wenn msg nicht übergeben wird. Liste zusätzlicher JavaScript-Werte, die nach der Hauptnachricht (msg) angehängt werden sollen und durch ein Leerzeichen oder ein anderes Trennzeichen getrennt sind. Akzeptiert jeden JavaScript-Datentyp, einschließlich Zeichenfolgen oder Objekte, und gibt sie in der angegebenen Reihenfolge aus.

Tabelle : 2. Rückgaben

Typ	Beschreibung
Keine

Grundlegende Assertion

Das folgende Beispiel zeigt, wie Sie Assert() verwenden, um die Fehlermeldung „Math is defekt!“ zu protokollieren. wenn die Assertion (1 + 1 === 3) „falsch“ ist, und keine Aktion, wenn die Assertion (1 + 1 === 2) „wahr“ ist.

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

Ausgabe:

"Math is broken!"

Zusätzliche Werte werden protokolliert

Im folgenden Beispiel wird Assert() mit zusätzlichen Werten übergeben.

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

Ausgabe:

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

Nachrichtenersetzung

Im folgenden Beispiel wird Assert() mit Zeichenfolgen-Ersetzungswerten übergeben.

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

Ausgabe:

"Expected 20 but got 15"

Konsole – count(String label)

Zählt und protokolliert, wie oft count() mit einer angegebenen Bezeichnung aufgerufen wurde.

Die Methode count() ist hilfreich, um nachzuverfolgen, wie oft etwas auftritt, z. B. wie oft ein Codeblock ausgeführt wird oder wie viele Ereignisse in einer Anwendung auftreten. Verwenden Sie Konsole - countReset(String label), um einen Zähler mit einer bestimmten Bezeichnung zurückzusetzen.

Tabelle : 3. Parameter

Name	Typ	Beschreibung
label	Zeichenfolge	Optional. Name für den Zähler. Bei Bezeichnungen wird zwischen Groß- und Kleinschreibung unterschieden, und sie generieren unterschiedliche Zähler in der Ausgabe, wenn die Fälle nicht übereinstimmen. Standard: Wenn nicht angegeben, wird die Bezeichnung auf „Standard“ festgelegt.

Tabelle : 4. Rückgaben

Typ	Beschreibung
Keine

Das folgende Beispiel zeigt, wie die Ausgabe jedes Mal aussieht, wenn die Methode count() mit einer Bezeichnung (z. B. „apple“ oder „banana“) aufgerufen wird. Die Anzahl wird für jede Bezeichnung separat nachverfolgt.

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

Ausgabe:

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

Das folgende Beispiel für count() zeigt, wie die Ausgabe aussieht, wenn keine Zählerbezeichnung angegeben ist und die Bezeichnung „Standard“ erbt.

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

Ausgabe:

default: 1
default: 2
default: 3

Konsole - countReset(String label)

Setzt den angegebenen Zähler auf Null zurück.

Tabelle : 5. Parameter

Name	Typ	Beschreibung
label	Zeichenfolge	Optional. Name des ursprünglich in der Methode Konsole – count(String label) festgelegten Zählers, den Sie auf Null zurücksetzen möchten. Groß-/Kleinschreibung beachten. Standard: Setzt den Standardzähler auf Null zurück. Hinweis: Ein Zähler erhält die Bezeichnung Standard, wenn mit count() ein neuer Zähler ohne definierte Bezeichnung festgelegt wird. Unter Konsole – count(String label) finden Sie weitere Details.

Tabelle : 6. Rückgaben

Typ	Beschreibung
Keine

Das folgende Beispiel zeigt, wie der mit der fünften Iteration der Standardbezeichnung verknüpfte Zähler zurückgesetzt wird:

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

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

Ausgabe:

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

Wenn Sie im folgenden Beispiel die Anwendervariable als Bezeichnungsargument mit der Zeichenfolge „bob“ an den ersten Aufruf von Console.count()und die Zeichenfolge „alice“ an den zweiten Aufruf übergeben:

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

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

Ausgabe Beachten Sie, dass durch das Zurücksetzen des Werts des Zählers „bob“ nur der Wert dieses Zählers geändert wird. Der Wert von „alice“ bleibt unverändert.

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

Konsole – Debug(Objekt val1...valN, Zeichenfolge msg, Zeichenfolge subst1...substN)

Protokolliert eine Debugging-Meldung im Systemprotokoll auf Debug-Ebene oder gibt diese aus.

Die Methode debug() ermöglicht ausführliches Messaging und wird für Nachrichten mit niedriger Priorität oder weniger kritische Debugging-Nachrichten empfohlen. Für Debug-Messaging mit höherer Priorität verwenden Sie Konsole – Protokoll (Objekt val1...val2, Zeichenfolge msg, Zeichenfolge subst1...subst2). Sie können diese Methode beispielsweise verwenden, um für interne Entwickler längere Debugging-Nachrichten zu internen Status oder Flows zu schreiben. Die Nachrichten der debug() -Methode können sich in bestimmten Browsern unterschiedlich verhalten.

Die Methode „console.debug()“ protokolliert Nachrichten in Systemprotokollen in der Instanz ServiceNow®. Sie können diese Protokolle auf der Plattform ServiceNow® in anzeigen Systemprotokolle > Alle oder Systemprotokolle > Debuggen.

Hinweis:

Konsolen -API-Methoden bieten die gleichen Protokollierungsfunktionen wie die Glide-System-API (z. B. gs.info, gs.warn und gs.debug), ermöglichen jedoch Entwicklern, die mit der Protokollierung von Nachrichten mithilfe von Konsolenmethoden vertraut sind, eine reflektivere Verwendung. Auf dem Server können sowohl Konsolen -API- als auch Glide-System -API-Methoden verwendet werden.

Tabelle : 7. Parameter

Name	Typ	Beschreibung
msg	Zeichenfolge	Erforderlich, wenn val1...valN nicht übergeben wird. Die Hauptnachricht oder das Hauptobjekt, das Sie in Systemprotokollen oder in der Ausgabe protokollieren möchten. Akzeptiert eine Zeichenfolge, die null oder mehr Ersetzungswerte enthält, die mit dem Parameter subst1 through substN festgelegt werden können. Weitere Informationen finden Sie unter „Ersetzungszeichenfolgen verwenden“ in Konsole : Bereichsbezogen, global.
subst1...substN	Zeichenfolge	Optional. JavaScript-Werte, durch die Ersetzungszeichenfolgen in msgersetzt werden sollen. Diese Werte werden in der Reihenfolge protokolliert oder angezeigt, in der sie angegeben wurden. Wenn mehr Ersetzungswerte vorhanden sind als Ersetzungszeichenfolgen vorhanden sind, werden die zusätzlichen Werte selbst geschrieben und nach der Nachricht (msg) auf die gleiche Weise angehängt wie wenn keine Formatzeichenfolge vorhanden ist. Weitere Informationen finden Sie unter „Ersetzungszeichenfolgen verwenden“ in Konsole : Bereichsbezogen, global.
val1...valN	Objekt	Erforderlich, wenn msg nicht übergeben wird. Liste zusätzlicher JavaScript-Werte, die nach der Hauptnachricht (msg) angehängt werden sollen und durch ein Leerzeichen oder ein anderes Trennzeichen getrennt sind. Akzeptiert jeden JavaScript-Datentyp, einschließlich Zeichenfolgen oder Objekte, und gibt sie in der angegebenen Reihenfolge aus.

Tabelle : 8. Rückgaben

Typ	Beschreibung
Keine

Im folgenden Beispiel protokolliert Console.debug() Nachrichten in Systemprotokollen in der Instanz 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);

Konsole – Fehler (Objekt val1...valN, Zeichenfolge msg, Zeichenfolge subst1...subsN)

Protokolliert eine Meldung im Systemprotokoll auf Fehlerebene.

Verwenden Sie error(), um kritische Probleme zu protokollieren, die sofortige Aufmerksamkeit erfordern, z. B. ungültige Eingaben, fehlgeschlagene Vorgänge oder um unerwartetes Verhalten zu debuggen.

Hinweis:

Konsolen -API-Methoden bieten die gleichen Protokollierungsfunktionen wie die Glide-System-API (z. B. gs.info, gs.warn und gs.debug), ermöglichen jedoch Entwicklern, die mit der Protokollierung von Nachrichten mithilfe von Konsolenmethoden vertraut sind, eine reflektivere Verwendung. Auf dem Server können sowohl Konsolen -API- als auch Glide-System -API-Methoden verwendet werden.

Tabelle : 9. Parameter

Name	Typ	Beschreibung
msg	Zeichenfolge	Erforderlich, wenn val1...valN nicht übergeben wird. Die Hauptnachricht oder das Hauptobjekt, das Sie in Systemprotokollen oder in der Ausgabe protokollieren möchten. Akzeptiert eine Zeichenfolge, die null oder mehr Ersetzungswerte enthält, die mit dem Parameter subst1 through substN festgelegt werden können. Weitere Informationen finden Sie unter „Ersetzungszeichenfolgen verwenden“ in Konsole : Bereichsbezogen, global.
subst1...substN	Zeichenfolge	Optional. JavaScript-Werte, durch die Ersetzungszeichenfolgen in msgersetzt werden sollen. Diese Werte werden in der Reihenfolge protokolliert oder angezeigt, in der sie angegeben wurden. Wenn mehr Ersetzungswerte vorhanden sind als Ersetzungszeichenfolgen vorhanden sind, werden die zusätzlichen Werte selbst geschrieben und nach der Nachricht (msg) auf die gleiche Weise angehängt wie wenn keine Formatzeichenfolge vorhanden ist. Weitere Informationen finden Sie unter „Ersetzungszeichenfolgen verwenden“ in Konsole : Bereichsbezogen, global.
val1...valN	Objekt	Erforderlich, wenn msg nicht übergeben wird. Liste zusätzlicher JavaScript-Werte, die nach der Hauptnachricht (msg) angehängt werden sollen und durch ein Leerzeichen oder ein anderes Trennzeichen getrennt sind. Akzeptiert jeden JavaScript-Datentyp, einschließlich Zeichenfolgen oder Objekte, und gibt sie in der angegebenen Reihenfolge aus.

Tabelle : 10. Rückgaben

Typ	Beschreibung
Keine

Im folgenden Beispiel zeigt die Ausgabe von error () jeweils den folgenden Code an:

• Im ersten Beispiel wird einfach „Ein Fehler ist aufgetreten!“ angezeigt. in einem fehlerformatierten Format.
• Im zweiten Fall wird „Fehler in Modul: ModuleName“ angezeigt.
• Im dritten wird „Unerwarteter Wert: 42“ angezeigt.

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

Konsole – Gruppe (Zeichenfolgenbezeichnung)

Erstellt eine neue Inline-Gruppe im Systemprotokoll, in der alle nachfolgenden Nachrichten auf einer zusätzlichen Ebene eingerückt werden, bis groupEnd() aufgerufen wird. Verwenden Sie diese Methode, um zugehörige Nachrichten in Ausgabe- und Systemprotokollen visuell zu organisieren und zu gruppieren.

Um eine Gruppierung zu beenden, rufen Sie die Methode Konsole – groupEnd() auf. Die groupEnd()-Methode verringert auch den Einrückvorgang der Gruppe um eine Ebene.

Hinweis:

group() zeigt alle Gruppierungsebenen in der Ausgabe an, die nicht reduzierbar oder erweiterbar sind.

Tabelle : 11. Parameter

Name	Typ	Beschreibung
label	Zeichenfolge	Optional. Bezeichnungsname für die Gruppe, der in der Ausgabe angezeigt werden soll. Standard: Wenn Sie keine Bezeichnung übergeben, gibt group() keinen Text aus, rückt die neue leere Zeile jedoch um eine Ebene ein.

Tabelle : 12. Rückgaben

Typ	Beschreibung
Keine

Im folgenden Beispiel wird log() übergeben, um einen neuen geschachtelten Block zu erstellen, und dann group(), um eingerückte Gruppen zu protokollieren. Bei jedem nachfolgenden Aufruf von group() wird die Zeile auf einer neuen Ebene eingerückt. Das Skript ruft auch groupEnd() auf, um jede Gruppe zu beenden und ihren Einzug um eine Ebene zu verringern.

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...");

Anzeige/Ausgabe:

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...

Das folgende Beispiel zeigt, wie Gruppen eingerückt werden, wenn eine Gruppenbezeichnung festgelegt ist:

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

Ausgabe:

Group 1
  in group 1
     in group 2

Das folgende Beispiel zeigt, wie Gruppen eingerückt werden, wenn keine Gruppenbezeichnung festgelegt ist:

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

Ausgabe:

in group 1

     in group 2

Konsole – groupEnd()

Beendet die mit group() erstellte aktuelle Inline-Gruppe und verringert den Einrück um eine Ebene.

Tabelle : 13. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 14. Ergebnisse

Typ	Beschreibung
Keine

Im folgenden Beispiel wird ein neuer geschachtelter Block erstellt, indem group() aufgerufen wird, um eingerückte Ebenen zu protokollieren. Das Skript übergibt groupEnd(),um die Gruppe zu beenden und ihren Einzug um eine Ebene zu verringern.

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");

Ausgabe:

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

Konsole – info(Objekt val1...valN, Zeichenfolge msg, Zeichenfolge subst1...substN)

Protokolliert eine Nachricht in Systemprotokollen auf Informationsebene.

Hinweis:

Konsolen -API-Methoden bieten die gleichen Protokollierungsfunktionen wie die Glide-System-API (z. B. gs.info, gs.warn und gs.debug), ermöglichen jedoch Entwicklern, die mit der Protokollierung von Nachrichten mithilfe von Konsolenmethoden vertraut sind, eine reflektivere Verwendung. Auf dem Server können sowohl Konsolen -API- als auch Glide-System -API-Methoden verwendet werden.

Tabelle : 15. Parameter

Name	Typ	Beschreibung
msg	Zeichenfolge	Erforderlich, wenn val1...valN nicht übergeben wird. Die Hauptnachricht oder das Hauptobjekt, das Sie in Systemprotokollen oder in der Ausgabe protokollieren möchten. Akzeptiert eine Zeichenfolge, die null oder mehr Ersetzungswerte enthält, die mit dem Parameter subst1 through substN festgelegt werden können. Weitere Informationen finden Sie unter „Ersetzungszeichenfolgen verwenden“ in Konsole : Bereichsbezogen, global.
subst1...substN	Zeichenfolge	Optional. JavaScript-Werte, durch die Ersetzungszeichenfolgen in msgersetzt werden sollen. Diese Werte werden in der Reihenfolge protokolliert oder angezeigt, in der sie angegeben wurden. Wenn mehr Ersetzungswerte vorhanden sind als Ersetzungszeichenfolgen vorhanden sind, werden die zusätzlichen Werte selbst geschrieben und nach der Nachricht (msg) auf die gleiche Weise angehängt wie wenn keine Formatzeichenfolge vorhanden ist. Weitere Informationen finden Sie unter „Ersetzungszeichenfolgen verwenden“ in Konsole : Bereichsbezogen, global.
val1...valN	Objekt	Erforderlich, wenn msg nicht übergeben wird. Liste zusätzlicher JavaScript-Werte, die nach der Hauptnachricht (msg) angehängt werden sollen und durch ein Leerzeichen oder ein anderes Trennzeichen getrennt sind. Akzeptiert jeden JavaScript-Datentyp, einschließlich Zeichenfolgen oder Objekte, und gibt sie in der angegebenen Reihenfolge aus.

Tabelle : 16. Rückgaben

Typ	Beschreibung
Keine

Im folgenden Beispiel werden mit der info() -Methode zwei Informationen protokolliert: die Datensatznummer und die Priorität des aktuellen Formulars. Diese Methode ist nützlich für schnelle Überprüfungen beim Debuggen oder Überprüfen von Daten im Formular.

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
}

Konsole – Protokoll (Objekt val1...val2, Zeichenfolge msg, Zeichenfolge subst1...subst2)

Protokolliert eine Nachricht in Systemprotokollen.

Hinweis:

Konsolen -API-Methoden bieten die gleichen Protokollierungsfunktionen wie die Glide-System-API (z. B. gs.info, gs.warn und gs.debug), ermöglichen jedoch Entwicklern, die mit der Protokollierung von Nachrichten mithilfe von Konsolenmethoden vertraut sind, eine reflektivere Verwendung. Auf dem Server können sowohl Konsolen -API- als auch Glide-System -API-Methoden verwendet werden.

Tabelle : 17. Parameter

Name	Typ	Beschreibung
msg	Zeichenfolge	Erforderlich, wenn val1...valN nicht übergeben wird. Die Hauptnachricht oder das Hauptobjekt, das Sie in Systemprotokollen oder in der Ausgabe protokollieren möchten. Akzeptiert eine Zeichenfolge, die null oder mehr Ersetzungswerte enthält, die mit dem Parameter subst1 through substN festgelegt werden können. Weitere Informationen finden Sie unter „Ersetzungszeichenfolgen verwenden“ in Konsole : Bereichsbezogen, global.
subst1...substN	Zeichenfolge	Optional. JavaScript-Werte, durch die Ersetzungszeichenfolgen in msgersetzt werden sollen. Diese Werte werden in der Reihenfolge protokolliert oder angezeigt, in der sie angegeben wurden. Wenn mehr Ersetzungswerte vorhanden sind als Ersetzungszeichenfolgen vorhanden sind, werden die zusätzlichen Werte selbst geschrieben und nach der Nachricht (msg) auf die gleiche Weise angehängt wie wenn keine Formatzeichenfolge vorhanden ist. Weitere Informationen finden Sie unter „Ersetzungszeichenfolgen verwenden“ in Konsole : Bereichsbezogen, global.
val1...valN	Objekt	Erforderlich, wenn msg nicht übergeben wird. Liste zusätzlicher JavaScript-Werte, die nach der Hauptnachricht (msg) angehängt werden sollen und durch ein Leerzeichen oder ein anderes Trennzeichen getrennt sind. Akzeptiert jeden JavaScript-Datentyp, einschließlich Zeichenfolgen oder Objekte, und gibt sie in der angegebenen Reihenfolge aus.

Tabelle : 18. Rückgaben

Typ	Beschreibung
Keine

Das folgende Beispiel zeigt, wie Sie mit log() die Datensatznummer und den aktuellen Status des Formulars in Systemprotokollen protokollieren.

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
}

Konsole – time(Zeichenfolgenbezeichnung)

Startet einen Timer, mit dem Sie nachverfolgen können, wie lange ein Vorgang dauert.

Sie können jedem Timer einen eindeutigen Namen geben und auf einer bestimmten Seite bis zu 10.000 Timer ausführen. Wenn Sie die Konsolenmethode timeEnd() mit demselben Bezeichnungsnamen aufrufen, gibt der Zähler die Zeit in Millisekunden aus, die seit dem Starten des Timers verstrichen ist. Verwenden Sie die timeLog()-Methode der Konsole, um die verstrichene Zeit zwischen der Start- und Stoppzeit des Timers zu protokollieren.

Beispiele zur Verwendung dieser Methode mit anderen zeitbasierten Konsolen- API-Methoden finden Sie unter „Verwenden von Zeitgebern“ in Konsole : Bereichsbezogen, global.

Tabelle : 19. Parameter

Name	Typ	Beschreibung
label	Zeichenfolge	Optional. Name für den neuen Timer. Beim Aufruf von Konsole – timeEnd(String label) denselben Namen verwenden, um den Timer zu stoppen und die verstrichene Zeit an der Konsole auszugeben. Maximale Anzahl Timer: 10.000 Standard: Verwendet die Bezeichnung „Standard“, wenn weggelassen.

Tabelle : 20. Rückgaben

Typ	Beschreibung
Keine

Im Folgenden wird gezeigt, wie Sie mit time("label") einen Timer mit der Bezeichnung "label" starten. Die Methode „console.timeEnd("label")" stoppt den Timer mit derselben Bezeichnung und protokolliert die verstrichene Zeit. In diesem Beispiel wird die Zeit gemessen, die zum Abrufen und Protokollieren der Nummer und Priorität des Datensatzes benötigt wird.

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
}

Konsole – timeEnd(String label)

Stoppt einen angegebenen Timer, der zuvor durch den Aufruf von time()gestartet wurde.

Beispiele zur Verwendung dieser Methode mit anderen zeitbasierten Konsolen- API-Methoden finden Sie unter „Verwenden von Zeitgebern“ in Konsole : Bereichsbezogen, global.

Tabelle : 21. Parameter

Name	Typ	Beschreibung
label	Zeichenfolge	Optional. Name des Timers, der angehalten werden soll. Nach dem Anhalten wird in der Konsole automatisch die verstrichene Zeit angezeigt, zusammen mit einem Indikator, der angibt, dass die Zeit abgelaufen ist. Diese Bezeichnung muss mit dem im Parameter Konsole – time(Zeichenfolgenbezeichnung) label angegebenen Timer übereinstimmen. Groß-/Kleinschreibung beachten. Standard: Wenn keine Angabe erfolgt, wird die Bezeichnung „Standard“verwendet.

Tabelle : 22. Rückgaben

Typ	Beschreibung
Keine

Das folgende Beispiel zeigt, wie Sie mit time("label") einen Timer mit der Bezeichnung "label" starten. Die Methode „console.timeEnd("label")" hält den Timer mit derselben Bezeichnung an; „console.log()“ protokolliert die verstrichene Zeit. In diesem Beispiel wird die Zeit zum Abrufen gemessen und die Anzahl und Priorität des Datensatzes in Systemprotokollen protokolliert.

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
}

Konsole – timeLog(String label, Object valN)

Protokolliert den aktuellen Wert eines angegebenen Timers im Systemprotokoll.

Beispiele zur Verwendung dieser Methode mit anderen zeitbasierten Konsolen- API-Methoden finden Sie unter „Verwenden von Zeitgebern“ in Konsole : Bereichsbezogen, global.

Tabelle : 23. Parameter

Name	Typ	Beschreibung
label	Zeichenfolge	Optional. Name des Timers für die Protokollierung bei der Konsole. Muss mit dem im Parameter Konsole – time(Zeichenfolgenbezeichnung) label angegebenen Timer übereinstimmen, Groß-/Kleinschreibung beachten. Standard: Verwendet die Bezeichnung „Standard“, wenn weggelassen.
valN	Objekt	Optional. Zusätzliche Werte, die nach der Timer-Ausgabe protokolliert werden sollen. Akzeptiert ein unstrukturiertes Objekt, das jeden Datentyp mit spezieller Verarbeitung für Zeichenfolgen unterstützt.

Tabelle : 24. Rückgaben

Typ	Beschreibung
Keine

Im folgenden Beispiel wird veranschaulicht, wie timeLog() mit dem Bezeichnungswert eines Timers aufgerufen wird, der zuvor mit der Methode time() gestartet wurde. Die Methode timeLog() protokolliert den aktuellen Wert eines Timers.

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

Wenn der Name des Timers ausgelassen wird, wird der Timer „Standard“genannt:

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

Wenn kein entsprechender Timer vorhanden ist, protokolliert Console.timeLog() eine Warnung wie:

Timer "timer name" doesn't exist.

Nach der Timer-Ausgabe können Sie zusätzliche Werte in der Konsole protokollieren:

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

In einem anderen Beispiel startet Console.time('Timer') einen Timer mit der Bezeichnung „Timer“. „console.timeLog('Timer')“ protokolliert die verstrichene Zeit zusammen mit optionalen zusätzlichen Nachrichten. Console.timeEnd('Timer') stoppt den Timer und protokolliert die gesamte verstrichene Zeit.

console.time('Timer');

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

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

Protokollausgabe:

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

Konsole – Trace(Objektobjekte)

Protokolliert einen Stack Trace im Systemprotokoll auf der Informationsebene.

Tabelle : 25. Parameter

Name	Typ	Beschreibung
objects	Objekt	Optional. Mindestens null Objekte, die zusammen mit der Ablaufverfolgung an der Konsole ausgegeben werden sollen. Objekte werden auf die gleiche Weise zusammengestellt und formatiert, als würden sie an die Methode Konsole – Protokoll (Objekt val1...val2, Zeichenfolge msg, Zeichenfolge subst1...subst2) übergeben. Standard: Gibt den gesamten Stapel in der Ausgabe zurück.

Tabelle : 26. Rückgaben

Typ	Beschreibung
Keine

Das folgende Beispiel zeigt, wie Trace() das Nachrichten -Trace-Beispiel zusammen mit dem Stack Trace protokolliert.

function firstFunction() {
    secondFunction();
}

function secondFunction() {
    thirdFunction();
}

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

firstFunction();

Der Stack Trace zeigt die Aufrufreihenfolge: thirdFunction wurde von zweiteFunktionaufgerufen, welche von firstFunctionaufgerufen wurde, und so weiter. Konsolen-Trace('Trace-Beispiel') protokolliert das Meldungs -Trace-Beispiel zusammen mit dem Stack Trace.

Ausgabe:

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

Konsole – warn(Object val1...valN, String msg, String subst1...subst2)

Protokolliert eine Warnmeldung im Systemprotokoll auf der Stufe „Warnung“.

Hinweis:

Konsolen -API-Methoden bieten die gleichen Protokollierungsfunktionen wie die Glide-System-API (z. B. gs.info, gs.warn und gs.debug), ermöglichen jedoch Entwicklern, die mit der Protokollierung von Nachrichten mithilfe von Konsolenmethoden vertraut sind, eine reflektivere Verwendung. Auf dem Server können sowohl Konsolen -API- als auch Glide-System -API-Methoden verwendet werden.

Tabelle : 27. Parameter

Name	Typ	Beschreibung
msg	Zeichenfolge	Erforderlich, wenn val1...valN nicht übergeben wird. Die Hauptnachricht oder das Hauptobjekt, das Sie in Systemprotokollen oder in der Ausgabe protokollieren möchten. Akzeptiert eine Zeichenfolge, die null oder mehr Ersetzungswerte enthält, die mit dem Parameter subst1 through substN festgelegt werden können. Weitere Informationen finden Sie unter „Ersetzungszeichenfolgen verwenden“ in Konsole : Bereichsbezogen, global.
subst1...substN	Zeichenfolge	Optional. JavaScript-Werte, durch die Ersetzungszeichenfolgen in msgersetzt werden sollen. Diese Werte werden in der Reihenfolge protokolliert oder angezeigt, in der sie angegeben wurden. Wenn mehr Ersetzungswerte vorhanden sind als Ersetzungszeichenfolgen vorhanden sind, werden die zusätzlichen Werte selbst geschrieben und nach der Nachricht (msg) auf die gleiche Weise angehängt wie wenn keine Formatzeichenfolge vorhanden ist. Weitere Informationen finden Sie unter „Ersetzungszeichenfolgen verwenden“ in Konsole : Bereichsbezogen, global.
val1...valN	Objekt	Erforderlich, wenn msg nicht übergeben wird. Liste zusätzlicher JavaScript-Werte, die nach der Hauptnachricht (msg) angehängt werden sollen und durch ein Leerzeichen oder ein anderes Trennzeichen getrennt sind. Akzeptiert jeden JavaScript-Datentyp, einschließlich Zeichenfolgen oder Objekte, und gibt sie in der angegebenen Reihenfolge aus.

Tabelle : 28. Rückgaben

Typ	Beschreibung
Keine

Im folgenden Beispiel wird mit warn() eine Warnmeldung protokolliert, die normalerweise hervorsticht (z. B. mit Warnsymbol oder gelbem Text). In diesem Beispiel wird die Priorität des Datensatzes überprüft: Wenn sie hoch ist (Priorität ==="1" ), wird eine Warnmeldung protokolliert. Wenn sie nicht hoch ist, wird eine weniger dringende Notiz mit dem aktuellen Prioritätswert protokolliert.

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);
    }
}

Daher protokolliert oder zeigt warn() den Fehler wie folgt an:

• Für hohe Priorität: ⚠ Warnung: Dies ist ein Incident mit hoher Priorität! Sofortige Aufmerksamkeit erforderlich.
• Für andere Prioritäten: ⚠„Hinweis: Die Priorität ist nicht hoch“. Aktuelle Priorität: 3