aboutsummaryrefslogtreecommitdiff
path: root/files/fr/tools/debugger/source_map_errors/index.html
blob: 3c7c1ff7e0bc39720542f0a8f267787f680fb704 (plain)
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
---
title: Erreurs des source map
slug: Tools/Debugger/Source_map_errors
translation_of: Tools/Debugger/Source_map_errors
original_slug: Outils/Débogueur/Source_map_errors
---
<div>{{ToolsSidebar}}</div>

<p class="summary">Les Source maps sont des fichiers JSON permettant d'associer les sources transformées (minifiés, combinés, générées) lues par le navigateur, à leurs fichiers source originels. Il est parfois possible d'avoir des problèmes avec les sources map. Cette page présente les plus communs d'entre eux ainsi que des solutions pour les corriger.</p>

<div class="note">
<p><strong>Note</strong>: En cas d'infamiliarité avec les source map, il est possible d'en apprendre plus ici : <a href="/fr/docs/Tools/Debugger/How_to/Use_a_source_map">Utiliser une source map</a>.</p>
</div>

<h2 id="Gestion_d'erreurs_des_source_map">Gestion d'erreurs des source map</h2>

<p>Dès lors qu'une erreur arrive, un message apparaitra dans la <a href="/fr/docs/Outils/Console_Web">Console</a>. Le message affichera le message d'erreur, l'URL de la ressource, et l'URL de la source map :</p>

<p><img alt="Error from invalid JSON" src="https://mdn.mozillademos.org/files/15423/invalid-json.png" style="border-style: solid; border-width: 1px; display: block; height: 57px; margin: 0px auto; width: 744px;"></p>

<p>Ici, l'URL de la ressource URL indique que <code>bundle.js</code> mentionne une source map, et l'URL de la source map montre ou trouver la source map en elle-même (avec un chemin relatif à la ressource). L'erreur indique que la source map n'est pas un JSON valide.</p>

<p>Il y a quelques erreurs fréquentes qui reviennent avec les sources map. Elles sont décrites dans les sections suivantes.</p>

<h2 id="La_source_map_est_inexistante_ou_inaccessible">La source map est inexistante ou inaccessible</h2>

<p><img alt="Source map file is missing" src="https://mdn.mozillademos.org/files/15429/missing-map.png" style="border-style: solid; border-width: 1px; display: block; height: 42px; margin: 0px auto; width: 733px;"></p>

<p>La solution ici est de vérifier que le fichier est bien accessible par le navigateur (le fichier existe, et l'URL est bonne).</p>

<h2 id="Source_map_invalide">Source map invalide</h2>

<p>Le code de la source map data peut être invalide. Soit parce que ce n'est tout simplement pas un fichier JSON, soit parce qu'il est mal formaté. Les messages d'erreurs typiques sont:</p>

<ul>
 <li><code>SyntaxError: JSON.parse: unexpected character at line 1 column 1 of the JSON data</code></li>
 <li><code>Error: "version" is a required argument</code></li>
</ul>

<p><img alt='Error: "version" is a required argument' src="https://mdn.mozillademos.org/files/15425/missing-field.png" style="border-style: solid; border-width: 1px; display: block; height: 45px; margin: 0px auto; width: 743px;"></p>

<h2 id="Source_originale_manquante">Source originale manquante</h2>

<p>Une source originale peut manquer. Il est possible d'avoir cette erreur en tentant d'ouvrir une source originale dans le Débogueur. Le message est un peu différent dans ce cas :</p>

<p><img alt="Debugger source tab showing the error" src="https://mdn.mozillademos.org/files/15421/Screenshot%20from%202017-09-15%2014-32-02.png" style="border-style: solid; border-width: 1px; display: block; height: 35px; margin: 0px auto; width: 727px;"></p>

<p>Ici, l'erreur sera également affichée dans l'onglet source du Débogueur :</p>

<p><img alt="Debugger source tab showing the error" src="https://mdn.mozillademos.org/files/15427/debugger-tab.png" style="border-style: solid; border-width: 1px; display: block; height: 109px; margin: 0px auto; width: 616px;"></p>

<h2 id="NetworkError_lors_de_la_récupération_d'une_ressource">NetworkError lors de la récupération d'une ressource</h2>

<p>Un bug dans Firefox l’empêche de charger les sources maps des extensions web.</p>

<p>Voir le <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1437937">Bug 1437937: WebExtensions Doesn't Find Source Maps</a> pour plus de détails.</p>

<pre class="syntaxbox"><span class="message-body-wrapper"><span class="message-flex-body"><span class="devtools-monospace message-body">Source-Map-Fehler: TypeError: NetworkError when attempting to fetch resource.
 Ressourcen-Adresse: moz-extension://c7f0f003-4fcf-49fd-8ec0-c49361266581/background.js
 Source-Map-Adresse: background.js.map</span></span></span></pre>

<p>Le seule workaround est de changer manuellement l'URL de la map pour la rendre publique (http://localhost:1234/file.map.js) et de lancer un serveur web local sur ce port.</p>