Zum Inhalt springen
Aback Tools Logo

Quellkartengenerator

Generieren Sie Source Map v3-Dateien aus Ihrer ursprünglichen JavaScript-Quelle und ihrer minimierten oder verschleierten Version. Das Tool tokenisiert beide Eingaben, richtet übereinstimmende Token aus, um genaue Positionszuordnungen zu erstellen, und codiert sie mithilfe von Base64-VLQ für eine gültige Quellzuordnungs-JSON. Beinhaltet Identifier-Tracking, optionale Einbettung von Quellinhalten, Mapping-Vorschautabelle und Roh-JSON-Viewer. Die gesamte Verarbeitung erfolgt lokal und privat.

Source Map Generator
Generate Source Map v3 files from original and minified JavaScript code. Enter your beautified source and its minified/obfuscated version to create VLQ-encoded mappings that map positions back to the original code.
67
Mappings
28
Identifiers
1
Source Files
1.6 KB
JSON Size
Source Map Structure
Version:
3
Output file:
bundle.js
Sources:
[src/index.js]
Names:
[28 names]
sourcesContent:
Included
Mappings length:
389 chars
21 original lines → 1 generated line28 identifiers tracked

Warum unseren Quellkartengenerator verwenden?

  • Generierung von Source Map v3: Generieren Sie Standard-Source Map v3-Dateien aus Ihrem ursprünglichen und minimierten JavaScript-Code. Erzeugt gültige VLQ-codierte Zuordnungen, Quelldateiverweise, Namensarrays und optionalen Quellinhalt für eine vollständige Quellrekonstruktion. Kompatibel mit Browsern, Bundlern und Debugging-Tools.
  • 100 % browserlokale Verarbeitung: Die gesamte Generierung der Quellkarten erfolgt vollständig in Ihrem Browser. Ihr ursprünglicher Quellcode und das minimierte JavaScript verlassen niemals Ihr Gerät. Keine Uploads auf einen Server, keine Anmeldung erforderlich und keine Nutzungsbeschränkungen. Für immer völlig kostenlos.
  • Detaillierte Mapping-Vorschau: Sehen Sie sich eine vollständige Mapping-Tabelle an, die jede generierte Position und die entsprechende Originaldatei, -zeile und -spalte zeigt. Erkunden Sie die JSON-Rohquellkarte, überprüfen Sie die dekodierten VLQ-Segmente und überprüfen Sie die Zuordnungsgenauigkeit, bevor Sie sie herunterladen oder kopieren.
  • Sofortige Generierung mit Statistiken: Quellkarten werden in Echtzeit generiert, während Sie Code eingeben oder einfügen. Sehen Sie sofort, wie viele Zuordnungen erstellt wurden, wie groß die Quellzuordnungsdatei ist, wie hoch das Komprimierungsverhältnis ist und wie viele Quelldateien und benannte Bezeichner vorhanden sind. Kopieren oder laden Sie die generierte .map-Datei mit einem Klick herunter.

Häufige Anwendungsfälle für den Quellkartengenerator

  • Debuggen von verschleiertem Produktionscode: Generieren Sie Quellzuordnungen für Ihre verschleierten JavaScript-Bundles, damit Sie Produktionsprobleme mit Originalvariablennamen, Dateistruktur und Kommentaren debuggen können. Verbinden Sie die Quellkarte mit Ihrem Fehlerüberwachungstool (Sentry, Datadog, New Relic), um lesbare Stack-Traces von minimierten Produktionsfehlern zu erhalten.
  • Integration der Verschleierungspipeline: Wenn Sie JS-Verschleierung (Variablenumbenennung, String-Codierung, Reduzierung des Kontrollflusses) als Teil Ihrer Build-Pipeline anwenden, generieren Sie Quellzuordnungen, die die verschleierte Ausgabe wieder dem vorverschleierten Code zuordnen. Dies ermöglicht das Debuggen mit lesbarem Code beim Versand von geschütztem JavaScript.
  • Browser-DevTools-Debugging: Hängen Sie generierte Quellkarten an Ihre bereitgestellten JavaScript-Bundles an, damit Chrome DevTools, Firefox Developer Tools und Safari Web Inspector den Originalquellcode im Quellenfenster anzeigen können. Legen Sie Haltepunkte fest, überprüfen Sie Variablen und gehen Sie Ihren Originalcode schrittweise durch, selbst wenn der Browser minimiertes JavaScript ausführt.
  • CI/CD-Quellkartenartefakte: Generieren Sie Quellkarten während Ihrer CI/CD-Pipeline und laden Sie sie in Ihren Fehlerverfolgungsdienst hoch, ohne sie Endbenutzern zugänglich zu machen. Das Tool hilft Ihnen, das Quellkartenformat zu verstehen und Ihre Generierungspipeline zu testen, bevor Sie es in Ihre Build-Tools integrieren.
  • Bildung und Forschung im Source Map-Format: Verstehen Sie, wie Source Map v3 funktioniert, indem Sie VLQ-codierte Zuordnungen sehen, die in Echtzeit aus Ihrem eigenen Code generiert werden. Das Tool eignet sich hervorragend zum Erlernen des Quellkartenformats, der VLQ-Kodierung, der Zeilen-/Spaltenzuordnungen und der Art und Weise, wie Namen und Quellen referenziert werden.
  • Manuelle Stack-Trace-Entschleierung: Wenn Sie über einen verschleierten/minimierten Produktions-Stack-Trace verfügen, aber Ihre Quellzuordnungen verloren haben, rekonstruieren Sie die Zuordnung manuell, indem Sie Ihren ursprünglichen und minimierten Code einfügen. Die generierte Quellkarte kann mit dem Source Map Unminifier verwendet werden, um die genauen ursprünglichen Codepositionen wiederherzustellen.

Was ist eine Quellkarte?

Eine Quellzuordnung ist eine Datei, die transformierten, minimierten oder verschleierten Code wieder seiner ursprünglichen Quelle zuordnet. Das Source Map v3-Format verwendet die Base64-VLQ-Codierung (Variable Length Quantity), um Positionszuordnungen kompakt zu speichern. Jede Zuordnung zeichnet die generierte Zeile/Spalte und die entsprechende Originaldatei, Zeile und Spalte sowie einen optionalen Bezeichnernamen auf. Wenn ein Browser oder Debugger eine Quellzuordnung neben minimiertem Code lädt, kann er den ursprünglichen Quellcode mit korrekten Variablennamen, Dateiorganisation und Kommentaren anzeigen – wodurch das Debuggen von Produktionscode möglich wird.

So funktioniert unser Quellkartengenerator

  1. Originalcode eingeben: Fügen Sie Ihren ursprünglichen, lesbaren JavaScript-Quellcode in das linke Feld ein. Dies ist die Version vor der Minimierung/Verschleierung, aus der Sie eine Zuordnung erstellen möchten.
  2. Geben Sie minimierten/verschleierten Code ein: Fügen Sie Ihren minimierten oder verschleierten JavaScript-Code in das rechte Feld ein. Der Generator vergleicht jede Zeile und jede Zeichenposition, um genaue Zuordnungen zwischen den beiden Versionen zu erstellen.
  3. Quellkartengenerierung: Das Tool generiert eine gültige Quellkarten-v3-JSON-Datei, die VLQ-codierte Zuordnungen, eine Quelldateiliste, ein Namensarray für Bezeichner und optional den vollständigen ursprünglichen Quellinhalt (sourcesContent) für eine vollständige Rekonstruktion enthält. Sie können das JSON kopieren oder als .map-Datei herunterladen.

Details zum Source Map v3-Format

  • Version: Das Quellkartenformat ist derzeit Version 3, definiert durch die Quellkartenspezifikation. Das Versionsfeld ist immer 3 .
  • Zuordnungen: Das Zuordnungsfeld enthält VLQ-codierte Zeichenfolgen, die durch Semikolons (für Zeilenumbrüche) und Kommas (für einzelne Segmente innerhalb einer Zeile) getrennt sind. Jedes Segment kodiert bis zu 5 Werte: generierte Spalte, Quellindex, Originalzeile, Originalspalte und Namensindex – alle werden zur optimalen Komprimierung als relative Offsets gespeichert.
  • Quellen: Ein Array der ursprünglichen Quelldateipfade, auf die in den Zuordnungen durch den Index verwiesen wird. Sie können benutzerdefinierte Quelldateinamen für Ihre Projektstruktur angeben.
  • Namen: Ein Array von Bezeichnernamen (Variablennamen, Funktionsnamen usw.), die sowohl im ursprünglichen als auch im generierten Code vorkommen und in den Zuordnungen durch einen Index referenziert werden.
  • Quelleninhalt: Ein optionales Array, das den vollständigen Originalquellcode für jede Quelldatei enthält. Sofern vorhanden, können Debugger den exakten Originalcode anzeigen, ohne dass Zugriff auf die Originaldateien auf der Festplatte erforderlich ist.
  • VLQ-Kodierung: Base64-VLQ ist eine kompakte Kodierung mit variabler Länge, bei der jedes Zeichen 6 Bits (0-63) darstellt. Das Fortsetzungsbit (Bit 6) signalisiert, ob weitere Zeichen für den gleichen Wert folgen. Das Vorzeichen wird als niedrigstwertiges Bit codiert (1 = negativ, 0 = positiv), was negative Offsets in relativen Zuordnungen ermöglicht.

Datenschutz, Sicherheit und Verfügbarkeit

Ihr JavaScript-Code wird vollständig in Ihrem Browser verarbeitet. Es wird niemals Code auf einen Server hochgeladen, gespeichert, protokolliert oder an Dritte weitergegeben. Das Tool erfordert keine Kontoerstellung, keine Anmeldung und legt keine Codegrößenbeschränkungen fest. Es ist völlig kostenlos, ohne Premium-Stufen, Nutzungsbeschränkungen oder versteckte Gebühren. Sie können es so oft wie nötig zum Generieren von Quellkarten, zum Debuggen oder für Bildungszwecke verwenden.

Häufig gestellte Fragen

Eine Quellzuordnung ist eine Datei, die transformierten, minimierten oder verschleierten JavaScript-Code wieder seiner ursprünglichen Quelle zuordnet. Es ermöglicht Debuggern und Fehlerüberwachungstools, den ursprünglichen Quellcode anzuzeigen, selbst wenn der Browser minimiertes JavaScript ausführt. Das Generieren von Quellkarten ist für das Debuggen von Produktions-JavaScript, die Integration mit Fehlerverfolgungsdiensten wie Sentry und die Aufrechterhaltung der Entwicklerproduktivität bei der Bereitstellung optimierten Codes von entscheidender Bedeutung.

Source Map v3 ist das aktuelle Standardformat für Quellkarten. Es verwendet die Base64-VLQ-Codierung (Variable Length Quantity), um Positionszuordnungen kompakt zu speichern. Das Format umfasst: Version (immer 3), Datei (Ausgabedateiname), Quellen (ursprüngliche Quelldateipfade), Namen (Bezeichnernamen), Zuordnungen (VLQ-codierte Positionsdaten), resourcesContent (optionaler ursprünglicher Quellcode) und sourceRoot (optionales Pfadpräfix). Durch die VLQ-Kodierung kann jedes Zuordnungssegment bis zu 5 Werte (generierte Spalte, Quellindex, Originalzeile, Originalspalte, Namensindex) unter Verwendung relativer Offsets für eine optimale Komprimierung darstellen.

Die VLQ-Kodierung (Variable Length Quantity) stellt Zahlen mithilfe einer variablen Anzahl von Base64-Zeichen dar. Jedes Zeichen kodiert 6 Bits, wobei das 6. Bit (Fortsetzungsbit) angibt, ob der Wert im nächsten Zeichen fortgesetzt wird. Das Vorzeichen wird im niederwertigsten Bit kodiert (0 = positiv, 1 = negativ). Dadurch können kleine Zahlen (die bei Quellkartenpositionsoffsets üblich sind) mit nur 1–2 Zeichen codiert werden, während größere Zahlen mehr Zeichen verwenden können.

Der Generator funktioniert, indem er sowohl den ursprünglichen als auch den minimierten JavaScript-Code tokenisiert und dann die Token nach Inhaltswert ausrichtet, um Positionszuordnungen zu erstellen. Für jedes übereinstimmende Token werden die generierte Zeilen-/Spaltenposition und die entsprechende Originaldatei, Zeile und Spalte aufgezeichnet. Bezeichner (Variablennamen, Funktionsnamen) werden im Namensarray verfolgt. Die Zuordnungen werden mit Base64-VLQ mit relativen Offsets für maximale Komprimierung gemäß der Source Map v3-Spezifikation codiert.

„sourcesContent“ ist ein optionales Feld in der Quellzuordnung, das den vollständigen Originalquellcode für jede referenzierte Datei einbettet. Wenn Debugger und Entschleierungstools enthalten sind, können sie den genauen Originalcode anzeigen, ohne dass Zugriff auf die Originaldateien auf der Festplatte oder eine Netzwerkverbindung erforderlich ist. Der Nachteil besteht darin, dass dadurch die Größe der Quellkartendatei zunimmt, da die Originalquelle inline eingebettet ist.

Ja. Generierte Quellkarten sind vollständig kompatibel mit Chrome DevTools, Firefox Developer Tools und Safari Web Inspector. Um eine Quellkarte zu verwenden, platzieren Sie die .map-Datei neben Ihrer JavaScript-Datei (z. B. script.js und script.js.map), fügen Sie einen //# sourceMappingURL=script.js.map-Kommentar am Ende Ihrer JavaScript-Datei hinzu oder betten Sie die Quellkarte als Daten-URL ein.

Der Generator erledigt dies automatisch. Quellkarten dienen dazu, Code abzubilden, der möglicherweise völlig unterschiedliche Linienstrukturen aufweist. Der Generator erstellt Zuordnungen für jedes übereinstimmende Token und zeichnet die genaue ursprüngliche Zeile/Spalte für jede generierte Position auf. Zeilen ohne entsprechende Originalzuordnung haben einfach keinen Zuordnungseintrag, der laut Spezifikation gültig ist.

Absolut. Die gesamte Quellkartengenerierung erfolgt vollständig in Ihrem Browser. Ihr ursprünglicher Quellcode und das minimierte JavaScript verlassen niemals Ihr Gerät und werden niemals an einen Server gesendet. Es ist kein Konto erforderlich, es werden keine Daten gespeichert und es findet kein Tracking statt. Dies macht das Tool sicher für die Generierung von Quellkarten für proprietären JavaScript-Code, kommerzielle Anwendungen oder sicherheitsrelevante Projekte.

Bundler wie Webpack, Rollup, Vite und ESBuild generieren während des Build-Prozesses automatisch Quellkarten. Dieses Tool ist für Fälle konzipiert, in denen Sie eine Quellzuordnung separat generieren müssen – zum Beispiel, wenn Sie Ihre ursprünglichen Quellzuordnungen verloren haben, wenn Sie eine benutzerdefinierte Verschleierung haben, die Ihr Bundler nicht unterstützt, wenn Sie das Quellzuordnungsformat verstehen möchten oder wenn Sie eine Quellzuordnung für manuell minimierte oder verkettete Skripte erstellen müssen.

Ja, 100 % kostenlos. Es gibt keine Anmeldung, keine Premium-Stufe, keine Nutzungsbeschränkungen und keine Codegrößenbeschränkungen. Das Tool läuft vollständig in Ihrem Browser und kann jederzeit kostenlos auf Aback Tools verwendet werden.