---
sourceDocument: Referência de API do Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - pt-BR

ft:publication_title :

    - Referência de API do Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# JSUtil - Global

# JSUtil - Global {#ariaid-title1}

* Versão de lançamento: Xanadu
* 
* Atualizado 1 de ago. de 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 7 min. de leitura

A inclusão de script JSUtil fornece atalhos para rotinas JavaScript comuns.

Esta API está disponível em scripts globais do lado do servidor, não em scripts com escopo.

## JSUtil - hasNotHave(item de objeto) {#ariaid-title2}

Verifica se o item é nulo ou indefinido.
{#r_JSUtil-doesNotHave_O__table_omt_wg5_4t__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| item | Objeto | O objeto a ser verificado |
[Tabela 1. Parâmetros]

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

| Tipo | Descrição |
|-|-|
| Booliano | Verdadeiro se o objeto especificado for nulo ou indefinido. |
[Tabela 2. Retorna]

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

Saída:

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

## JSUtil - escapeAttr(cadeia de caracteres text) {#ariaid-title3}

Escape e comercial comumente usados para definir atributos de URL.
{#r_JSUtil-escapeAttr_S__table_p5v_c55_4t__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| texto | Cadeia de caracteres | O texto |
[Tabela 3. Parâmetros]

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

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | O texto com e comercial teve o escape correto. |
[Tabela 4. Retorna]

{#r_JSUtil-escapeAttr_S__table_q5v_c55_4t}  

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

Saída: este é o texto retornado. Se o texto for exibido na aplicação, a página renderizará o e comercial de escape com um único e comercial.

    sysparm_query=active=true&sysparm_view=special

## JSUtil - escapeText(cadeia de caracteres text) {#ariaid-title4}

Escapa caracteres XML inválidos, como "\< \> \&".
{#r_JSUtil-escapeText_S__table_amh_ms5_4t__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| texto | Cadeia de caracteres | O texto |
[Tabela 5. Parâmetros]

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

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | O texto com caracteres de escape adicionados. |
[Tabela 6. Retorna]

{#r_JSUtil-escapeText_S__table_bmh_ms5_4t}  

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

Saída: este é o valor retornado. Se o resultado for exibido na aplicação, a página renderizará os colchetes para que pareça que não foi escapado.

    <b>This is my title</b>

## JSUtil - getBooleanValue(GlideRecord now_GR, campo de cadeia de caracteres) {#ariaid-title5}

Retorna o valor em um campo GlideRecord booliano.
{#r_JSUtil-getBooleanValue_GR_S__table_mtb_ml5_4t__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| now_GR | GlideRecord | Um GlideRecord |
| Assunto: | Cadeia de caracteres | O campo do qual o valor booliano será recuperado. |
[Tabela 7. Parâmetros]

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

| Tipo | Descrição |
|-|-|
| Booliano | Retorna o valor em um campo GlideRecord booliano, retorna verdadeiro se o valor do campo for verdadeiro, "verdadeiro", 1 ou "1". |
[Tabela 8. Retorna]

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

Saída: verdadeiro

## JSUtil - has(item de objeto) {#ariaid-title6}

Verifica se o item não é nulo e indefinido.
{#r_JSUtil-has_O__table_xmc_kg5_4t__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| item | Objeto | O objeto a ser verificado |
[Tabela 9. Parâmetros]

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

| Tipo | Descrição |
|-|-|
| Booliano | Verdadeiro se o objeto especificado não for nulo e não for indefinido. |
[Tabela 10. Retorna]

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

Saída:

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

## JSUtil - instance_of (item de objeto, classe de cadeia de caracteres) {#ariaid-title7}

Verifica se o objeto especificado é um membro da classe especificada.
Para objetos JavaScript, este método se comporta exatamente como o operador JavaScript "instanceof", mas também oferece suporte a objetos Java.
{#r_JSUtil-instance_of_O_S__table_uh2_s35_4t__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| item | Objeto | O objeto a ser verificado |
| classe | Cadeia de caracteres | A classe a ser verificada |
[Tabela 11. Parâmetros]

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

| Tipo | Descrição |
|-|-|
| Booliano | Verdadeiro se o objeto especificado for um membro da classe especificada. |
[Tabela 12. Retorna]

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

Saída:

    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(valor do objeto) {#ariaid-title8}

Verifica se o objeto especificado é uma classe Java.
{#r_JSUtil-isJavaObject_O__table_eff_2k5_4t__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| valor | Objeto | O objeto a ser verificado |
[Tabela 13. Parâmetros]

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

| Tipo | Descrição |
|-|-|
| Booliano | Verdadeiro se o objeto especificado for uma instância de uma classe Java. |
[Tabela 14. Retorna]

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

Saída:

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

## JSUtil - logObject (objeto de objeto, nome de cadeia de caracteres) {#ariaid-title9}

Registra em log todas as propriedades no objeto fornecido: nome, tipo e valor.
A saída será gravada no console se você estiver executando a partir de um script em segundo plano ou se o registro em log de depuração estiver habilitado. A saída também é gravada no log do sistema.
{#r_JSUtil-logObject_O_S__table_ozw_tr5_4t__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| obj | Objeto | O objeto para o qual enumerar propriedades |
| nome | Cadeia de caracteres | Nome opcional para o objeto registrado |
[Tabela 15. Parâmetros]

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

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 16. Retorna]

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

Saída:

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

## JSUtil -- nil(item do objeto) {#ariaid-title10}

Verifica se o item é nulo, indefinido ou é avaliado como uma cadeia de caracteres vazia.
{#r_JSUtil-nil_O__table_bjp_mh5_4t__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| item | Objeto | O objeto a ser verificado |
[Tabela 17. Parâmetros]

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

| Tipo | Descrição |
|-|-|
| Booliano | Verdadeiro se o item for nulo, indefinido ou avaliado como uma cadeia de caracteres vazia. |
[Tabela 18. Retorna]

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

Saída:

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

## JSUtil - notNil(item do objeto) {#ariaid-title11}

Verifica se um item é nulo, indefinido ou é avaliado como uma cadeia de caracteres vazia.
Nota:  
Este método retornará um erro se o objeto fornecido não for declarado.
{#r_JSUtil-notNil_O__table_trk_f35_4t__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| item | Objeto | O objeto a ser verificado. |
[Tabela 19. Parâmetros]

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

| Tipo | Descrição |
|-|-|
| Booliano | Sinalizador que indica se o item existe e não está vazio. Um erro será retornado se o objeto fornecido não for declarado. Valores válidos: * verdadeiro: o objeto fornecido foi declarado e definido. Se o objeto for uma cadeia de caracteres, ele não estará vazio. * falso: o objeto fornecido é nulo, indefinido ou é avaliado como uma cadeia de caracteres vazia. {#r_JSUtil-notNil_O__ul_zcy_nr3_myb} |
[Tabela 20. Retorna]

{#r_JSUtil-notNil_O__table_urk_f35_4t}  
O exemplo a seguir mostra resultados para uma variável de cadeia de caracteres, uma variável de cadeia de caracteres vazia e uma variável indefinida.

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

Saída:

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

## JSUtil - toBoolean(item do objeto) {#ariaid-title12}

Converte o objeto especificado em um booliano.
{#r_JSUtil-toBoolean_O__table_vdm_tk5_4t__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| item | Objeto | O objeto a ser convertido |
[Tabela 21. Parâmetros]

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

| Tipo | Descrição |
|-|-|
| Booliano | Se o objeto especificado for um booliano, ele será passado. Números diferentes de zero retornam verdadeiro. Retorno nulo ou indefinido falso. As cadeias de caracteres retornarão verdadeiro somente se forem exatamente iguais a "verdadeiro". |
[Tabela 22. Retorna]

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

Saída:

    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 (valor do objeto) {#ariaid-title13}

Determina o tipo do objeto especificado.
{#r_JSUtil-type_of_O__table_ic5_lj5_4t__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| valor | Objeto | O objeto a ser verificado |
[Tabela 23. Parâmetros]

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

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | O tipo do objeto especificado. * 'nulo' se o valor fornecido for nulo ou indefinido * 'cadeia de caracteres' se o valor fornecido for uma cadeia de caracteres primária ou uma instância de wrapper de cadeia de caracteres * 'number' se o valor fornecido for um número primitivo ou uma instância de wrapper de número * 'booliano' se o valor fornecido for um booliano primitivo ou uma instância de wrapper booliano * 'function' se o valor fornecido for uma função * 'objeto' caso contrário {#r_JSUtil-type_of_O__ul_rjh_sj5_4t} |
[Tabela 24. Retorna]

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

Saída:

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

Restaurar e comercial do texto de escape.
{#r_JSUtil-unescapeAttr_S__table_nqy_t55_4t__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| texto | Cadeia de caracteres | O texto |
[Tabela 25. Parâmetros]

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

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | O texto com caracteres de escape removidos. |
[Tabela 26. Retorna]

{#r_JSUtil-unescapeAttr_S__table_oqy_t55_4t}  

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

Saída:

    sysparm_query=active=true&sysparm_view=special

## JSUtil - unescapeText(cadeia de caracteres text) {#ariaid-title15}

Remove caracteres de escape.
{#r_JSUtil-unescapeText_S__table_j3r_jt5_4t__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| texto | Cadeia de caracteres | O texto a ser processado. |
[Tabela 27. Parâmetros]

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

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | O texto sem caracteres de escape. |
[Tabela 28. Retorna]

{#r_JSUtil-unescapeText_S__table_k3r_jt5_4t}  

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

Saída: este é o valor retornado. Se o texto for exibido na página da aplicação, ele renderizará os marcadores html e exibirá o texto em negrito.

    <b>This is my title</b>