---
sourceDocument: Yokohama-API-Referenz
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/yokohama/api-reference

 Release :

    - yokohama

ft:locale :

    - de-DE

ft:publication_title :

    - Yokohama-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# JSUtil -- Global

# JSUtil -- Global {#ariaid-title1}

* Freigeben Version: Yokohama
* 
* Aktualisiert 30. Januar 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 7 Minuten Lesedauer

Die JSUtil Die Skripteinbindung bietet Verknüpfungen für allgemeine JavaScript-Routinen.

Diese API ist in globalen serverseitigen Skripts verfügbar, nicht in bereichsbezogenen Skripts.

## JSUtil -- doesNotHave(Objektelement) {#ariaid-title2}

Überprüft, ob das Element null oder nicht definiert ist.
{#r_JSUtil-doesNotHave_O__table_omt_wg5_4t__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Element | Objekt | Das zu überprüfende Objekt |
[Tabelle : 1. Parameter]

{#r_JSUtil-doesNotHave_O__table_omt_wg5_4t} {#r_JSUtil-doesNotHave_O__table_pmt_wg5_4t__entry__2}

| Typ | Beschreibung |
|-|-|
| Boolean | „Wahr", wenn das angegebene Objekt null oder nicht definiert ist. |
[Tabelle : 2. Rückgaben]

{#r_JSUtil-doesNotHave_O__table_pmt_wg5_4t}  

    var x = "the quick brown fox";
    var y = "";
    var z;
     
    gs.print("x = '" + x + "', JSUtil.doesNotHave(x) = " + JSUtil.doesNotHave(x));
    gs.print("y = '" + y + "', JSUtil.doesNotHave(y) = " + JSUtil.doesNotHave(y));
    gs.print("z = '" + z + "', JSUtil.doesNotHave(z) = " + JSUtil.doesNotHave(z))

Ausgabe:

    x = 'the quick brown fox', JSUtil.doesNotHave(x) = false
    y = '', JSUtil.doesNotHave(y) = false
    z = 'undefined', JSUtil.doesNotHave(z) = true

## JSUtil -- escapeAttr(Zeichenfolgentext) {#ariaid-title3}

Escape-Zeichen, die häufig zum Definieren von URL-Attributen verwendet werden.
{#r_JSUtil-escapeAttr_S__table_p5v_c55_4t__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| HTML | Zeichenfolge | Der Text |
[Tabelle : 3. Parameter]

{#r_JSUtil-escapeAttr_S__table_p5v_c55_4t} {#r_JSUtil-escapeAttr_S__table_q5v_c55_4t__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Der Text mit ampersands ist ordnungsgemäß mit Escape versehen. |
[Tabelle : 4. Rückgaben]

{#r_JSUtil-escapeAttr_S__table_q5v_c55_4t}  

    var attr = "sysparm_query=active=true&sysparm_view=special";
     
    gs.print(JSUtil.escapeAttr(attr));

Ausgabe: Dies ist der zurückgegebene Text. Wenn der Text in der Anwendung angezeigt wird, rendert die Seite das mit Escape versehene Amperand mit einem einzelnen Amperand.

    sysparm_query=active=true&sysparm_view=special

## JSUtil -- escapeText (Zeichenfolgentext) {#ariaid-title4}

Escape-Zeichen für ungültige XML-Zeichen wie „\< \> und".
{#r_JSUtil-escapeText_S__table_amh_ms5_4t__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| HTML | Zeichenfolge | Der Text |
[Tabelle : 5. Parameter]

{#r_JSUtil-escapeText_S__table_amh_ms5_4t} {#r_JSUtil-escapeText_S__table_bmh_ms5_4t__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Der Text mit Escape-Zeichen wurde hinzugefügt. |
[Tabelle : 6. Rückgaben]

{#r_JSUtil-escapeText_S__table_bmh_ms5_4t}  

    var html = "<b>This is my title</b>";
     
    gs.print(JSUtil.escapeText(html));

Ausgabe: Dies ist der zurückgegebene Wert. Wenn das Ergebnis in der Anwendung angezeigt wird, rendert die Seite die Klammern zurück, sodass es anscheinend nicht mit Escape-Zeichen versehen ist.

    <b>This is my title</b>

## JSUtil -- getBooleanValue(GlideRecord Now_GR, Zeichenfolgenfeld) {#ariaid-title5}

Gibt den Wert in einem booleschen GlideRecord-Feld zurück.
{#r_JSUtil-getBooleanValue_GR_S__table_mtb_ml5_4t__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Now_GR | GlideRecord | Ein GlideRecord |
| Ausstehend | Zeichenfolge | Das Feld, aus dem der boolesche Wert abgerufen werden soll. |
[Tabelle : 7. Parameter]

{#r_JSUtil-getBooleanValue_GR_S__table_mtb_ml5_4t} {#r_JSUtil-getBooleanValue_GR_S__table_ntb_ml5_4t__entry__2}

| Typ | Beschreibung |
|-|-|
| Boolean | Gibt den Wert in einem booleschen GlideRecord-Feld zurück. Gibt „wahr" zurück, wenn der Wert des Felds „wahr", „1" oder „1" ist. |
[Tabelle : 8. Rückgaben]

{#r_JSUtil-getBooleanValue_GR_S__table_ntb_ml5_4t}  

    var inc = new GlideRecord("incident");
    //get an active incident
    inc.addActiveQuery();
    inc.setLimit(1);
    inc.query();
    inc.next();
     
    gs.print(JSUtil.getBooleanValue(inc, "active"));

Ausgabe: Wahr

## JSUtil -- hat(Objektelement) {#ariaid-title6}

Überprüft, ob das Element nicht null und nicht undefiniert ist.
{#r_JSUtil-has_O__table_xmc_kg5_4t__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Element | Objekt | Das zu überprüfende Objekt |
[Tabelle : 9. Parameter]

{#r_JSUtil-has_O__table_xmc_kg5_4t} {#r_JSUtil-has_O__table_ymc_kg5_4t__entry__2}

| Typ | Beschreibung |
|-|-|
| Boolean | „Wahr", wenn das angegebene Objekt nicht null und nicht undefiniert ist. |
[Tabelle : 10. Rückgaben]

{#r_JSUtil-has_O__table_ymc_kg5_4t}  

    var x = "the quick brown fox";
    var y = "";
    var z;
     
    gs.print("x = '" + x + "', JSUtil.has(x) = " + JSUtil.has(x));
    gs.print("y = '" + y + "', JSUtil.has(y) = " + JSUtil.has(y));
    gs.print("z = '" + z + "', JSUtil.has(z) = " + JSUtil.has(z));

Ausgabe:

    x = 'the quick brown fox', JSUtil.has(x) = true
    y = '', JSUtil.has(y) = true
    z = 'undefined', JSUtil.has(z) = false

## JSUtil -- instance_of(Objektelement, Zeichenfolgenklasse) {#ariaid-title7}

Überprüft, ob das angegebene Objekt ein Mitglied der angegebenen Klasse ist.
Bei JavaScript-Objekten verhält sich diese Methode genau wie der JavaScript-Operator „instanceof", unterstützt aber auch Java-Objekte.
{#r_JSUtil-instance_of_O_S__table_uh2_s35_4t__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Element | Objekt | Das zu überprüfende Objekt |
| class | Zeichenfolge | Die zu überprüfende Klasse |
[Tabelle : 11. Parameter]

{#r_JSUtil-instance_of_O_S__table_uh2_s35_4t} {#r_JSUtil-instance_of_O_S__table_vh2_s35_4t__entry__2}

| Typ | Beschreibung |
|-|-|
| Boolean | „Wahr", wenn das angegebene Objekt ein Mitglied der angegebenen Klasse ist. |
[Tabelle : 12. Rückgaben]

{#r_JSUtil-instance_of_O_S__table_vh2_s35_4t}  

    var a = ['a','b','c'];
    var b = 10;
    var c = new GlideRecord("incident");
     
    gs.print("JSUtil.instance_of(a,'Array') = " + JSUtil.instance_of(a,Array));
    gs.print("JSUtil.instance_of(a,'String') = " + JSUtil.instance_of(a,String));
     
    gs.print("JSUtil.instance_of(b,'String') = " + JSUtil.instance_of(b,String));
     
    gs.print("JSUtil.instance_of(c,'GlideRecord') = " + JSUtil.instance_of(c,GlideRecord));

Ausgabe:

    JSUtil.instance_of(a,'Array') = true
    JSUtil.instance_of(a,'String') = false
    JSUtil.instance_of(b,'String') = false
    JSUtil.instance_of(c,'GlideRecord') = true

## JSUtil -- isJavaObject(Objektwert) {#ariaid-title8}

Überprüft, ob das angegebene Objekt eine Java-Klasse ist.
{#r_JSUtil-isJavaObject_O__table_eff_2k5_4t__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Wert | Objekt | Das zu überprüfende Objekt |
[Tabelle : 13. Parameter]

{#r_JSUtil-isJavaObject_O__table_eff_2k5_4t} {#r_JSUtil-isJavaObject_O__table_fff_2k5_4t__entry__2}

| Typ | Beschreibung |
|-|-|
| Boolean | „Wahr", wenn das angegebene Objekt eine Instanz einer Java-Klasse ist. |
[Tabelle : 14. Rückgaben]

{#r_JSUtil-isJavaObject_O__table_fff_2k5_4t}  

    var tu = new TableUtils("incident");
    var classes = tu.getHierarchy(); //Java ArrayList
    var tables = ["task, incident"]; //JavaScript Array
     
    gs.print("JSUtil.isJavaObject(classes) = " + JSUtil.isJavaObject(classes));
    gs.print("JSUtil.isJavaObject(tables) = " + JSUtil.isJavaObject(tables));

Ausgabe:

    JSUtil.isJavaObject(classes) = true
    JSUtil.isJavaObject(tables) = false

## JSUtil -- logObject (Objektobjekt, Zeichenfolgenname) {#ariaid-title9}

Protokolliert alle Eigenschaften im angegebenen Objekt: Name, Typ und Wert.
Die Ausgabe wird in die Konsole geschrieben, wenn Sie über ein Hintergrundskript ausführen oder die Debug-Protokollierung aktiviert ist. Die Ausgabe wird auch in das Systemprotokoll geschrieben.
{#r_JSUtil-logObject_O_S__table_ozw_tr5_4t__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| obj | Objekt | Das Objekt, für das Eigenschaften aufgezählt werden sollen |
| name | Zeichenfolge | Optionaler Name für das protokollierte Objekt |
[Tabelle : 15. Parameter]

{#r_JSUtil-logObject_O_S__table_ozw_tr5_4t} {#r_JSUtil-logObject_O_S__table_pzw_tr5_4t__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 16. Rückgaben]

{#r_JSUtil-logObject_O_S__table_pzw_tr5_4t}  

    var arr = ["a","b","c"];
     
    var inc = new GlideRecord("incident");
    //get an active incident
    inc.addActiveQuery();
    inc.setLimit(1);
    inc.query();
    inc.next();
     
    JSUtil.logObject(arr, "arr");
    JSUtil.logObject(inc, "inc");

Ausgabe:

    Log Object: arr
      Array of 3 elements
        [0]: string = a
        [1]: string = b
        [2]: string = c
    Log Object: inc
      GlideRecord('incident') @ INC0000002

## JSUtil -- Nil(Objektelement) {#ariaid-title10}

Überprüft, ob das Element null oder nicht definiert ist oder als leere Zeichenfolge ausgewertet wird.
{#r_JSUtil-nil_O__table_bjp_mh5_4t__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Element | Objekt | Das zu überprüfende Objekt |
[Tabelle : 17. Parameter]

{#r_JSUtil-nil_O__table_bjp_mh5_4t} {#r_JSUtil-nil_O__table_cjp_mh5_4t__entry__2}

| Typ | Beschreibung |
|-|-|
| Boolean | „Wahr", wenn das Element null oder nicht definiert ist oder als leere Zeichenfolge ausgewertet wird. |
[Tabelle : 18. Rückgaben]

{#r_JSUtil-nil_O__table_cjp_mh5_4t}  

    var x = "the quick brown fox";
    var y = "";
    var z;
     
    gs.print("x = '" + x + "', JSUtil.nil(x) = " + JSUtil.nil(x));
    gs.print("y = '" + y + "', JSUtil.nil(y) = " + JSUtil.nil(y));
    gs.print("z = '" + z + "', JSUtil.nil(z) = " + JSUtil.nil(z));

Ausgabe:

    x = 'the quick brown fox', JSUtil.nil(x) = false
    y = '', JSUtil.nil(y) = true
    z = 'undefined', JSUtil.nil(z) = true

## JSUtil -- notNil(Objektelement) {#ariaid-title11}

Überprüft, ob ein Element null oder nicht definiert ist oder als leere Zeichenfolge ausgewertet wird.
Hinweis:  
Diese Methode gibt einen Fehler zurück, wenn das angegebene Objekt nicht deklariert ist.
{#r_JSUtil-notNil_O__table_trk_f35_4t__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Element | Objekt | Das zu überprüfende Objekt. |
[Tabelle : 19. Parameter]

{#r_JSUtil-notNil_O__table_trk_f35_4t} {#r_JSUtil-notNil_O__table_urk_f35_4t__entry__2}

| Typ | Beschreibung |
|-|-|
| Boolean | Kennzeichnung, die angibt, ob das Element vorhanden und nicht leer ist. Ein Fehler wird zurückgegeben, wenn das angegebene Objekt nicht deklariert ist. Gültige Werte: * Wahr: Das angegebene Objekt wurde deklariert und definiert. Wenn das Objekt eine Zeichenfolge ist, ist es nicht leer. * Falsch: Das angegebene Objekt ist null, nicht definiert oder wird als leere Zeichenfolge ausgewertet. {#r_JSUtil-notNil_O__ul_zcy_nr3_myb} |
[Tabelle : 20. Rückgaben]

{#r_JSUtil-notNil_O__table_urk_f35_4t}  
Das folgende Beispiel zeigt Ergebnisse für eine Zeichenfolgenvariable, eine leere Zeichenfolgenvariable und eine nicht definierte Variable.

    var x = "the quick brown fox";
    var y = "";
    var z;

    gs.print("x = '" + x + "', JSUtil.notNil(x) = " + JSUtil.notNil(x));
    gs.print("y = '" + y + "', JSUtil.notNil(y) = " + JSUtil.notNil(y));
    gs.print("z = '" + z + "', JSUtil.notNil(z) = " + JSUtil.notNil(z));

Ausgabe:

    x = 'the quick brown fox', JSUtil.notNil(x) = true
    y = '', JSUtil.notNil(y) = false
    z = 'undefined', JSUtil.notNil(z) = false

## JSUtil -- toBoolean (Objektelement) {#ariaid-title12}

Konvertiert das angegebene Objekt in einen booleschen Wert.
{#r_JSUtil-toBoolean_O__table_vdm_tk5_4t__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Element | Objekt | Das zu konvertierende Objekt |
[Tabelle : 21. Parameter]

{#r_JSUtil-toBoolean_O__table_vdm_tk5_4t} {#r_JSUtil-toBoolean_O__table_wdm_tk5_4t__entry__2}

| Typ | Beschreibung |
|-|-|
| Boolean | Wenn das angegebene Objekt ein boolescher Wert ist, wird es übergeben. Zahlen ungleich Null geben „wahr" zurück. Null oder nicht definiert gibt „falsch" zurück. Zeichenfolgen geben nur „wahr" zurück, wenn sie genau „wahr" sind. |
[Tabelle : 22. Rückgaben]

{#r_JSUtil-toBoolean_O__table_wdm_tk5_4t}  

    var zero = 0;
    var one = 1;
    var number = 12;
    var trueBoolean = true;
    var trueString = "true";
    var otherString = "random text";
     
    gs.print("JSUtil.toBoolean(zero) = " + JSUtil.toBoolean(zero));
    gs.print("JSUtil.toBoolean(one) = " + JSUtil.toBoolean(one));
    gs.print("JSUtil.toBoolean(number) = " + JSUtil.toBoolean(number));
    gs.print("JSUtil.toBoolean(trueBoolean) = " + JSUtil.toBoolean(trueBoolean));
    gs.print("JSUtil.toBoolean(trueString) = " + JSUtil.toBoolean(trueString));
    gs.print("JSUtil.toBoolean(otherString) = " + JSUtil.toBoolean(otherString));

Ausgabe:

    JSUtil.toBoolean(zero) = false
    JSUtil.toBoolean(one) = true
    JSUtil.toBoolean(number) = true
    JSUtil.toBoolean(trueBoolean) = true
    JSUtil.toBoolean(trueString) = true
    JSUtil.toBoolean(otherString) = false

## JSUtil -- type_of(Objektwert) {#ariaid-title13}

Bestimmt den Typ des angegebenen Objekts.
{#r_JSUtil-type_of_O__table_ic5_lj5_4t__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Wert | Objekt | Das zu überprüfende Objekt |
[Tabelle : 23. Parameter]

{#r_JSUtil-type_of_O__table_ic5_lj5_4t} {#r_JSUtil-type_of_O__table_jc5_lj5_4t__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Der Typ des angegebenen Objekts. * „Null", wenn der angegebene Wert null oder nicht definiert ist * „Zeichenfolge", wenn der angegebene Wert eine primitive Zeichenfolge oder eine Zeichenfolge-Wrapper-Instanz ist * „Zahl", wenn der angegebene Wert eine primitive Zahl oder eine Nummer-Wrapper-Instanz ist * „boolesch", wenn der angegebene Wert eine primitive boolesche Instanz oder eine boolesche Wrapper-Instanz ist * „Funktion", wenn der angegebene Wert eine Funktion ist * Andernfalls „Objekt" {#r_JSUtil-type_of_O__ul_rjh_sj5_4t} |
[Tabelle : 24. Rückgaben]

{#r_JSUtil-type_of_O__table_jc5_lj5_4t}  

    var a = ["a","b","c"];
    var b = 10;
    var c = new GlideRecord("incident");
    var d = true;
    var e;
     
    gs.print("JSUtil.type_of(a) = " + JSUtil.type_of(a));
    gs.print("JSUtil.type_of(b) = " + JSUtil.type_of(b));
    gs.print("JSUtil.type_of(c) = " + JSUtil.type_of(c));
    gs.print("JSUtil.type_of= " + JSUtil.type_of(d));
    gs.print("JSUtil.type_of(e) = " + JSUtil.type_of(e));

Ausgabe:

    JSUtil.type_of(a) = object
    JSUtil.type_of(b) = number
    JSUtil.type_of(c) = object
    JSUtil.type_of= boolean
    JSUtil.type_of(e) = null

## JSUtil -- unescapeAttr(Zeichenfolgentext) {#ariaid-title14}

Ampersands aus Text mit Escape-Zeichen wiederherstellen.
{#r_JSUtil-unescapeAttr_S__table_nqy_t55_4t__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| HTML | Zeichenfolge | Der Text |
[Tabelle : 25. Parameter]

{#r_JSUtil-unescapeAttr_S__table_nqy_t55_4t} {#r_JSUtil-unescapeAttr_S__table_oqy_t55_4t__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Der Text mit Escape-Zeichen wurde entfernt. |
[Tabelle : 26. Rückgaben]

{#r_JSUtil-unescapeAttr_S__table_oqy_t55_4t}  

    var attr = "sysparm_query=active=true&sysparm_view=special";
     
    gs.print(JSUtil.unescapeAttr(attr));

Ausgabe:

    sysparm_query=active=true&sysparm_view=special

## JSUtil -- unescapeText (Zeichenfolgentext) {#ariaid-title15}

Entfernt Escape-Zeichen.
{#r_JSUtil-unescapeText_S__table_j3r_jt5_4t__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| HTML | Zeichenfolge | Der zu verarbeitende Text. |
[Tabelle : 27. Parameter]

{#r_JSUtil-unescapeText_S__table_j3r_jt5_4t} {#r_JSUtil-unescapeText_S__table_k3r_jt5_4t__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Der Text ohne Escape-Zeichen. |
[Tabelle : 28. Rückgaben]

{#r_JSUtil-unescapeText_S__table_k3r_jt5_4t}  

    var html = "<b>This is my title</b>";
     
    gs.print(JSUtil.unescapeText(html));

Ausgabe: Dies ist der zurückgegebene Wert. Wenn der Text in der Anwendung auf der Seite angezeigt wird, werden die HTML-Tags gerendert und der Text fett angezeigt.

    <b>This is my title</b>


