JSON in URL-Abfrage

Was die Umwandlung ändert

Schreiben Sie ein flaches JSON-Objekt als URL-Abfrageparameter. Fügt skalare Felder und Array-Elemente mit URLSearchParams hinzu.

Beispiel mit Eingabe und Ausgabe

Beginnen Sie mit der Eingabe auf dieser Seite: {"name":"Hallo","nachricht":["Willkommen","Hallo"]}. Das Werkzeug erzeugt: name=Hallo&nachricht=Willkommen&nachricht=Hallo. Testen Sie zuerst das Beispiel, um beide Darstellungen zu vergleichen. Ersetzen Sie es danach durch eigene Daten. Das Ergebnis ist Text für Editor, Testfall oder Anfrage, sobald Sie geprüft haben, ob das Ziel genau diese Form erwartet.

Formatregeln und Grenzen

Eine Abfragezeichenfolge enthält benannte Parameter hinter dem Fragezeichen einer URL. Dieses Werkzeug akzeptiert ein führendes Fragezeichen, liest aber keine vollständige URL. Es folgt den Formularregeln von URLSearchParams: Plus wird zu Leerzeichen, Prozent-Escapes stehen für UTF-8-Bytes, und wiederholte Schlüssel werden beim Lesen als Arrays gespeichert. Beim Schreiben sind flache JSON-Objekte mit Strings, Zahlen, Wahrheitswerten oder nichtleeren Arrays dieser Skalare möglich. In der Abfrage ist alles Text: Eine JSON-Zahl kommt beim Rückweg als String zurück, daher bleiben JSON-Typen nicht erhalten. Null, verschachtelte Objekte und leere Arrays haben keine eindeutige Darstellung und werden abgewiesen. Ein kodiertes Ampersand gehört zum Wert; ein wörtliches trennt Parameter. Dekodieren Sie erst nach dem Erkennen der Trennzeichen und vermeiden Sie doppelte Kodierung.

Ergebnis prüfen

Lassen Sie das Original beim Prüfen neben dem umgewandelten Text stehen. Vergleichen Sie zuerst einen kleinen bekannten Fall, möglichst mit Satzzeichen, einem Nicht-ASCII-Zeichen, einem wiederholten Wert oder einem relevanten leeren Feld. Lesbare Ausgabe beweist nicht, dass das Zielprogramm dasselbe Schema oder dieselben Konventionen akzeptiert. Beim Austausch zwischen Anwendungen sollten Sie den Zielparser ausführen und nach dem Import einige Datensätze kontrollieren. Wichtige Quelldateien gehören unter Versionskontrolle, damit Änderungen umkehrbar bleiben. Die Verarbeitung findet in Ihrem Browser statt; diese Seite sendet eingefügten Inhalt nicht an einen Konvertierungsserver. Browser-Speicher und Zwischenablage erfordern auf gemeinsam genutzten Geräten dennoch normale Vorsicht.

Quelle und Ergebnis erfüllen verschiedene Zwecke, auch wenn sie ähnlich aussehen. Die obige Methode beschreibt die unterstützte Teilmenge und nicht jede Erweiterung des Formats. Testen Sie bei einem strengen Zielsystem zuerst einen kleinen bekannten Fall, bevor Sie viele Datensätze ändern. Nach einem Validierungsfehler prüfen Sie Quelle und erste gemeldete Stelle; eine Korrektur nur der Ausgabe kann die Ursache verdecken.

Testen Sie Parameter mit Leerzeichen, Ampersand und einem Nicht-ASCII-Zeichen im Wert. Lesen Sie die erzeugte Zeichenfolge erneut und prüfen Sie, ob wiederholte Schlüssel Arrays bleiben. Vergleichen Sie Textwerte und keine JSON-Zahlen- oder Wahrheitswerttypen, die Abfragen nicht erhalten können. Für eine ganze URL hängen Sie die Abfrage an den Pfad, statt eine vollständige URL in dieses Eingabefeld einzufügen.