[comment]: # translation:outdated

[comment]: # ({d3accdff-d3accdff})
# אובייקטי JavaScript נוספים

[comment]: # ({/d3accdff-d3accdff})

[comment]: # ({dfa8c394-ab8bd378})
ופונקציות

[comment]: # ({/dfa8c394-ab8bd378})

[comment]: # ({c73f2449-c73f2449})
### אובייקטים מובנים

[comment]: # ({/c73f2449-c73f2449})

[comment]: # ({500e2fca-e5dc8dd0})
#### Zabbix

אובייקט Zabbix מספק אינטראקציה עם הפונקציונליות הפנימית של Zabbix.

|שיטה|תיאור|
|--|--------|
|`log(loglevel, message)`|כותב <הודעה> לתוך יומן Zabbix באמצעות רמת יומן <loglevel> (ראה פרמטר DebugLevel של קובץ התצורה).|

דוגמא:

     Zabbix.log(3, "זהו ערך יומן שנכתב ברמת היומן 'אזהרה'")

אתה יכול להשתמש בכינויים הבאים:

|כינוי|כינוי ל|
|-----|--------|
|console.log(object)|Zabbix.log(4, JSON.stringify(object))|
|console.warn(object)|Zabbix.log(3, JSON.stringify(object))|
|console.error(object)|Zabbix.log(2, JSON.stringify(object))|

::: שימו לב חשוב
הגודל הכולל של כל ההודעות שנרשמו מוגבל ל-8 MB לכל ביצוע סקריפט.
:::

|שיטה|תיאור|
|--|--------|
|`sleep(delay)`|השהיית ביצוע JavaScript ב-`delay` אלפיות שניות.|

דוגמה (עיכוב ביצוע ב-15 שניות):

     Zabbix.sleep(15000)

[comment]: # ({/500e2fca-e5dc8dd0})

[comment]: # ({new-413974f8})
#### HttpRequest

This object encapsulates cURL handle allowing to make simple HTTP requests.
Errors are thrown as exceptions.

::: noteimportant
The initialization of multiple `HttpRequest` objects is limited to 10 per script execution.
:::

|Method|Description|
|--|--------|
|`addHeader(name, value)`|Adds HTTP header field. This field is used for all following requests until cleared with the `clearHeader()` method.<br>The total length of header fields that can be added to a single `HttpRequest` object is limited to 128 Kbytes (special characters and header names included).|
|`clearHeader()`|Clears HTTP header. If no header fields are set, `HttpRequest` will set Content-Type to application/json if the data being posted is JSON-formatted; text/plain otherwise.|
|`connect(url)`|Sends HTTP CONNECT request to the URL and returns the response.|
|`customRequest(method, url, data)`|Allows to specify any HTTP method in the first parameter. Sends the method request to the URL with optional *data* payload and returns the response.|
|`delete(url, data)`|Sends HTTP DELETE request to the URL with optional *data* payload and returns the response.|
|`getHeaders(<asArray>)`|Returns the object of received HTTP header fields.<br>The `asArray` parameter may be set to "true" (e.g. `getHeaders(true)`), "false" or be undefined. If set to "true" the received HTTP header field values will be returned as arrays; this should be used to retrieve the field values of multiple same-name headers.<br>If not set or set to "false", the received HTTP header field values will be returned as strings.|
|`get(url, data)`|Sends HTTP GET request to the URL with optional *data* payload and returns the response.|
|`head(url)`|Sends HTTP HEAD request to the URL and returns the response.|
|`options(url)`|Sends HTTP OPTIONS request to the URL and returns the response.|
|`patch(url, data)`|Sends HTTP PATCH request to the URL with optional *data* payload and returns the response.|
|`put(url, data)`|Sends HTTP PUT request to the URL with optional *data* payload and returns the response.|
|`post(url, data)`|Sends HTTP POST request to the URL with optional *data* payload and returns the response.|
|`getStatus()`|Returns the status code of the last HTTP request.|
|`setProxy(proxy)`|Sets HTTP proxy to "proxy" value. If this parameter is empty then no proxy is used.|
|`setHttpAuth(bitmask, username, password)`|Sets enabled HTTP authentication methods (HTTPAUTH\_BASIC, HTTPAUTH\_DIGEST, HTTPAUTH\_NEGOTIATE, HTTPAUTH\_NTLM, HTTPAUTH\_NONE) in the 'bitmask' parameter.<br>The HTTPAUTH\_NONE flag allows to disable HTTP authentication.<br>Examples:<br>`request.setHttpAuth(HTTPAUTH_NTLM \| HTTPAUTH_BASIC, username, password)`<br>`request.setHttpAuth(HTTPAUTH_NONE)`|
|`trace(url, data)`|Sends HTTP TRACE request to the URL with optional *data* payload and returns the response.|

Example:

```javascript
try {
    Zabbix.log(4, 'jira webhook script value='+value);
  
    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 = params.description;
    fields.project = {"key": params.project_key};
    fields.issuetype = {"id": params.issue_id};
    resp = req.post('https://tsupport.zabbix.lan/rest/api/2/issue/',
        JSON.stringify({"fields": fields})
    );
  
    if (req.getStatus() != 201) {
        throw 'Response code: '+req.getStatus();
    }
  
    resp = JSON.parse(resp);
    result.tags.issue_id = resp.id;
    result.tags.issue_key = resp.key;
} catch (error) {
    Zabbix.log(4, 'jira issue creation failed json : '+JSON.stringify({"fields": fields}));
    Zabbix.log(4, 'jira issue creation failed : '+error);
  
    result = {};
}
  
return JSON.stringify(result);
```

[comment]: # ({/new-413974f8})

[comment]: # ({73df7bc5-06cac1ca})
#### XML

אובייקט ה-XML מאפשר עיבוד של נתוני XML בפריט ו
עיבוד מקדים לגילוי ברמה נמוכה ו-webhooks.

::: שימו לב חשוב
  על מנת להשתמש באובייקט XML, השרת/פרוקסי חייב להיות
הידור עם תמיכה ב-libxml2.
:::

|שיטה|תיאור|
|--|--------|
|`XML.query(data, expression)`|מאחזר תוכן צומת באמצעות XPath. מחזירה null אם הצומת לא נמצא.<br>**ביטוי** - ביטוי XPath;<br>**נתונים** - נתוני XML כמחרוזת.|
|`XML.toJson(data)`|ממיר נתונים בפורמט XML ל-JSON.|
|`XML.fromJson(object)`|ממיר נתונים בפורמט JSON ל-XML.|

דוגמא:

*קֶלֶט:*

     <תפריט>
         <סוג מזון = "ארוחת בוקר">
             <name>שוקולד</name>
             <price>$5.95</price>
             <description></description>
             <calories>650</calories>
         </food>
     </menu>

*תְפוּקָה:*

``` json
{
     "תפריט": {
         "מזון": {
             "@type": "ארוחת בוקר",
             "name": "שוקולד",
             "price": "$5.95",
             "תיאור": null,
             "קלוריות": "650"
         }
     }
}
```

[comment]: # ({/73df7bc5-06cac1ca})

[comment]: # ({9e03c929-a12fbdc2})
##### כללי סדרה

המרת XML ל-JSON תעובד לפי ההנחיות הבאות
כללים (עבור המרות JSON ל-XML מוחלים כללים הפוכים):

1\. תכונות XML יומרו למפתחות עם שמותיהם
עם '@'.

דוגמא:

*קֶלֶט:*

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

*תְפוּקָה:*

``` json
  {
    "xml": {
      "@foo": "FOO",
      "בר": {
        "baz": "BAZ"
      }
    }
  }
```

2\. אלמנטים סגירה עצמית (<foo/>) יומרו כבעלי
ערך 'null'.

דוגמא:

*קֶלֶט:*

     <xml>
       <foo/>
     </xml>

*תְפוּקָה:*

``` json
{
   "xml": {
     "foo": null
   }
}
```

3\. מאפיינים ריקים (עם ערך "") יומרו כריקים
ערך מחרוזת ('').

דוגמא:

*קֶלֶט:*

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

*תְפוּקָה:*

``` json
{
   "xml": {
     "פו": {
       "@bar": ""
     }
   }
}
```

4\. מספר צמתים צאצאים עם אותו שם אלמנט יומרו
מפתח בודד בעל מערך ערכים כערך שלו.

דוגמא:

*קֶלֶט:*

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

*תְפוּקָה:*

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

5\. אם לרכיב טקסט אין תכונות ואין ילדים, הוא יהיה
הומר כמחרוזת.

דוגמא:

*קֶלֶט:*

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

*תְפוּקָה:*

``` json
{
   "xml": {
     "foo": "BAZ"
    }
}
```

6\. אם לרכיב טקסט אין ילדים, אבל יש לו תכונות: תוכן טקסט
יומר לרכיב עם המפתח '\#text' ותוכן בתור
ערך; המאפיינים יומרו כמתואר בסידרה
חוק מספר 1.

דוגמא:

*קֶלֶט:*

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

*תְפוּקָה:*

``` json
{
   "xml": {
     "פו": {
       "@bar": "BAR",
       "#text": "BAZ"
     }
   }
}
```

[comment]: # ({/9e03c929-a12fbdc2})

[comment]: # ({79cc694a-1368a2b0})
### פונקציות JavaScript גלובליות

פונקציות JavaScript גלובליות נוספות יושמו עם Duktape:

- btoa(data) - מקודד את הנתונים למחרוזת base64
- atob(base64\_string) - מפענח מחרוזת base64

``` javascript
נסה {
     b64 = btoa("utf8 מחרוזת");
     utf8 = atob(b64);
}
לתפוס (שגיאה) {
     החזר {'error.name': error.name, 'error.message': error.message}
}
```

- md5(נתונים) - מחשב את ה-hash MD5 של הנתונים
- sha256(data) - מחשב את ה-hash SHA256 של הנתונים
- hmac('\<hash type\>',key,data) - מחזיר HMAC hash כמחרוזת בפורמט hex;
     סוגי hash MD5 ו-SHA256 נתמכים;
     פרמטרי מפתח ונתונים תומכים בנתונים בינאריים. דוגמאות:
     - `hmac('md5',key,data)`
     - `hmac('sha256',key,data)`
- sign(hash,key,data) - מחזיר חתימה מחושבת (חתימת RSA עם SHA-256) כמחרוזת, כאשר:<br>
     **hash** - מותר רק 'sha256', אחרת נזרקת שגיאה;<br>
     **מפתח** - המפתח הפרטי. זה צריך להתאים לתקן PKCS#1 או PKCS#8. ניתן לספק את המפתח בצורות שונות:<br>
     - עם רווחים במקום שורות חדשות;
     - עם '\n'ים עם אסקייפ או ללא בריחה במקום שורות חדשות;
     - ללא שורות חדשות כמחרוזת בשורה אחת;
     - כמחרוזת בפורמט JSON.

     ניתן לטעון את המפתח גם ממאקרו/מאקרו סודי/כספת של המשתמש.

     **נתונים** - הנתונים שיחתמו. זה יכול להיות מחרוזת (נתמכים גם נתונים בינאריים) או מאגר (Uint8Array/ArrayBuffer).<br>
     OpenSSL או GnuTLS משמשים לחישוב החתימות. אם Zabbix נבנתה ללא אף אחת מספריות ההצפנה הללו, תיגרם שגיאה ('חסרה ספריית OpenSSL או GnuTLS').<br>פונקציה זו נתמכת מאז Zabbix 6.0.15.

[comment]: # ({/79cc694a-1368a2b0})