---
sourceDocument: Xanadu-API-Referenz
sourceDocumentLink: https://www.servicenow.com/docs/r/de-DE/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - de-DE

ft:publication_title :

    - Xanadu-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# JSUtil : Global

# JSUtil : Global {#ariaid-title1}

* Freigeben Version: Xanadu
* 
* Aktualisiert 1. August 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 7 Minuten Lesedauer

Die JSUtil-Skripteinbindung bietet Verknüpfungen für gängige JavaScript-Routinen.

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

## JSUtil -- doesNotHave(Object item) {#ariaid-title2}

Überprüft, ob das Element NULL ist oder undefiniert.
{#r_JSUtil-doesNotHave_O__table_omt_wg5_4t__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| item | Objekt | Das zu prü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 | „True", wenn das angegebene Objekt NULL oder undefiniert ist. |
[Tabelle : 2. Ergebnisse]

{#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(String text) {#ariaid-title3}

Escape-Ampersands, die häufig zur Definition von URL-Attributen verwendet werden.
{#r_JSUtil-escapeAttr_S__table_p5v_c55_4t__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| text | 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 mir ordnungsgemäß mit Excape-Zeichen versehenen Ampersands. |
[Tabelle : 4. Ergebnisse]

{#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 Escape-Zeichen mit einem einzelnen Und-Zeichen.

    sysparm_query=active=true&sysparm_view=special

## JSUtil -- escapeText(String text) {#ariaid-title4}

Versieht ungültige XML-Zeichen mit Escape-Zeichen, wie z. B. „\< \> \&".
{#r_JSUtil-escapeText_S__table_amh_ms5_4t__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| text | 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 zusätzlichen Escape-Zeichen. |
[Tabelle : 6. Ergebnisse]

{#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, sodass sie als nicht mit Escape-Zeichen versehen angezeigt werden.

    <b>This is my title</b>

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

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

| Name | Typ | Beschreibung |
|-|-|-|
| now_GR | GlideRecord | Ein GlideRecord |
| field | Zeichenfolge | Das Feld, aus dem der boolean 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 boolean GlideRecord-Feld zurück; gibt „true" zurück, wenn der Wert des Felds true, „true", 1 oder „1" ist. |
[Tabelle : 8. Ergebnisse]

{#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: true

## JSUtil -- has(Object item) {#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 |
|-|-|-|
| item | Objekt | Das zu prü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 | „True", wenn das angegebene Objekt nicht NULL und nicht undefiniert ist. |
[Tabelle : 10. Ergebnisse]

{#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(Object item, String class) {#ariaid-title7}

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

| Name | Typ | Beschreibung |
|-|-|-|
| item | Objekt | Das zu prü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 | „True", wenn das angegebene Objekt Mitglied der angegebenen Klasse ist. |
[Tabelle : 12. Ergebnisse]

{#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(Object value) {#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 prü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 | „True", wenn das angegebene Objekt eine Instanz einer Java-Klasse ist. |
[Tabelle : 14. Ergebnisse]

{#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(Object obj, String name) {#ariaid-title9}

Protokolliert alle Eigenschaften des angegebenen Objekts: Name, Typ und Wert.
Die Ausgabe wird in die Konsole geschrieben, wenn Sie ein Hintergrundskript ausführen oder die Debugprotokollierung 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 |
|-|-|
| void |   |
[Tabelle : 16. Ergebnisse]

{#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(Object item) {#ariaid-title10}

Überprüft, ob das Element NULL oder undefiniert ist oder die leere Zeichenfolge ergibt.
{#r_JSUtil-nil_O__table_bjp_mh5_4t__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| item | Objekt | Das zu prü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 | „True", wenn das Element NULL oder undefiniert ist oder als leere Zeichenfolge ausgewertet wird. |
[Tabelle : 18. Ergebnisse]

{#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(Object item) {#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 |
|-|-|-|
| item | 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, darf es nicht leer sein. * „falsch": Das angegebene Objekt ist NULL, nicht definiert oder wird als leere Zeichenfolge ausgewertet. {#r_JSUtil-notNil_O__ul_zcy_nr3_myb} |
[Tabelle : 20. Ergebnisse]

{#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(Object item) {#ariaid-title12}

Konvertiert das angegebene Objekt in ein Boolean.
{#r_JSUtil-toBoolean_O__table_vdm_tk5_4t__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| item | 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 Boolean ist, wird es weitergeleitet. Nicht-Null-Zahlen geben „true" zurück. Null oder undefinierte Zahlen geben „false" zurück. Zeichenfolgen geben nur dann „true" zurück, wenn sie genau „true" sind. |
[Tabelle : 22. Ergebnisse]

{#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(Object value) {#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 prü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 undefiniert ist * 'string', wenn der angegebene Wert eine primitive Zeichenfolge oder eine String-Wrapper-Instanz ist * 'number', wenn der angegebene Wert eine primitive Zahl oder eine Number-Wrapper-Instanz ist * 'boolean', wenn der angegebene Wert eine primitives Boolean oder eine Boolean-Wrapper-Instanz ist * 'function' wenn der angegebene Wert eine Funktion ist * andernfalls 'object' {#r_JSUtil-type_of_O__ul_rjh_sj5_4t} |
[Tabelle : 24. Ergebnisse]

{#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(String text) {#ariaid-title14}

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

| Name | Typ | Beschreibung |
|-|-|-|
| text | 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. Ergebnisse]

{#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(String text) {#ariaid-title15}

Entfernt Escape-Zeichen.
{#r_JSUtil-unescapeText_S__table_j3r_jt5_4t__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| text | 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. Ergebnisse]

{#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 der Seite angezeigt wird, rendert er die HTML-Tags und zeigt den Text in Fettdruck an.

    <b>This is my title</b>