Zum Inhalt springen

Source-Map-Auflöser

Source Map Resolver

Bildet einen minimierten Stacktrace mit einer von Ihnen gelieferten Source Map auf die ursprünglichen Dateien und Zeilen ab.

Nimmt einen Stacktrace aus einem minimierten Bundle und eine `.map`-Datei und sagt Ihnen, aus welcher Zeile welcher Originalquelle jeder Frame stammt. Alles wird im Tab dekodiert – weder die Map noch der Trace, der oft Ihre internen Pfade nennt, geht irgendwohin.

🔒 Läuft vollständig in Ihrem Browsersourcemapdebugstacktracejavascript

Source Map (.map)

Eine .map-Datei ablegen

Wird in diesem Tab gelesen. Es wird nichts hochgeladen.

Minifizierter Stacktrace

Source Map v3, in diesem Tab dekodiert: base64-VLQ-Mappings, die Suche nach der größten Spalte davor wie in den Devtools, und ursprüngliche Namen, aus der Tabelle names wiederhergestellt. Ursprünglicher Quelltext erscheint nur, wenn die Map sourcesContent einbettet — eine Map ohne das kennt Positionen, keinen Code. Frame-Zeilen, die sich nicht lesen lassen, gehen unverändert durch.

So funktioniert es

  1. Besorgen Sie die Map

    Entweder die `.map`-Datei selbst oder den `data:`-URI aus einem `sourceMappingURL`-Kommentar am Ende des Bundles. Beides lässt sich hier einfügen.

  2. Fügen Sie den Stacktrace ein

    Direkt aus einem Fehlerbericht – das Ganze, `Error:`-Zeile eingeschlossen. Frames, die nicht parsen, werden unverändert durchgereicht, statt zu verschwinden.

  3. Lesen Sie die ursprünglichen Positionen

    Jeder Frame bekommt seine Quelldatei, Zeile, Spalte und – wo die `names`-Tabelle der Map ihn hat – den ursprünglichen Funktionsnamen. Kopieren Sie den ganzen zurückgerechneten Trace mit einer Schaltfläche.

Häufige Fragen

Warum wird keine Quellzeile angezeigt?

Weil die Map kein `sourcesContent` einbettet. Eine Map ohne es weiß, wo die Dinge waren, nicht, was dort geschrieben stand – die Angabe unter der Map sagt, ob Ihre es hat. Bauen Sie mit `sourcemap: true` statt einer Nur-Pfade-Einstellung, wenn Sie den Code wollen.

Ein Frame sagt „keine Zuordnung an dieser Position“.

Die Spalte in diesem Frame liegt außerhalb jedes Mapping-Segments. Meist heißt das, die Map gehört zu einem anderen Build der Datei als dem, der geworfen hat – ein Deployment, das neuen Code mit einer alten Map ausgeliefert hat, oder ein CDN, das ein gecachtes Bundle ausliefert.

Ist es sicher, eine Produktions-Source-Map hier einzufügen?

Nichts verlässt den Tab – das VLQ-Dekodieren und das Nachschlagen geschehen in Ihrem Browser. Es lohnt sich zu bedenken, dass eine Map mit `sourcesContent` Ihren gesamten Originalquellcode enthält, sodass es im Allgemeinen darauf ankommt, wo Sie sie einfügen, auch wenn es hier nicht darauf ankommt.

Welche Source-Map-Version liest es?

v3, die einzige, die irgendjemand ausgibt. Index-Maps – die `sections`-Form für sehr große Bundles – werden nicht unterstützt; geben Sie stattdessen die Abschnitts-Map ein, die Ihren Frame abdeckt.

Eingabe aus

Danach

Diese Tools nehmen an, was dieses hier erzeugt, das Ergebnis kann also direkt weiter.