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
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
|
---
title: background
slug: Mozilla/Add-ons/WebExtensions/manifest.json/background
tags:
- Add-ons
- Extensions
- WebExtensions
translation_of: Mozilla/Add-ons/WebExtensions/manifest.json/background
original_slug: Mozilla/Add-ons/WebExtensions/manifest.json/arriere-plan
---
{{AddonSidebar}}
<table class="standard-table">
<tbody>
<tr>
<th scope="row" style="width: 30%">Type</th>
<td><code>Object</code></td>
</tr>
<tr>
<th scope="row">Obligatoire</th>
<td>No</td>
</tr>
<tr>
<th scope="row">Exemple</th>
<td>
<pre class="brush: json">
"background": {
"scripts": ["background.js"]
}</pre
>
</td>
</tr>
</tbody>
</table>
Utilisez la clé background pour inclure un ou plusieurs scripts d'arrière-plan, et éventuellement une page d'arrière-plan dans votre extension.
Les scripts d'arrière-plan sont l'endroit pour placer le code qui doit maintenir l'état à long terme, ou effectuer des opérations à long terme, indépendamment de la durée de vie de toutes les pages Web ou les fenêtres du navigateur.
Les scripts d'arrière-plan sont chargés dès que l'extension est chargée et restent chargés jusqu'à ce que l'extension soit désactivée ou désinstallée. Vous pouvez utiliser n'importe laquelle des WebExtension APIs dans le script, tant que vous avez demandé les [permissions](/fr/Add-ons/WebExtensions/manifest.json/permissions) nécessaires.
Voir la section "Pages arrière-plan" dans [l'anatomie d'une WebExtension](/fr/Add-ons/WebExtensions/Anatomy_of_a_WebExtension#Background_pages) pour plus de détails.
La clé background est un objet qui peut avoir l'une des deux propriétés suivantes, toutes deux facultatives :
<table class="standard-table">
<tbody>
<tr>
<td><code>"scripts"</code></td>
<td>
<p>
Un ensemble de chaînes, chacune étant un chemin d'accès à une source
JavaScript. Le chemin est relatif au fichier manifest.json lui-même.
Ce sont les scripts d'arrière-plan qui seront inclus dans l'extension.
</p>
<p>Les scripts partagent la même fenêtre globale.</p>
<p>
Les scripts sont chargés dans l'ordre où 'ils apparaissent dans le
tableau.
</p>
<p>
<strong
>Notez qu'il y a un bug affectant les versions de Firefox
antérieures à la version 50 </strong
>: lorsque le débogueur Firefox est ouvert, les scripts ne sont pas
toujours chargés dans l'ordre indiqué dans le tableau. Pour contourner
ce bug, vous pouvez utiliser la propriété "page" et inclure des
scripts de fond de page en utilisant les balises <script>. Ce bug
est résolu dans Firefox 50, et à partir de ce moment, les scripts sont
toujours chargés dans l'ordre indiqué dans le tableau.
</p>
</td>
</tr>
<tr>
<td><code>"page"</code></td>
<td>
<div class="note">
<p>
<strong>Note :</strong> Si vous souhaitez récupérer un script à
partir d'un emplacement distant avec la balise <script> (par
exemple : <script src =
"https://code.jquery.com/jquery-1.7.1.min.js"> ), vous devrez
également modifier la clé
<code
><a
href="/fr/Add-ons/WebExtensions/manifest.json/content_security_policy"
>content_security_policy</a
></code
>
dans le fichier manifest.json de votre extension.
</p>
</div>
<p>
Si vous spécifiez des "scripts", une page vide sera créée pour que vos
scripts s'exécutent.
</p>
<p>
Si vous avez besoin de contenu particulier dans la page, vous pouvez
définir votre propre page en utilisant l'option "page".
</p>
<p>
Si vous utilisez cette propriété, vous ne pouvez plus spécifier de
scripts de fond à l'aide de «scripts», mais vous pouvez inclure vos
propres scripts à partir de la page, tout comme dans une page Web
normale.
</p>
</td>
</tr>
</tbody>
</table>
## Exemple
```json
"background": {
"scripts": ["jquery.js", "my-background.js"]
}
```
Chargez deux scripts de fond.
```json
"background": {
"page": "my-background.html"
}
```
Chargez une page d'arrière-plan personnalisée.
## Compatibilité du navigateur
{{Compat("webextensions.manifest.background", 10)}}
|
