
Du öffnest die Konsole und bevor etwas von dir gelaufen ist, stehen dort vier rote Zeilen über Source Maps, die nicht geladen werden konnten. Der Instinkt ist, in deine Build-Konfiguration zu schauen, weil die Worte eine Sache benennen, die dein Build erzeugt.
Das ist normalerweise der falsche Ort, und es lohnt sich zu wissen, warum, weil es etwa zehn Sekunden braucht, um zu sehen, wessen Problem es ist, und die meisten Menschen lernen den Trick nie.
Was wird eigentlich angefordert
Eine minifizierte Datei kann einen Zeiger auf eine Map tragen, die sie zur Quelle übersetzt, aus der sie gebaut wurde. Es gibt zwei Wege, einen anzuhängen.
Der übliche Weg ist ein Kommentar am Ende der Datei, //# sourceMappingURL=bundle.js.map. Der
andere ist ein HTTP-Header, und MDN ist klar darüber, welcher gewinnt: Der SourceMap-Header
“hat Vorrang vor einer Source-Annotation (sourceMappingURL=path-to-map-js.map), und falls beide
vorhanden sind, wird die Header-URL verwendet, um die Source-Map-Datei aufzulösen.” Es gibt auch
einen älteren X-SourceMap-Header, der veraltet ist.
Wofür die Map ist, ist ebenso spezifisch. In MDNs Worten, “Entwicklertools verwenden die Source Map, um den ursprünglichen Code aus dem optimierten JavaScript, das in der Antwort zurückkommt, zu rekonstruieren, sodass Entwickler den ursprünglichen Code debuggen können, anstatt des Formats, das für den Versand optimiert wurde.”
Wer stellt die Anfrage, das ist die erste nützliche Tatsache
Chromes eigene Dokumentation beantwortet das in einem Satz: “Wenn du DevTools öffnest, versucht es, Source Maps zu laden, falls vorhanden.”
Die Anfrage wird von deinen Entwicklertools auf deinem Rechner gestellt, weil du sie geöffnet hast. Ein Besucher mit geschlossener Konsole ruft diese Dateien nicht ab und sieht diese Zeilen nicht. Was immer das dich kostet, es kostet deine Benutzer nichts.
Das allein klärt die meiste Panik. Eine Seite ist nicht wegen dieser kaputt, nichts wird für jemanden langsamer, und kein benutzersichtbares Verhalten hängt davon ab.
Warum es normalerweise nicht dein ist
Das ist der Teil, der den Nachmittag spart.
Der Zeiger lebt in der Datei, die ausgeliefert wurde. Wenn diese Datei aus deinem eigenen Build
kam, ist der Zeiger deiner und die fehlende Map auch. Aber ein großer Teil dieser Zeilen kommt
von Code, den du nicht geschrieben hast: ein Package, das auf npm veröffentlicht wurde mit dem
sourceMappingURL-Kommentar noch drin und die .map-Datei rausgelassen, weil der Verleger sie
aus dem Package ausschloss, um den Download klein zu halten.
Dein Bundler hat den Kommentar treu kopiert, weil er ein Kommentar in einer Datei ist, die er einzubeziehen gebeten wurde. Es gibt nichts in deiner Konfiguration, das ihn erzeugt hat, und nichts da, das es beheben kann.
Lies also die URL in der Fehlermeldung, bevor du etwas änderst. Wenn der Pfad auf deine
eigene Build-Ausgabe zeigt, ist er dein. Wenn er in einen Vendor-Chunk, einen node_modules-Pfad
oder ein CDN zeigt, das du nicht kontrollierst, ist es eine Packaging-Entscheidung eines anderen,
und deine Optionen sind, es zu ignorieren oder aufzuhören, es zu laden.
Die drei Dinge, die es eigentlich verursachen
Die Map wurde nie veröffentlicht. Der häufigste Fall, und der oben. Nichts zu beheben.
Die Map existiert, aber die Anfrage kommt nicht durch. Chrome vermerkt, dass Source-Map-Anfragen “als Cross-Origin behandelt werden können und möglicherweise nicht durchkommen”, was der Fall ist, den man kennen sollte, weil er in der Konsole identisch aussieht und überhaupt keine fehlende Datei ist. Eine Map auf einem anderen Ursprung ohne großzügige Header schlägt genauso fehl wie eine, die nie hochgeladen wurde.
Die Map wurde absichtlich nicht deployt. Viele Teams bauen Maps und halten sie absichtlich aus dem öffentlichen Verzeichnis raus, sodass der ursprüngliche Code nicht von jedem herunterladbar ist, der die Entwicklertools öffnet. Das ist eine vertretbare Wahl, und die Konsolenzeile ist ihr Preis.
Hör auf zu raten und lies die Liste
Chrome hat ein Panel, das das pro Datei beantwortet, statt dass du Konsolenzeilen zu Bundles passend machst. Developer Resources zeigt eine Status-Spalte, um zu sehen, ob das Laden erfolgreich war oder fehlgeschlagen, und eine Error-Spalte mit der Meldung für jede. Es lässt dich auch eine Map von Hand laden, um zu überprüfen, dass eine Map, die du privat hieltest, sonst richtig ist.
Diese Liste ist der Unterschied zwischen “die Konsole ist voller Source-Map-Fehler” und “drei davon sind von einer Abhängigkeit und eines ist unseres”.
Was zu tun ist, in Reihenfolge
Falls es zu einer Abhängigkeit gehört: nichts. Es ist Rauschen, das dein eigenes Werkzeug über jemand anderes’ Packaging erzeugt. Kein Benutzer ist betroffen und keine Build-Änderung entfernt es.
Falls es dein ist und du arbeitende Maps willst, ship die .map-Datei neben dem Bundle, oder
halten sie privat und lade sie stattdessen in deinen Error-Tracker hoch, wo sie das meiste verdient
und das wenigste offenbart. Ein Stack-Trace gegen minifizierten
Code ist fast unnütz, und
das ist die Datei, die es behebt.
Falls du nur willst, dass die Konsole still ist, die Einstellung ist in DevTools, nicht in deinem Projekt: Settings, dann Preferences, dann Sources, wo Chromes Dokumentation dich zum JavaScript source maps-Ankreuzfeld führt. Es auszuschalten stoppt die Anfragen und die Zeilen mit ihnen.
Der Preis, den niemand zählt
Eine Konsole mit einem Dutzend ständigen Warnungen ist nicht frei, und der Preis ist nicht Performance.
Es ist, dass jeder lernt zu überspringen. Wenn die Konsole immer Rot drin hat, hört Rot auf, ein Signal zu sein, und die eine Zeile, die zählt, kommt in der Mitte von elf, die nicht zählen. Der Fehler über eine nicht definierte Eigenschaft, der den defekten Checkout erklärt, sitzt vier Zeilen unter einer Source-Map-Warnung, die seit März da ist.
Das zählt mehr, wenn jemand anders es ansieht. Ein Screenshot einer Konsole von einem Benutzer, oder ein erfasstes Log, das an einen Bug-Report gehängt ist, kommt mit all das drin, und die Person, die es liest, muss wissen, welche Zeilen permanente Einrichtung sind, bevor sie sehen kann, was neu ist.
Session Replay
Kostenlose Chrome-Erweiterung. Ein Klick auf die Seite, die nicht richtig funktioniert, erfasst den Screenshot, die Konsole und das Netzwerkprotokoll und gibt dir einen Link zum Einfügen in das Ticket.
Zu wissen, welche dieser Zeilen immer da sein werden, ist das meiste, was eine erfasste Konsole lesbar macht.
Die Kurzversion
- Die Anfrage wird von deinen Entwicklertools gestellt, wenn du sie öffnest, nicht von der Seite. Kein Besucher sieht das und nichts ist für sie langsamer.
- Lies die URL in der Meldung zuerst. Ein
node_modules- oder Vendor-Pfad bedeutet, es ist Packaging einer Abhängigkeit, und es gibt nichts in deinem Build zu ändern. - Eine Cross-Origin-Map schlägt in einer Weise fehl, die genau wie eine fehlende aussieht.
- Developer Resources listet den Status und den Fehler pro Datei auf, was das Lesen von Konsolenzeilen schlägt.
- Das Ankreuzfeld, das es stummschaltet, ist eine DevTools-Voreinstellung, nicht eine Projekteinstellung.
- Der eigentliche Preis ist eine Konsole, die niemand mehr sorgfältig liest, einschließlich der Person, an die du es schicktest.