---
sourceDocument: Référence de l’API Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - fr-FR

ft:publication_title :

    - Référence de l’API Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# JSUtil - Global

# JSUtil - Global {#ariaid-title1}

* Rversion finale: Xanadu
* 
* Mis à jour 1 août 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 7 minutes de lecture

L'include de script JSUtil fournit des raccourcis pour les routines JavaScript courantes.

Cette API est disponible dans des scripts globaux côté serveur, et non dans des scripts inclus dans le périmètre.

## JSUtil : doesNotHave(élément d'objet) {#ariaid-title2}

Vérifie si l'élément est nul ou non défini.
{#r_JSUtil-doesNotHave_O__table_omt_wg5_4t__entry__3}

| Nom | Type | Description |
|-|-|-|
| élément | Objet | Objet à vérifier |
[Tableau 1. Paramètres]

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

| Type | Description |
|-|-|
| Booléen | Vrai si l'objet spécifié est nul ou non défini. |
[Tableau 2. Renvoie]

{#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))

Sortie :

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

## JSUtil : escapeAttr(texte de chaîne) {#ariaid-title3}

Les esperluettes d'échappement sont couramment utilisées pour définir les attributs d'URL.
{#r_JSUtil-escapeAttr_S__table_p5v_c55_4t__entry__3}

| Nom | Type | Description |
|-|-|-|
| Texte | Chaîne | Le texte |
[Tableau 3. Paramètres]

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

| Type | Description |
|-|-|
| Chaîne | Le texte avec des esperluettes s'est correctement échappé. |
[Tableau 4. Renvoie]

{#r_JSUtil-escapeAttr_S__table_q5v_c55_4t}  

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

Sortie : il s'agit du texte renvoyé. Si le texte est affiché dans l'application, la page affichera l'esperluette d'échappement avec une seule esperluette.

    sysparm_query=active=true&sysparm_view=special

## JSUtil : escapeText(texte de chaîne) {#ariaid-title4}

Échappe les caractères XML non valides tels que \<\< \< \> \& \>\>.
{#r_JSUtil-escapeText_S__table_amh_ms5_4t__entry__3}

| Nom | Type | Description |
|-|-|-|
| Texte | Chaîne | Le texte |
[Tableau 5. Paramètres]

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

| Type | Description |
|-|-|
| Chaîne | Texte avec caractères d'échappement ajouté. |
[Tableau 6. Renvoie]

{#r_JSUtil-escapeText_S__table_bmh_ms5_4t}  

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

Sortie : il s'agit de la valeur renvoyée. Si le résultat est affiché dans l'application, la page affiche les crochets afin qu'il apparaisse qu'il n'y a pas d'échappement.

    <b>This is my title</b>

## JSUtil : getBooleanValue(GlideRecord now_GR, champ de chaîne) {#ariaid-title5}

Renvoie la valeur d'un champ booléen GlideRecord.
{#r_JSUtil-getBooleanValue_GR_S__table_mtb_ml5_4t__entry__3}

| Nom | Type | Description |
|-|-|-|
| now_GR | GlideRecord | Un GlideRecord |
| champ | Chaîne | Champ à partir duquel récupérer la valeur booléenne. |
[Tableau 7. Paramètres]

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

| Type | Description |
|-|-|
| Booléen | Renvoie la valeur d'un champ booléen GlideRecord ; renvoie la valeur true si la valeur du champ est vrai, \<\< vrai \>\>, 1 ou \<\< 1 \>\>. |
[Tableau 8. Renvoie]

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

Sortie : vrai

## JSUtil : has(élément d'objet) {#ariaid-title6}

Vérifie si l'élément n'est pas nul et n'est pas indéfini.
{#r_JSUtil-has_O__table_xmc_kg5_4t__entry__3}

| Nom | Type | Description |
|-|-|-|
| élément | Objet | Objet à vérifier |
[Tableau 9. Paramètres]

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

| Type | Description |
|-|-|
| Booléen | Vrai si l'objet spécifié n'est pas nul et n'est pas indéfini. |
[Tableau 10. Renvoie]

{#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));

Sortie :

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

## JSUtil : instance_of(objet élément, classe de chaînes) {#ariaid-title7}

Vérifie si l'objet spécifié est membre de la classe spécifiée.
Pour les objets JavaScript, cette méthode se comporte exactement comme l'opérateur JavaScript \<\< instanceof \>\>, mais prend également en charge les objets Java.
{#r_JSUtil-instance_of_O_S__table_uh2_s35_4t__entry__3}

| Nom | Type | Description |
|-|-|-|
| élément | Objet | Objet à vérifier |
| classe | Chaîne | La classe à vérifier |
[Tableau 11. Paramètres]

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

| Type | Description |
|-|-|
| Booléen | Vrai si l'objet spécifié est membre de la classe spécifiée. |
[Tableau 12. Renvoie]

{#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));

Sortie :

    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(valeur de l'objet) {#ariaid-title8}

Vérifie si l'objet spécifié est une classe Java.
{#r_JSUtil-isJavaObject_O__table_eff_2k5_4t__entry__3}

| Nom | Type | Description |
|-|-|-|
| valide | Objet | Objet à vérifier |
[Tableau 13. Paramètres]

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

| Type | Description |
|-|-|
| Booléen | Vrai si l'objet spécifié est une instance d'une classe Java. |
[Tableau 14. Renvoie]

{#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));

Sortie :

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

## JSUtil : logObject(objet obj, nom de la chaîne) {#ariaid-title9}

Consigne toutes les propriétés de l'objet donné : nom, type et valeur.
La sortie est écrite dans la console si vous exécutez un script en arrière-plan ou si la journalisation de débogage est activée. La sortie est également écrite dans le journal système.
{#r_JSUtil-logObject_O_S__table_ozw_tr5_4t__entry__3}

| Nom | Type | Description |
|-|-|-|
| obj. | Objet | Objet pour lequel énumérer les propriétés |
| nom | Chaîne | Nom facultatif de l'objet journalisé |
[Tableau 15. Paramètres]

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

| Type | Description |
|-|-|
| nul |   |
[Tableau 16. Renvoie]

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

Sortie :

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

## JSUtil : néant(élément d'objet) {#ariaid-title10}

Vérifie si l'élément est nul, non défini ou s'il équivaut à une chaîne vide.
{#r_JSUtil-nil_O__table_bjp_mh5_4t__entry__3}

| Nom | Type | Description |
|-|-|-|
| élément | Objet | Objet à vérifier |
[Tableau 17. Paramètres]

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

| Type | Description |
|-|-|
| Booléen | Vrai si l'élément est nul, non défini ou équivaut à une chaîne vide. |
[Tableau 18. Renvoie]

{#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));

Sortie :

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

## JSUtil : notNil(élément d'objet) {#ariaid-title11}

Vérifie si un élément est nul, non défini ou s'il équivaut à la chaîne vide.
Remarque :  
Cette méthode renvoie une erreur si l'objet fourni n'est pas déclaré.
{#r_JSUtil-notNil_O__table_trk_f35_4t__entry__3}

| Nom | Type | Description |
|-|-|-|
| élément | Objet | Objet à vérifier. |
[Tableau 19. Paramètres]

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

| Type | Description |
|-|-|
| Booléen | Marqueur qui indique si l'élément existe et n'est pas vide. Une erreur est renvoyée si l'objet fourni n'est pas déclaré. Valeurs valides : * true : l'objet fourni a été déclaré et défini. Si l'objet est une chaîne de caractères, il n'est pas vide. * false : l'objet fourni est nul, non défini ou équivaut à une chaîne vide. {#r_JSUtil-notNil_O__ul_zcy_nr3_myb} |
[Tableau 20. Renvoie]

{#r_JSUtil-notNil_O__table_urk_f35_4t}  
L'exemple suivant montre les résultats pour une variable de type chaîne, une variable de type chaîne vide et une variable non définie.

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

Sortie :

    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}

Convertit l'objet spécifié en booléen.
{#r_JSUtil-toBoolean_O__table_vdm_tk5_4t__entry__3}

| Nom | Type | Description |
|-|-|-|
| élément | Objet | Objet à convertir |
[Tableau 21. Paramètres]

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

| Type | Description |
|-|-|
| Booléen | Si l'objet spécifié est un booléen, il est transmis. Des nombres non nuls renvoient la valeur vrai. Null ou undefined renvoie false. Les chaînes ne renvoient la valeur vrai que si elle est exactement identique à la valeur \<\< vrai \>\>. |
[Tableau 22. Renvoie]

{#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));

Sortie :

    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(valeur d'objet) {#ariaid-title13}

Détermine le type de l'objet spécifié.
{#r_JSUtil-type_of_O__table_ic5_lj5_4t__entry__3}

| Nom | Type | Description |
|-|-|-|
| valide | Objet | Objet à vérifier |
[Tableau 23. Paramètres]

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

| Type | Description |
|-|-|
| Chaîne | Type de l'objet spécifié. * 'null' si la valeur donnée est null ou non définie * 'string' si la valeur donnée est une chaîne primitive ou une instance de couche de chaîne * 'number' si la valeur donnée est un nombre primitif ou une instance de couche de nombre * \<\< booléen \>\> si la valeur donnée est un booléen primitif ou une instance de couche booléenne * 'function' si la valeur donnée est une fonction * 'objet' dans le cas contraire {#r_JSUtil-type_of_O__ul_rjh_sj5_4t} |
[Tableau 24. Renvoie]

{#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));

Sortie :

    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(texte de chaîne) {#ariaid-title14}

Restaurez les esperluettes à partir d'un texte d'échappement.
{#r_JSUtil-unescapeAttr_S__table_nqy_t55_4t__entry__3}

| Nom | Type | Description |
|-|-|-|
| Texte | Chaîne | Le texte |
[Tableau 25. Paramètres]

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

| Type | Description |
|-|-|
| Chaîne | Le texte avec les caractères d'échappement a été supprimé. |
[Tableau 26. Renvoie]

{#r_JSUtil-unescapeAttr_S__table_oqy_t55_4t}  

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

Sortie :

    sysparm_query=active=true&sysparm_view=special

## JSUtil : unescapeText(texte de chaîne) {#ariaid-title15}

Supprime les caractères d'échappement.
{#r_JSUtil-unescapeText_S__table_j3r_jt5_4t__entry__3}

| Nom | Type | Description |
|-|-|-|
| Texte | Chaîne | Texte à traiter. |
[Tableau 27. Paramètres]

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

| Type | Description |
|-|-|
| Chaîne | Le texte sans caractères d'échappement. |
[Tableau 28. Renvoie]

{#r_JSUtil-unescapeText_S__table_k3r_jt5_4t}  

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

Sortie : il s'agit de la valeur renvoyée. Si le texte est affiché dans l'application de la page, il restitue les balises html et affiche le texte en gras.

    <b>This is my title</b>