[comment]: # translation:outdated

[comment]: # ({213e862c-213e862c})
# 4 עיבוד טרומי של JavaScript

[comment]: # ({/213e862c-213e862c})

[comment]: # ({be838628-57d3be9d})
#### סקירה כללית

סעיף זה מספק פרטים על עיבוד מקדים על ידי JavaScript.

[comment]: # ({/be838628-57d3be9d})

[comment]: # ({bf4c42bc-076d2285})
#### עיבוד מקדים של JavaScript

עיבוד מקדים של JavaScript נעשה על ידי הפעלת פונקציית JavaScript עם a
פרמטר בודד 'ערך' וגוף הפונקציה שסופק על ידי המשתמש. ה
תוצאת שלב העיבוד המקדים היא הערך המוחזר מפונקציה זו, for
לדוגמה, כדי לבצע המרת פרנהייט לצלזיוס על המשתמש להזין:

     החזר (ערך - 32) * 5/9

בפרמטרים של עיבוד מקדים של JavaScript, שיהיו עטופים ב-a
פונקציית JavaScript לפי שרת:

``` {.java}
פונקציה (ערך)
{
    החזר (ערך - 32) * 5/9
}
```

פרמטר הקלט 'ערך' מועבר תמיד כמחרוזת. השיבה
הערך נכפה אוטומטית למחרוזת באמצעות שיטת ToString() (אם זה
נכשל אז השגיאה מוחזרת כערך מחרוזת), עם כמה
חריגים:

- החזרת ערך לא מוגדר תגרום לשגיאה
- החזרת ערך null תגרום לביטול ערך הקלט,
     בדומה לעיבוד מקדים של 'מחק ערך' בפעולה 'מותאם אישית בכשל'.

ניתן להחזיר שגיאות על ידי זריקת ערכים/אובייקטים (בדרך כלל
מחרוזות או אובייקטי שגיאה).

לדוגמה:

``` {.java}
if (ערך == 0)
     זרוק "ערך קלט אפס"
החזר 1/ערך
```

לכל סקריפט יש פסק זמן של 10 שניות לביצוע (תלוי בסקריפט
יתכן שיחלוף זמן רב יותר עד שהפסקה יופעל); מעבר לכך יהיה
שגיאת החזרה. מגבלת ערימה של 64 מגה בייט נאכפת.

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

כשלים רצופים בזמן ריצה (3 ברצף) יגרמו למנוע להיות
אתחול מחדש כדי להפחית את האפשרות שתסריט אחד ישבור את
סביבת ביצוע עבור הסקריפטים הבאים (פעולה זו נרשמת עם
DebugLevel 4 ומעלה).

עיבוד מקדים של JavaScript מיושם עם Duktape
(<https://duktape.org/>) מנוע JavaScript.

ראה גם: [אובייקטי JavaScript נוספים וגלובליים
functions](/manual/config/items/preprocessing/javascript/javascript_objects)

[comment]: # ({/bf4c42bc-076d2285})

[comment]: # ({23c7c867-c932b901})
##### שימוש בפקודות מאקרו בסקריפטים

אפשר להשתמש בפקודות מאקרו של משתמש בקוד JavaScript. אם תסריט
מכיל פקודות מאקרו של משתמש, פקודות מאקרו אלו נפתרות על ידי שרת/פרוקסי לפני כן
ביצוע שלבי עיבוד מקדים ספציפיים. שימו לב, כי בעת בדיקה
שלבי עיבוד מקדים ב-frontend, ערכי מאקרו לא יימשכו ו
צריך להזין באופן ידני.

::: noteclassic
  מתעלמים מהקשר כאשר מאקרו מוחלף בערך שלו.
ערך מאקרו מוכנס לקוד כפי שהוא, לא ניתן להוסיף
בריחה נוספת לפני הצבת הערך בקוד JavaScript.
שים לב שזה עלול לגרום לשגיאות JavaScript במקרים מסוימים.

:::

בדוגמה למטה, אם הערך שהתקבל חורג מאקרו {$THRESHOLD}
ערך, ערך הסף (אם קיים) יוחזר במקום זאת:

``` {.java}
var threshold = '{$THRESHOLD}';
return (!isNaN(threshold) && value > threshold) ? ערך סף;
```

[comment]: # ({/23c7c867-c932b901})

[comment]: # ({new-29d0516e})
### Examples

The following examples illustrate how you can use JavaScript preprocessing.

Each example contains a brief description, a function body for JavaScript preprocessing parameters, and the preprocessing step result - value returned by the function.

[comment]: # ({/new-29d0516e})

[comment]: # ({new-85fe10ec})
##### Example 1: Convert a number (scientific notation to integer)

Convert the number "2.62128e+07" from scientific notation to an integer.

```javascript
return (Number(value))
```

Value returned by the function: 26212800.

[comment]: # ({/new-85fe10ec})

[comment]: # ({new-cb346f3f})
##### Example 2: Convert a number (binary to decimal)

Convert the binary number "11010010" to a decimal number.

```javascript
return(parseInt(value,2))
```

Value returned by the function: 210.

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

[comment]: # ({new-b90c2a4e})
##### Example 3: Round a number

Round the number "18.2345" to 2 digits.

```javascript
return(Math.round(value* 100) / 100)
```

Value returned by the function: 18.23.

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

[comment]: # ({new-3ccbf334})
##### Example 4: Count letters in a string

Count the number of letters in the string "Zabbix".

```javascript
return (value.length)
```

Value returned by the function: 6.

[comment]: # ({/new-3ccbf334})

[comment]: # ({new-1a7f5b1b})
##### Example 5: Get time remaining

Get the remaining time (in seconds) until the expiration date of a certificate (Feb 12 12:33:56 2022 GMT).

```javascript
var split = value.split(' '),
    MONTHS_LIST = ['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec'],
    month_index = ('0' + (MONTHS_LIST.indexOf(split[0]) + 1)).slice(-2),
    ISOdate = split[3] + '-' + month_index + '-' + split[1] + 'T' + split[2],
    now = Date.now();

return parseInt((Date.parse(ISOdate) - now) / 1000);
```

Value returned by the function: 44380233.

[comment]: # ({/new-1a7f5b1b})

[comment]: # ({new-04fc1390})
##### Example 6: Remove JSON properties

Modify the JSON data structure by removing any properties with the key `"data_size"` or `"index_size"`.

```javascript
var obj=JSON.parse(value);

for (i = 0; i < Object.keys(obj).length; i++) {
    delete obj[i]["data_size"];
    delete obj[i]["index_size"];
}

return JSON.stringify(obj)
```

Value accepted by the function:

```json
[
    {
        "table_name":"history",
        "data_size":"326.05",
        "index_size":"174.34"
    },
    {
        "table_name":"history_log",
        "data_size":"6.02",
        "index_size":"3.45"
    }
]
```

Value returned by the function:

```json
[
    {
        "table_name":"history"
    },
    {
        "table_name":"history_log"
    }
]
```

[comment]: # ({/new-04fc1390})

[comment]: # ({new-7fbf2a11})
##### Example 7: Convert Apache status to JSON

Convert the value received from a [web.page.get](/manual/config/items/itemtypes/zabbix_agent#web.page.gethostpathport) Zabbix agent item (e.g., web.page.get[http://127.0.0.1:80/server-status?auto]) to a JSON object.

```javascript
// Convert Apache status to JSON

// Split the value into substrings and put these substrings into an array
var lines = value.split('\n');

// Create an empty object "output"
var output = {};

// Create an object "workers" with predefined properties
var workers = {
    '_': 0, 'S': 0, 'R': 0, 'W': 0,
    'K': 0, 'D': 0, 'C': 0, 'L': 0,
    'G': 0, 'I': 0, '.': 0
};

// Add the substrings from the "lines" array to the "output" object as properties (key-value pairs)
for (var i = 0; i < lines.length; i++) {
    var line = lines[i].match(/([A-z0-9 ]+): (.*)/);

    if (line !== null) {
        output[line[1]] = isNaN(line[2]) ? line[2] : Number(line[2]);
    }
}

// Multiversion metrics
output.ServerUptimeSeconds = output.ServerUptimeSeconds || output.Uptime;
output.ServerVersion = output.ServerVersion || output.Server;

// Parse "Scoreboard" property to get the worker count
if (typeof output.Scoreboard === 'string') {
    for (var i = 0; i < output.Scoreboard.length; i++) {
        var char = output.Scoreboard[i];

        workers[char]++;
    }
}

// Add worker data to the "output" object
output.Workers = {
    waiting: workers['_'], starting: workers['S'], reading: workers['R'],
    sending: workers['W'], keepalive: workers['K'], dnslookup: workers['D'],
    closing: workers['C'], logging: workers['L'], finishing: workers['G'],
    cleanup: workers['I'], slot: workers['.']
};

// Return JSON string
return JSON.stringify(output);
```

Value accepted by the function:

    HTTP/1.1 200 OK
    Date: Mon, 27 Mar 2023 11:08:39 GMT
    Server: Apache/2.4.52 (Ubuntu)
    Vary: Accept-Encoding
    Content-Encoding: gzip
    Content-Length: 405
    Content-Type: text/plain; charset=ISO-8859-1

    127.0.0.1
    ServerVersion: Apache/2.4.52 (Ubuntu)
    ServerMPM: prefork
    Server Built: 2023-03-08T17:32:01
    CurrentTime: Monday, 27-Mar-2023 14:08:39 EEST
    RestartTime: Monday, 27-Mar-2023 12:19:59 EEST
    ParentServerConfigGeneration: 1
    ParentServerMPMGeneration: 0
    ServerUptimeSeconds: 6520
    ServerUptime: 1 hour 48 minutes 40 seconds
    Load1: 0.56
    Load5: 0.33
    Load15: 0.28
    Total Accesses: 2476
    Total kBytes: 8370
    Total Duration: 52718
    CPUUser: 8.16
    CPUSystem: 3.44
    CPUChildrenUser: 0
    CPUChildrenSystem: 0
    CPULoad: .177914
    Uptime: 6520
    ReqPerSec: .379755
    BytesPerSec: 3461.58
    BytesPerReq: 3461.58
    DurationPerReq: 21.2916
    BusyWorkers: 2
    IdleWorkers: 6
    Scoreboard: ____KW__..............................................................................................................................................

Value returned by the function:

```json
{
    "Date": "Mon, 27 Mar 2023 11:08:39 GMT",
    "Server": "Apache/2.4.52 (Ubuntu)",
    "Vary": "Accept-Encoding",
    "Encoding": "gzip",
    "Length": 405,
    "Type": "text/plain; charset=ISO-8859-1",
    "ServerVersion": "Apache/2.4.52 (Ubuntu)",
    "ServerMPM": "prefork",
    "Server Built": "2023-03-08T17:32:01",
    "CurrentTime": "Monday, 27-Mar-2023 14:08:39 EEST",
    "RestartTime": "Monday, 27-Mar-2023 12:19:59 EEST",
    "ParentServerConfigGeneration": 1,
    "ParentServerMPMGeneration": 0,
    "ServerUptimeSeconds": 6520,
    "ServerUptime": "1 hour 48 minutes 40 seconds",
    "Load1": 0.56,
    "Load5": 0.33,
    "Load15": 0.28,
    "Total Accesses": 2476,
    "Total kBytes": 8370,
    "Total Duration": 52718,
    "CPUUser": 8.16,
    "CPUSystem": 3.44,
    "CPUChildrenUser": 0,
    "CPUChildrenSystem": 0,
    "CPULoad": 0.177914,
    "Uptime": 6520,
    "ReqPerSec": 0.379755,
    "BytesPerSec": 1314.55,
    "BytesPerReq": 3461.58,
    "DurationPerReq": 21.2916,
    "BusyWorkers": 2,
    "IdleWorkers": 6,
    "Scoreboard": "____KW__..............................................................................................................................................",
    "Workers": {
        "waiting": 6,
        "starting": 0,
        "reading": 0,
        "sending": 1,
        "keepalive": 1,
        "dnslookup": 0,
        "closing": 0,
        "logging": 0,
        "finishing": 0,
        "cleanup": 0,
        "slot": 142
    }
}
```

[comment]: # ({/new-7fbf2a11})