Áú»¢¶Ä²©

1 Objetos JavaScript adicionales

¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô general

Esta secci¨®n describe las adiciones de Áú»¢¶Ä²© al lenguaje JavaScript implementado con Duktape y las funciones globales de JavaScript compatibles.

Objetos integrados

Áú»¢¶Ä²©

El objeto Áú»¢¶Ä²© proporciona interacci¨®n con la funcionalidad interna de Áú»¢¶Ä²©.

Ejemplo:

Áú»¢¶Ä²©.log(3, "esta es una entrada de registro escrita con el nivel de registro 'Advertencia'")

Puede utilizar los siguientes alias:

Ejemplo (retrasar la ejecuci¨®n 15 segundos):

Áú»¢¶Ä²©.sleep(15000)

HttpRequest

Este objeto encapsula el identificador cURL que permite realizar solicitudes HTTP simples. Los errores se lanzan como excepciones.

Ejemplo:

try {
           Áú»¢¶Ä²©.log(4, 'valor del script de jira webhook='+valor);
         
           var result = {
               'tags': {
                   'endpoint': 'jira'
               }
           },
           params = JSON.parse(value),
           req = new HttpRequest(),
           fields = {},
           resp;
         
           req.addHeader('Content-Type: application/json');
           req.addHeader('Authorization: Basic '+params.authentication);
         
           fields.summary = params.summary;
           fields.description = ±è²¹°ù¨¢³¾±ð³Ù°ù´Ç²õ.description;
           fields.project = {"key": params.project_key};
           fields.issuetype = {"id": params.issue_id};
           resp = req.post('https://jira.example.com/rest/api/2/issue/',
               JSON.stringify({"fields": fields})
           );
         
           if ( (req.getStatus() != 201) {
               throw 'C¨®digo de respuesta: '+req.getStatus();
           }
         
           resp = JSON.parse(resp);
           result.tags.issue_id = resp.id;
           result.tags.issue_key = resp.key;
       } catch (error) {
           Áú»¢¶Ä²©.log(4, 'fall¨® la creaci¨®n del problema de jira json: '+JSON.stringify({"fields": fields}));
           Áú»¢¶Ä²©.log(4, 'Error al crear el problema de Jira: '+error);
         
           result = {};
       }
         
       return JSON.stringify(result);

XML

El objeto XML permite el procesamiento de datos XML en la m¨¦trica y el preprocesamiento del descubrimiento de bajo nivel y webhooks.

Ejemplo:

Entrada:

<menu>
           <food type = "breakfast">
               <name>Chocolate</name>
               <price>$5.95</price>
               <description></description>
               <calories>650</calories>
           </food>
       </menu>

Salida:

{
           "menu": {
               "food": {
                   "@type": "breakfast",
                   "name": "Chocolate",
                   "price": "$5.95",
                   "description": null,
                   "calories": "650"
               }
           }
       }

Reglas de serializaci¨®n

La conversi¨®n de XML a JSON se procesar¨¢ de acuerdo con las siguientes reglas (para conversiones de JSON a XML se aplican reglas invertidas):

1. Los atributos XML se convertir¨¢n en claves que tendr¨¢n sus nombres antepuestos por "@".

Ejemplo:

Entrada:

 <xml foo="FOO">
          <bar>
            <baz>BAZ</baz>
          </bar>
        </xml>

±Ê°ù´Ç»å³Ü³¦³¦¾±¨®²Ô:

 {
          "xml": {
            "@Foo Foo",
            "bar": {
              "baz": "BAZ"
            }
          }
        }

2. Los elementos de cierre autom¨¢tico (<foo/>) se convertir¨¢n como si tuvieran valor nulo.

Ejemplo:

Entrada:

<xml>
         <foo/>
       </xml>

Salida:

{
         "xml": {
           "foo": null
         }
       }

3. Los atributos vac¨ªos (con valor "") se convertir¨¢n como si tuvieran un valor de cadena vac¨ªa.

Ejemplo:

Entrada:

<xml>
         <foo bar="" />
       </xml>

Salida:

{
         "xml": {
           "foo": {
             "@bar": ""
           }
         }
       }

4. Varios nodos secundarios con el mismo nombre de elemento se convertir¨¢n en una ¨²nica clave que tiene una matriz de valores como valor.

Ejemplo:

Entrada:

<xml>
         <foo>BAR</foo>
         <foo>BAZ</foo>
         <foo>QUX</foo>
       </xml>

Salida:

{
         "xml": {
           "foo": ["BAR", "BAZ", "QUX"]
         }
       }

5. Si un elemento de texto no tiene atributos ni hijos, ser¨¢ convertido como una cadena.

Ejemplo:

Entrada:

<xml>
           <foo>BAZ</foo>
       </xml>

Salida:

{
         "xml": {
           "foo": "BAZ"
          }
       }

6. Si un elemento de texto no tiene hijos, pero tiene atributos: el contenido de texto se convertir¨¢ en un elemento con la clave '#text' y el contenido como valor; Los atributos se convertir¨¢n como se describe en la regla 1 de serializaci¨®n.

Ejemplo:

Entrada:

<xml>
         <foo bar="BAR">
           BAZ
         </foo>
       </xml>

Salida:

{
         "xml": {
           "foo": {
             "@bar": "BAR",
             "#text": "BAZ"
           }
         }
       }

Funciones globales de JavaScript

Se han implementado funciones globales adicionales de JavaScript con Duktape:

• btoa(datos) - codifica los datos en una cadena base64
• atob(base64_string) - decodifica cadena base64

try {
           b64 = btoa("cadena utf8");
           utf8 = atob(b64);
       }
       catch (error) {
           return {'error.name': error.name, 'error.message': error.message}
       }

• md5(datos) - calcula el hash MD5 de los datos

• sha256(datos) - calcula el hash SHA256 de los datos

• hmac('<tipo de hash>',key,data) - devuelve el hash HMAC como una cadena con formato hexadecimal; Se admiten los tipos de hash MD5 y SHA256; Los ±è²¹°ù¨¢³¾±ð³Ù°ù´Ç²õ clave y de datos admiten datos binarios. Ejemplos:

  • hmac('md5',clave,datos)
  • hmac('sha256',clave,datos)

• sign(hash,key,data) - devuelve la firma calculada (firma RSA con SHA-256) como una cadena, donde:
  hash: solo se permite 'sha256'; de lo contrario, se genera un error;
  clave - la clave privada. Debe corresponder al est¨¢ndar PKCS#1 o PKCS#8. La clave se puede proporcionar de diferentes formas:
  

  • con espacios en lugar de nuevas l¨ªneas;
  • con ''s con escape o sin escape en lugar de nuevas l¨ªneas;
  • sin nuevas l¨ªneas como una cadena de una sola l¨ªnea;
  • como una cadena con formato JSON.

  La clave tambi¨¦n se puede cargar desde una macro de usuario/macro secreta/b¨®veda.

  datos: los datos que se firmar¨¢n. Puede ser una cadena (tambi¨¦n se admiten datos binarios) o un b¨²fer (Uint8Array/ArrayBuffer).
  Se utiliza OpenSSL o GnuTLS para calcular las firmas. Si Áú»¢¶Ä²© se cre¨® sin ninguna de estas bibliotecas de cifrado, se generar¨¢ un error ('falta la biblioteca OpenSSL o GnuTLS').
  Esta funci¨®n es compatible desde Áú»¢¶Ä²© 6.4.1.