Konsole – Umfang, Global

Die Konsole Die 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 Stapelverfolgungen und zum Gruppieren/Organisieren von zugehörigen Inhalten.

Konsole API-Methoden bieten die gleiche Protokollierungsfunktion wie Glide-System-API (Z. B. gs.info, gs.warn und gs.debug), ermöglichen Sie jedoch Entwicklern, die mit der Protokollierung von Nachrichten mit Konsolenmethoden vertraut sind, eine flexiblere Verwendung. Beides Konsole API und Glide-System API-Methoden können auf dem Server verwendet werden.

Alle Konsole API-Methoden sind statisch und sind ein ServiceNow® Implementierung von MDN (Microsoft Developer Network) Konsolen-API . Diese API wird als Teil von bereitgestellt ServiceNow Basissystem und erfordert kein Plugin, um global darauf zuzugreifen. Um diese Klasse in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie sn_Console Namespace-Bezeichner. Aktivieren Sie das Plugin „Konsole“ (com.Glide.Console), um auf zuzugreifen Konsole API.

Protokollierungsfunktionen

Protokolle, die mit generiert wurden Konsole API-Methoden, z. B. Assert() , Fehler () , Debuggen() , Warnung() , Info() , Und Protokoll() , Werden in den Systemprotokollen protokolliert. Insbesondere können Sie Systemprotokolle in der Anwenderoberfläche finden, indem Sie zu navigieren Alle > Systemprotokolle > Systemprotokollan. Unter diesem Menüelement können Sie alle Protokolle oder bestimmte Protokolltypen wie Anwendungsprotokolle, Fehler, Skriptprotokollanweisungen usw. anzeigen. Filtern der Spalte „Quelle“ in Alle Die Protokollansicht kann helfen, Ihre Einträge schneller zu finden.

Zeichenfolgenersetzungen

Sie können null oder mehr Ersetzungszeichenfolgen als ersten Parameter in vielen verwenden Konsole API-Methoden, insbesondere solche, mit denen Sie Nachrichten wie protokollieren können Assert() , Fehler () , Debuggen() , Warnung() , Info() , Und Protokoll() .

Ersetzungszeichenfolgen in Konsole 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, in der angegebenen Reihenfolge. Sie machen Ihre Protokolle flexibler und lesbarer, ohne Zeichenfolgen manuell verketten zu müssen.

Allgemeine 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-Stil:

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

Die Ausgabe formatiert die Nachricht Anwenderinformationen: { Name: „Alex“, Rolle: „Entwickler“ } In Blau und Fett.

Mit Timern

Sie können verwenden Konsole API-Timer zur Berechnung der Dauer eines bestimmten Vorgangs. Um einen Timer zu starten, rufen Sie an Konsole – Time (Zeichenfolgenbezeichnung) Und weisen Sie ihm einen Namen mit zu labelParameter. Sie können maximal 10.000 Timer pro Seite haben. Um einen Timer anzuhalten und die verstrichene Zeit in Millisekunden abzurufen, rufen Sie an Konsole – timeEnd (Zeichenfolgenbezeichnung) Indem der Name des Timers als Parameter übergeben wird.

Sie können beispielsweise einen Timer starten, um die Zeit zu messen, die der Anruf vergeht Zeit("Prozessdauer") , Und rufen Sie dann an TimeEnd("Prozessdauer") . Darüber hinaus berechnet und gibt der Code aus, wie viel Zeit seit dem Start des Timers verstrichen ist und wann die erste und zweite Aktion durch Übergeben abgeschlossen wurde Konsole – timeLog(Zeichenfolgenbezeichnung, Objekt ValN) Im Skript.

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, Object val1...valN, Zeichenfolgennachricht, Zeichenfolge subst1...substN)

Protokolliert eine Fehlermeldung in Systemprotokollen, wenn die Assertion „falsch“ ist. Diese Methode bewirkt nichts, wenn die Assertion „wahr“ ist.

Tabelle : 1. Parameter

Name	Typ	Beschreibung
Assertion	Boolean	Optional. Kennzeichnung, die angibt, ob eine generische Nachricht, die einen Assertionsfehler in Systemprotokollen anzeigt, protokolliert werden soll. Gültige Werte: Wahr: Protokolliert die Assertionsfehlermeldung nicht. Falsch: Protokolliert die Assertionsfehlermeldung. Standardwert: false
msg	Zeichenfolge	Erforderlich, wenn val1...valNWird nicht verwendet. Nachricht, die in Systemprotokollen angezeigt werden soll, wenn die Assertion fehlschlägt. Akzeptiert eine Zeichenfolge, die null oder mehr Ersetzungswerte enthält, die mit festgelegt werden können subst1 through substNParameter. Weitere Informationen finden Sie unter „Zeichenfolgenersetzungen“ Konsole – Umfang, Global.
Subst1...substN	Zeichenfolge	Optional. JavaScript-Werte, in denen Ersetzungszeichenfolgen ersetzt werden sollen msg. Diese Werte werden in der angegebenen Reihenfolge protokolliert oder angezeigt. Wenn mehr Ersetzungswerte vorhanden sind als Ersetzungszeichenfolgen vorhanden sind, werden die zusätzlichen Werte, die selbst geschrieben werden, nach der Nachricht ( msg) Auf die gleiche Weise wie wenn keine Formatzeichenfolge vorhanden ist. Siehe „Ersetzungszeichenfolgen verwenden“ in Konsole – Umfang, Global Weitere Informationen finden Sie unter .
Val1...ValN	Objekt	Erforderlich, wenn msgWurde nicht übergeben. Liste zusätzlicher JavaScript-Werte, die nach der Hauptnachricht ( msg), und werden durch ein Leerzeichen oder ein anderes Trennzeichen getrennt. Akzeptiert jeden JavaScript-Datentyp, einschließlich Zeichenfolgen oder Objekten, und gibt sie in der angegebenen Reihenfolge aus.

Tabelle : 2. Rückgaben

Typ	Beschreibung
Keine

Grundlegende Assertion

Das folgende Beispiel zeigt die Verwendung Assert() Zum Protokollieren der Fehlermeldung „Math ist defekt!“ Wenn die Assertion (1 + 1 == 3) auf „falsch“ festgelegt ist und nichts geschieht, wenn die Assertion (1 + 1 == 2) auf „wahr“ festgelegt 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

Das folgende Beispiel ist erfolgreich Assert() Mit zusätzlichen Werten.

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

Das folgende Beispiel ist erfolgreich Assert() Mit Zeichenfolgenersetzungswerten.

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

Ausgabe:

"Expected 20 but got 15"

Konsole – count(Zeichenfolgenbezeichnung)

Zählt und protokolliert, wie oft dies geschieht Anzahl() Wurde mit einer angegebenen Bezeichnung aufgerufen.

Die Anzahl() Die Methode 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 Konsole – countReset(Zeichenfolgenbezeichnung) Zum Zurücksetzen eines Zählers mit einer bestimmten Bezeichnung.

Tabelle : 3. Parameter

Name	Typ	Beschreibung
label	Zeichenfolge	Optional. Name, der dem Zähler zugewiesen werden soll. Bei Bezeichnungen wird zwischen Groß- und Kleinschreibung unterschieden und es werden verschiedene Zähler in der Ausgabe generiert, 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 Anzahl() Die Methode wird mit einer Bezeichnung aufgerufen (z. B. „Apple“ oder „Banana“). 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

Folgendes Anzahl() Das Beispiel zeigt, wie die Ausgabe aussieht, wenn keine Zählerbezeichnung angegeben wird, wobei die Bezeichnung „Standard“ geerbt wird.

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

Ausgabe:

default: 1
default: 2
default: 3

Konsole – countReset(Zeichenfolgenbezeichnung)

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

Tabelle : 5. Parameter

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

Tabelle : 6. Rückgaben

Typ	Beschreibung
Keine

Das folgende Beispiel zeigt, wie der Zähler zurückgesetzt wird, der der 5. Iteration der Standardbezeichnung zugeordnet ist:

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"

Im folgenden Beispiel, wenn Sie bestehen Anwender Variable als Bezeichnung Argument mit der Zeichenfolge „bob“ für den ersten Aufruf von Console.count() , Und die Zeichenfolge „alice“ zur zweiten:

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 das Zurücksetzen des Werts des Zählers „bob“ nur den Wert dieses Zählers ändert. Der Wert von „alice“ ist unverändert.

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

Konsole – Debuggen(Object val1...valN, Zeichenfolgennachricht, Zeichenfolgensubst1...substN)

Protokolliert eine Debugging-Nachricht oder gibt sie an das Systemprotokoll auf Debug-Ebene aus.

Die Debuggen() Die Methode ermöglicht ausführliches Messaging und wird für Debugging-Nachrichten mit niedriger Priorität oder weniger kritischer Priorität empfohlen. Für Debug-Messaging mit höherer Priorität verwenden Konsole – log(Object val1...val2, Zeichenfolgennachricht, Zeichenfolgensubst1...subst2). Sie können diese Methode beispielsweise verwenden, um längere Debugging-Nachrichten für interne Entwickler über interne status oder Flows zu schreiben. Die Debuggen() Methodennachrichten können sich zwischen bestimmten Browsern unterschiedlich verhalten.

Die console.debug() Die Methode protokolliert Nachrichten in Systemprotokollen in ServiceNow® Instanz. Sie können diese Protokolle im anzeigen ServiceNow® Plattform in Systemprotokolle > Alle oder Systemprotokolle > Debuggenan.

Hinweis:

Konsole API-Methoden bieten die gleiche Protokollierungsfunktion wie Glide-System-API (Z. B. gs.info, gs.warn und gs.debug), ermöglichen Sie jedoch Entwicklern, die mit der Protokollierung von Nachrichten mit Konsolenmethoden vertraut sind, eine flexiblere Verwendung. Beides Konsole API und Glide-System API-Methoden können auf dem Server verwendet werden.

Tabelle : 7. Parameter

Name	Typ	Beschreibung
msg	Zeichenfolge	Erforderlich, wenn val1...valNWurde nicht übergeben. Die Hauptnachricht oder das Hauptobjekt, die bzw. das Sie in Systemprotokollen oder in der Ausgabe protokollieren möchten. Akzeptiert eine Zeichenfolge, die null oder mehr Ersetzungswerte enthält, die mit festgelegt werden können subst1 through substNParameter. Siehe „Ersetzungszeichenfolgen verwenden“ in Konsole – Umfang, Global Weitere Informationen finden Sie unter .
Subst1...substN	Zeichenfolge	Optional. JavaScript-Werte, in denen Ersetzungszeichenfolgen ersetzt werden sollen msg. Diese Werte werden in der angegebenen Reihenfolge protokolliert oder angezeigt. Wenn mehr Ersetzungswerte vorhanden sind als Ersetzungszeichenfolgen vorhanden sind, werden die zusätzlichen Werte, die selbst geschrieben werden, nach der Nachricht ( msg) Auf die gleiche Weise wie wenn keine Formatzeichenfolge vorhanden ist. Siehe „Ersetzungszeichenfolgen verwenden“ in Konsole – Umfang, Global Weitere Informationen finden Sie unter .
Val1...ValN	Objekt	Erforderlich, wenn msgWurde nicht übergeben. Liste zusätzlicher JavaScript-Werte, die nach der Hauptnachricht ( msg), und werden durch ein Leerzeichen oder ein anderes Trennzeichen getrennt. Akzeptiert jeden JavaScript-Datentyp, einschließlich Zeichenfolgen oder Objekten, und gibt sie in der angegebenen Reihenfolge aus.

Tabelle : 8. Rückgaben

Typ	Beschreibung
Keine

Im folgenden Beispiel: console.debug() Protokolliert Nachrichten in Systemprotokollen in ServiceNow® Instanz.

(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, Zeichenfolgennachricht, Zeichenfolgensubst1...SubsN)

Protokolliert eine Nachricht auf Fehlerebene im Systemprotokoll.

Verwenden Fehler () Um kritische Probleme zu protokollieren, die sofortige Aufmerksamkeit erfordern, z. B. ungültige Eingaben, fehlgeschlagene Vorgänge oder zum Debuggen unerwarteter Verhaltensweisen.

Hinweis:

Konsole API-Methoden bieten die gleiche Protokollierungsfunktion wie Glide-System-API (Z. B. gs.info, gs.warn und gs.debug), ermöglichen Sie jedoch Entwicklern, die mit der Protokollierung von Nachrichten mit Konsolenmethoden vertraut sind, eine flexiblere Verwendung. Beides Konsole API und Glide-System API-Methoden können auf dem Server verwendet werden.

Tabelle : 9. Parameter

Name	Typ	Beschreibung
msg	Zeichenfolge	Erforderlich, wenn val1...valNWurde nicht übergeben. Die Hauptnachricht oder das Hauptobjekt, die bzw. das Sie in Systemprotokollen oder in der Ausgabe protokollieren möchten. Akzeptiert eine Zeichenfolge, die null oder mehr Ersetzungswerte enthält, die mit festgelegt werden können subst1 through substNParameter. Siehe „Ersetzungszeichenfolgen verwenden“ in Konsole – Umfang, Global Weitere Informationen finden Sie unter .
Subst1...substN	Zeichenfolge	Optional. JavaScript-Werte, in denen Ersetzungszeichenfolgen ersetzt werden sollen msg. Diese Werte werden in der angegebenen Reihenfolge protokolliert oder angezeigt. Wenn mehr Ersetzungswerte vorhanden sind als Ersetzungszeichenfolgen vorhanden sind, werden die zusätzlichen Werte, die selbst geschrieben werden, nach der Nachricht ( msg) Auf die gleiche Weise wie wenn keine Formatzeichenfolge vorhanden ist. Siehe „Ersetzungszeichenfolgen verwenden“ in Konsole – Umfang, Global Weitere Informationen finden Sie unter .
Val1...ValN	Objekt	Erforderlich, wenn msgWurde nicht übergeben. Liste zusätzlicher JavaScript-Werte, die nach der Hauptnachricht ( msg), und werden durch ein Leerzeichen oder ein anderes Trennzeichen getrennt. Akzeptiert jeden JavaScript-Datentyp, einschließlich Zeichenfolgen oder Objekten, und gibt sie in der angegebenen Reihenfolge aus.

Tabelle : 10. Rückgaben

Typ	Beschreibung
Keine

Im folgenden Beispiel Fehler () Die Ausgabe zeigt den folgenden Code an:

• Im ersten Beispiel wird einfach „ein Fehler ist aufgetreten!“ angezeigt. In einem fehlerformatierten Format.
• Im zweiten 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 bis eingerückt werden GroupEnd() Wird aufgerufen. 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 auf Konsole – groupEnd() Methode. Die groupEnd()-Methode verringert auch den Einzug der Gruppe um eine Ebene.

Hinweis:

Gruppe () Zeigt alle Gruppierungsebenen in der Ausgabe an und sind nicht reduzierbar oder erweiterbar.

Tabelle : 11. Parameter

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

Tabelle : 12. Rückgaben

Typ	Beschreibung
Keine

Das folgende Beispiel ist erfolgreich Protokoll() Um einen neuen geschachtelten Block und dann zu erstellen Gruppe () Zum Protokollieren von eingerückten Gruppen. Jeder nachfolgende Anruf an Gruppe () Rückt die Position auf einer neuen Ebene ein. Das Skript ruft auch auf GroupEnd() 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 wird:

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 aktuelle mit erstellte Inline-Gruppe Gruppe () Und verringert den Einzug um eine Ebene.

Tabelle : 13. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 14. Ergebnisse

Typ	Beschreibung
Keine

Das folgende Beispiel erstellt einen neuen geschachtelten Block durch Aufrufen Gruppe () Zum Protokollieren von eingezogenen Ebenen. Das Skript ist erfolgreich 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(Object val1...valN, Zeichenfolgennachricht, Zeichenfolgensubst1...substN)

Protokolliert eine Nachricht in Systemprotokollen auf Informationsebene.

Hinweis:

Konsole API-Methoden bieten die gleiche Protokollierungsfunktion wie Glide-System-API (Z. B. gs.info, gs.warn und gs.debug), ermöglichen Sie jedoch Entwicklern, die mit der Protokollierung von Nachrichten mit Konsolenmethoden vertraut sind, eine flexiblere Verwendung. Beides Konsole API und Glide-System API-Methoden können auf dem Server verwendet werden.

Tabelle : 15. Parameter

Name	Typ	Beschreibung
msg	Zeichenfolge	Erforderlich, wenn val1...valNWurde nicht übergeben. Die Hauptnachricht oder das Hauptobjekt, die bzw. das Sie in Systemprotokollen oder in der Ausgabe protokollieren möchten. Akzeptiert eine Zeichenfolge, die null oder mehr Ersetzungswerte enthält, die mit festgelegt werden können subst1 through substNParameter. Siehe „Ersetzungszeichenfolgen verwenden“ in Konsole – Umfang, Global Weitere Informationen finden Sie unter .
Subst1...substN	Zeichenfolge	Optional. JavaScript-Werte, in denen Ersetzungszeichenfolgen ersetzt werden sollen msg. Diese Werte werden in der angegebenen Reihenfolge protokolliert oder angezeigt. Wenn mehr Ersetzungswerte vorhanden sind als Ersetzungszeichenfolgen vorhanden sind, werden die zusätzlichen Werte, die selbst geschrieben werden, nach der Nachricht ( msg) Auf die gleiche Weise wie wenn keine Formatzeichenfolge vorhanden ist. Siehe „Ersetzungszeichenfolgen verwenden“ in Konsole – Umfang, Global Weitere Informationen finden Sie unter .
Val1...ValN	Objekt	Erforderlich, wenn msgWurde nicht übergeben. Liste zusätzlicher JavaScript-Werte, die nach der Hauptnachricht ( msg), und werden durch ein Leerzeichen oder ein anderes Trennzeichen getrennt. Akzeptiert jeden JavaScript-Datentyp, einschließlich Zeichenfolgen oder Objekten, und gibt sie in der angegebenen Reihenfolge aus.

Tabelle : 16. Rückgaben

Typ	Beschreibung
Keine

Im folgenden Beispiel wird verwendet Info() Methode zum Protokollieren von zwei Informationen: Die Datensatznummer und die Priorität des aktuellen Formulars. Diese Methode ist nützlich für Schnellprüfungen beim Debugging 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 – log(Object val1...val2, Zeichenfolgennachricht, Zeichenfolgensubst1...subst2)

Protokolliert eine Nachricht in Systemprotokollen.

Hinweis:

Konsole API-Methoden bieten die gleiche Protokollierungsfunktion wie Glide-System-API (Z. B. gs.info, gs.warn und gs.debug), ermöglichen Sie jedoch Entwicklern, die mit der Protokollierung von Nachrichten mit Konsolenmethoden vertraut sind, eine flexiblere Verwendung. Beides Konsole API und Glide-System API-Methoden können auf dem Server verwendet werden.

Tabelle : 17. Parameter

Name	Typ	Beschreibung
msg	Zeichenfolge	Erforderlich, wenn val1...valNWurde nicht übergeben. Die Hauptnachricht oder das Hauptobjekt, die bzw. das Sie in Systemprotokollen oder in der Ausgabe protokollieren möchten. Akzeptiert eine Zeichenfolge, die null oder mehr Ersetzungswerte enthält, die mit festgelegt werden können subst1 through substNParameter. Siehe „Ersetzungszeichenfolgen verwenden“ in Konsole – Umfang, Global Weitere Informationen finden Sie unter .
Subst1...substN	Zeichenfolge	Optional. JavaScript-Werte, in denen Ersetzungszeichenfolgen ersetzt werden sollen msg. Diese Werte werden in der angegebenen Reihenfolge protokolliert oder angezeigt. Wenn mehr Ersetzungswerte vorhanden sind als Ersetzungszeichenfolgen vorhanden sind, werden die zusätzlichen Werte, die selbst geschrieben werden, nach der Nachricht ( msg) Auf die gleiche Weise wie wenn keine Formatzeichenfolge vorhanden ist. Siehe „Ersetzungszeichenfolgen verwenden“ in Konsole – Umfang, Global Weitere Informationen finden Sie unter .
Val1...ValN	Objekt	Erforderlich, wenn msgWurde nicht übergeben. Liste zusätzlicher JavaScript-Werte, die nach der Hauptnachricht ( msg), und werden durch ein Leerzeichen oder ein anderes Trennzeichen getrennt. Akzeptiert jeden JavaScript-Datentyp, einschließlich Zeichenfolgen oder Objekten, und gibt sie in der angegebenen Reihenfolge aus.

Tabelle : 18. Rückgaben

Typ	Beschreibung
Keine

Das folgende Beispiel zeigt die Verwendung Protokoll() Dient zum Protokollieren der Datensatznummer und des aktuellen Status des Formulars in Systemprotokollen.

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. Auf einer bestimmten Seite können bis zu 10.000 Timer ausgeführt werden. Wenn Sie anrufen Konsole timeEnd() Methode mit demselben Bezeichnungsnamen. Der Zähler gibt die Zeit in Millisekunden aus, die seit dem Start des Timers verstrichen ist. Verwenden Sie Konsolenzeitprotokoll() Methode zum Protokollieren der verstrichenen Zeit, die zwischen der Start- und Endzeit des Timers erfasst wurde.

Beispiele zur Verwendung dieser Methode mit anderen zeitbasierten Konsole API-Methoden, siehe „Zeitgeber verwenden“ in Konsole – Umfang, Global.

Tabelle : 19. Parameter

Name	Typ	Beschreibung
label	Zeichenfolge	Optional. Name, der dem neuen Timer zugewiesen werden soll. Verwenden Sie beim Anruf denselben Namen Konsole – timeEnd (Zeichenfolgenbezeichnung) Um den Timer anzuhalten und die verstrichene Zeit an die Konsole auszugeben. Maximale Anzahl von Timern: 10.000 Standard: Verwendet die Bezeichnung „Standard“ Wenn ausgelassen.

Tabelle : 20. Rückgaben

Typ	Beschreibung
Keine

Im Folgenden wird gezeigt, wie verwendet wird Time("label") Zum Starten eines Timers mit der Bezeichnung „Bezeichnung“. Die Console.timeEnd("label") Die Methode 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 (Zeichenfolgenbezeichnung)

Stoppt einen angegebenen Timer, der zuvor durch Aufruf gestartet wurde Zeit() .

Beispiele zur Verwendung dieser Methode mit anderen zeitbasierten Konsole API-Methoden, siehe „Zeitgeber verwenden“ in Konsole – Umfang, Global.

Tabelle : 21. Parameter

Name	Typ	Beschreibung
label	Zeichenfolge	Optional. Name des zu stoppenden Timers. Nach dem Anhalten wird die verstrichene Zeit automatisch in der Konsole zusammen mit einem Indikator angezeigt, dass die Zeit abgelaufen ist. Diese Bezeichnung muss mit dem in angegebenen Timer übereinstimmen Konsole – Time (Zeichenfolgenbezeichnung) labelBei Parameter und wird zwischen Groß- und Kleinschreibung unterschieden. Standard: Wenn ausgelassen, wird die Bezeichnung verwendet „Standard“ .

Tabelle : 22. Rückgaben

Typ	Beschreibung
Keine

Das folgende Beispiel zeigt die Verwendung Time("label") Zum Starten eines Timers mit der Bezeichnung „Bezeichnung“. Die Console.timeEnd("label") Methode stoppt den Timer mit derselben Bezeichnung; Console.log() Protokolliert die verstrichene Zeit. In diesem Beispiel wird die Zeit gemessen, die zum Abrufen benötigt wird, und die Nummer und Priorität des Datensatzes werden 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(Zeichenfolgenbezeichnung, Objekt ValN)

Protokolliert den aktuellen Wert eines angegebenen Timers im Systemprotokoll.

Beispiele zur Verwendung dieser Methode mit anderen zeitbasierten Konsole API-Methoden, siehe „Zeitgeber verwenden“ in Konsole – Umfang, Global.

Tabelle : 23. Parameter

Name	Typ	Beschreibung
label	Zeichenfolge	Optional. Name des Timers, der bei der Konsole angemeldet werden soll. Muss mit dem in angegebenen Timer übereinstimmen Konsole – Time (Zeichenfolgenbezeichnung) labelBei Parameter und wird zwischen Groß- und Kleinschreibung unterschieden. Standard: Verwendet die Bezeichnung „Standard“ Wenn ausgelassen.
ValN	Objekt	Optional. Zusätzliche Werte, die nach der Timer-Ausgabe protokolliert werden sollen. Akzeptiert ein unstrukturiertes Objekt, das einen beliebigen Datentyp mit spezieller Behandlung für Zeichenfolgen unterstützt.

Tabelle : 24. Rückgaben

Typ	Beschreibung
Keine

Das folgende Beispiel zeigt, wie Sie anrufen Zeitprotokoll() Verwendung des Bezeichnungswerts eines Timers, der zuvor mit gestartet wurde Zeit() Methode. Die Zeitprotokoll() Die Methode protokolliert den aktuellen Wert eines Timers.

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

Wenn der Timer-Name ausgelassen wird, wird der Timer benannt „Standard“ :

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

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

Timer "timer name" doesn't exist.

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

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

In einem anderen Beispiel: Console.time('Timer') Startet 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 insgesamt 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 eine Stapelverfolgung im Systemprotokoll auf Informationsebene.

Tabelle : 25. Parameter

Name	Typ	Beschreibung
objects	Objekt	Optional. Null oder mehr Objekte, die zusammen mit der Ablaufverfolgung an die Konsole ausgegeben werden sollen. Objekte werden auf die gleiche Weise zusammengestellt und formatiert wie bei der Übergabe an Konsole – log(Object val1...val2, Zeichenfolgennachricht, Zeichenfolgensubst1...subst2) Methode. Standard: Gibt den gesamten Stapel in der Ausgabe zurück.

Tabelle : 26. Rückgaben

Typ	Beschreibung
Keine

Das folgende Beispiel zeigt, wie Trace() Protokolliert die Nachricht Ablaufverfolgungsbeispiel Zusammen mit der Stapelverfolgung.

function firstFunction() {
    secondFunction();
}

function secondFunction() {
    thirdFunction();
}

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

firstFunction();

Die Stapelverfolgung zeigt die Aufrufsequenz: Dritte Funktion Wurde von aufgerufen Second Function , Die von aufgerufen wurde FirstFunction , Und so weiter. Die Console.Trace('Nachverfolgungsbeispiel') Protokolliert die Nachricht Ablaufverfolgungsbeispiel Zusammen mit der Stapelverfolgung.

Ausgabe:

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

Konsole – Warn(Object val1...valN, Zeichenfolgennachricht, Zeichenfolgensubst1...subst2)

Protokolliert eine Warnmeldung auf der Warnungsebene im Systemprotokoll.

Hinweis:

Konsole API-Methoden bieten die gleiche Protokollierungsfunktion wie Glide-System-API (Z. B. gs.info, gs.warn und gs.debug), ermöglichen Sie jedoch Entwicklern, die mit der Protokollierung von Nachrichten mit Konsolenmethoden vertraut sind, eine flexiblere Verwendung. Beides Konsole API und Glide-System API-Methoden können auf dem Server verwendet werden.

Tabelle : 27. Parameter

Name	Typ	Beschreibung
msg	Zeichenfolge	Erforderlich, wenn val1...valNWurde nicht übergeben. Die Hauptnachricht oder das Hauptobjekt, die bzw. das Sie in Systemprotokollen oder in der Ausgabe protokollieren möchten. Akzeptiert eine Zeichenfolge, die null oder mehr Ersetzungswerte enthält, die mit festgelegt werden können subst1 through substNParameter. Siehe „Ersetzungszeichenfolgen verwenden“ in Konsole – Umfang, Global Weitere Informationen finden Sie unter .
Subst1...substN	Zeichenfolge	Optional. JavaScript-Werte, in denen Ersetzungszeichenfolgen ersetzt werden sollen msg. Diese Werte werden in der angegebenen Reihenfolge protokolliert oder angezeigt. Wenn mehr Ersetzungswerte vorhanden sind als Ersetzungszeichenfolgen vorhanden sind, werden die zusätzlichen Werte, die selbst geschrieben werden, nach der Nachricht ( msg) Auf die gleiche Weise wie wenn keine Formatzeichenfolge vorhanden ist. Siehe „Ersetzungszeichenfolgen verwenden“ in Konsole – Umfang, Global Weitere Informationen finden Sie unter .
Val1...ValN	Objekt	Erforderlich, wenn msgWurde nicht übergeben. Liste zusätzlicher JavaScript-Werte, die nach der Hauptnachricht ( msg), und werden durch ein Leerzeichen oder ein anderes Trennzeichen getrennt. Akzeptiert jeden JavaScript-Datentyp, einschließlich Zeichenfolgen oder Objekten, und gibt sie in der angegebenen Reihenfolge aus.

Tabelle : 28. Rückgaben

Typ	Beschreibung
Keine

Das folgende Beispiel verwendet Warnung() Zum Protokollieren einer Warnmeldung, die normalerweise so formatiert ist, dass sie hervorhebt (z. B. mit einem Warnsymbol oder gelbem Text). Dieses Beispiel überprüft die Priorität des Datensatzes: Wenn er hoch ist (Priorität ==="1" ), wird eine Warnmeldung protokolliert. Wenn er 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);
    }
}

Infolgedessen Warnung() Protokolliert oder zeigt 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: Priorität ist nicht hoch. Aktuelle Priorität: 3