Source map errors

Source maps sind JSON files, die einen Weg bieten, transformierte Quellen, so wie sie vom Browser gesehen werden, mit Original Sourcen, so wie sie von einem Entwickler geschrieben wurden, in Einklang zu bringen. Manchmal erhält man Fehler, wenn man mit source maps arbeitet. Diese Seite erklärt die Probleme, die am häufigsten auftreten und wie man diese Probleme beheben kann.

Anmerkung: Wenn Sie mehr über das Thema source maps erfahren möchten, klicken Sie hier: How to use a source map.

Allgemeines source map error reporting

Wenn Sie ein Problem sehen, erscheint eine Meldung in der Webconsole. Diese Meldung enthält eine Fehlermeldung, die URL der Ressource und die URL der source map:

Error from invalid JSON

Hier wird uns mitgeteilt, dass bundle.js eine source map voraussetzt und die URL der source map sagt uns, wo die source-map-Daten zu finden sind (in diesem Fall relativ zur Ressoucre). Der Fehler teilt uns mit, dass die source map nicht im JSON-Format vorliegt - wir bieten also die falsche Datei an.

Source maps können in ein paar allgemeinen Fällen fehlerhaft sein; die folgenden Abschnitte beschrieben diese Fälle.

Source map nicht vorhanden oder nicht zugreifbar

Auf die source map Ressource kann nicht zugegriffen werden oder sie ist nicht vorhanden.

Source map file is missing

Die Lösung ist hier, sicherzustellen, dass auf die Datei zugegriffen werden kann.

Ungültige source map

Die Source Map Daten können ungültig sein — entweder, es ist überhaupt kein JSON file, oder es hat eine ungültige Struktur. Typische Fehlermeldungen sind hier:

  • SyntaxError: JSON.parse: unexpected character at line 1 column 1 of the JSON data
  • Error: "version" is a required argument

Error: "version" is a required argument

Originale Quelle fehlt

Es kann sein, dass eine originale Quelle fehlt. Sie werden dies eventuell feststellen, wenn Sie versuchen, eine der Original Sourcen im Debugger zu öffnen. Die Meldung sieht in diesem Fall ein bisschen anders aus:

Debugger source tab showing the error

In diesem Fall wird die Meldung auch im Source Tab im Debugger angezeigt:

Debugger source tab showing the error

Netzwerkfehler beim Zugriff auf die Ressource

Ein Fehler in Firefox verhindert, dass die Source map für web extensions geladen wird.

Details dazu finden Sie hier: Bug 1437937: WebExtensions Doesn't Find Source Maps.

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

Der einzige Weg, dies zu umgehen, besteht darin, die URL manuell auf eine öffentliche Adresse (http://localhost:1234/file.map.js) zu ändern und einen lokalen Webserver auf diesem Port zu starten.