1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
|
---
title: background
slug: Mozilla/Add-ons/WebExtensions/manifest.json/background
tags:
- Manifest
- WebExtensions
- הרחבות
- הרחבות רשת
- עיון
- תוספים
translation_of: Mozilla/Add-ons/WebExtensions/manifest.json/background
---
<div>{{AddonSidebar}}</div>
<table class="fullwidth-table standard-table">
<tbody>
<tr>
<th scope="row" style="width: 30%;">טיפוס</th>
<td><code>Object</code></td>
</tr>
<tr>
<th scope="row">חובה</th>
<td>לא</td>
</tr>
<tr>
<th scope="row">דוגמה</th>
<td>
<pre class="brush: json no-line-numbers notranslate">
"background": {
"scripts": ["background.js"]
}</pre>
</td>
</tr>
</tbody>
</table>
<p>השתמשו במפתח <code>background</code> כדי לכלול תסריט רקע אחד או יותר, עם אפשרות לדף רקע בהרחבתכם.</p>
<p>תסריטי רקע הם המקום לשים קוד שצריך לתחזק מצב לטווח ארוך, או לבצע פעולות לטווח ארוך, ללא תלות בזמן החיים של דף מסוים מהרשת או חלון דפדפן.</p>
<p>תסריטי רקע נטענים מיד כשההרחבה נטענת והם נשארים טעונים עד אשר ההרחבה מושבתת או מבוטלת, אלא אם <code>persistent</code> מקבל את הערך <code>false</code>. תוכלו להשתמש בכל אחד ממשקי פיתוח היישומים של הרחבות הרשת בתסריט, כל עוד ביקשתם את <a href="/he/docs/Mozilla/Add-ons/WebExtensions/manifest.json/permissions">ההרשאות</a> הנחוצות.</p>
<p>ראו גם את הקטע "תסריטי רקע" ב- <a href="/he/docs/Mozilla/Add-ons/WebExtensions/Anatomy_of_a_WebExtension">אנטומיה של הרחבה</a> לפרטים נוספים.</p>
<p>המפתח <code>background</code> הוא אובייקט שעשויות להיות לו שתי תכונות, ושתיהן אופציונליות:</p>
<table class="standard-table">
<tbody>
<tr>
<td><code>scripts</code></td>
<td>
<p>מערך <code>(Array)</code> של מחרוזות ( <code>Strings</code>), שכל אחת מהן היא מסלול למקור בג'אווה-סקריפט. המסלול יחסי לקובץ manifest.json עצמו. אלה התסריטים שיבוצעו בדף הרקע של ההרחבה.</p>
<p>התסריט משתף את אותו הקשר גלובלי <code>window</code>.</p>
<p>התסריטים נטענים על פי הסדר בו הם מופיעים במערך.</p>
<p>אם תציינו ערך עבור <code>scripts</code>, דף ריק יווצר בו יורץ התסריט.</p>
<div class="note">
<p><strong>לתשומת לבך:</strong> אם ברצונך להביא תסריט ממיקום מרוחק עם התגית <code><script></code> (לדוגמה,. <code><script src = "https://code.jquery.com/jquery-1.7.1.min.js"></code>), יהא עליך לשנות גם את המפתח <code><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/content_security_policy">content_security_policy</a></code> בקובץ manifest.json של ההרחבה שלך.</p>
</div>
<div class="note">
<p><strong>לתשומת לבך:</strong> בגרסאות פיירפוקס שקדמו לגרסה 50, כשהדיבאגר היה פתוח, תסריטים לא תמיד נטענו על פי הסדר הניתן במערך . כדי לעקוף באג זה, ניתן להשתמש בתכונה <code>page</code> ולכלול תסריטי רקע מהדף באמצעות תגיות <code><script></code>. באג זה תוקן בפיירפוקס 50. מנקודה זו ואילך, תסריטים נטענים תמיד על פי הסדר הנתון במערך.</p>
</div>
</td>
</tr>
<tr>
<td><code>page</code></td>
<td>
<p>אם יש לך צורך בתוכן כלשהו בדף, ניתן להגדיר דף משלך באמצעות התכונה <code>page</code>, שהיא מחרוזת ( <code>String</code> ), המייצגת מסלול, יחסי לקובץ manifest.json, למסמך HTML הכלול בחבילת ההרחבה שלך.</p>
<p>אם נעשה שימוש בתכונה זו, לא יהיה ניתן לציין תסריטי רקע באמצעות <code>scripts</code>, אך יהיה ניתן לכלול תסריטים משלך מהדף, בדיוק כשם שזה נעשה בדף רגיל מהרשת.</p>
</td>
</tr>
</tbody>
</table>
<p>המפתח <code>background</code> יכול לכלול גם את התכונה האופציונלית הבאה:</p>
<table class="standard-table">
<tbody>
<tr>
<td><code>persistent</code></td>
<td>
<p>ערך בוליאני( <code>Boolean</code> ).</p>
<ul>
<li><code>true</code> מציין כי דף הרקע נועד להישמר בזכרון מהרגע שההרחבה נטענה או שהדפדפן הופעל עד שההרחבה מבוטלת או מושבתת, או שהדפדפן נסגר (כלומר, דף הרקע תמידי).</li>
<li><code>false</code> מציין כי דף הרקע עשוי להיות מוסר מהזיכרון כשלא פעיל ולהיווצר מחדש במידת הצורך. דפי רקע כאלה קרויים לפעמים דפי אירוע כי הם נטענים לזיכרון כדי לאפשר לדף הרקע לטפל באירועים להם הוא הוסיף מאזינים. רישום המאזיננים הוא תמידי כאשר הדף מוסר מהזיכרון, אך ערכים אחרים אינם ץמידי. אם תרצו לשמור מידע תמידית בדף אירועים , תוכלו להשתמש ב <a href="/he/docs/Mozilla/Add-ons/WebExtensions/API/storage">ממשק הפיתוח storage</a>.</li>
</ul>
</td>
</tr>
</tbody>
</table>
<h2 id="דוגמה">דוגמה</h2>
<pre class="brush: json no-line-numbers notranslate"> "background": {
"scripts": ["jquery.js", "my-background.js"]
}</pre>
<p>טוען שני תסריט רקע.</p>
<pre class="brush: json notranslate"> "background": {
"page": "my-background.html"
}</pre>
<p>תואן דף רקע מותאם אישית.</p>
<h2 id="תאימות_דפדפנים">תאימות דפדפנים</h2>
<p class="hidden">The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> and send us a pull request.</p>
<p>{{Compat("webextensions.manifest.background", 10)}}</p>
|
