JSON-Patch anwenden
Wende einen JSON-Patch (RFC 6902) auf ein JSON-Dokument an und erhalte das gepatchte Ergebnis. Füge das Dokument und das Patch-Array ein. Jede Operation, von add und remove bis move, copy und test, wird der Reihe nach geprüft und angewendet. Schlägt eine Operation fehl, nennt das Tool die Operation und den Grund.
Häufig gestellte Fragen
Welche Operationen werden unterstützt?
Alle sechs Operationen aus RFC 6902: add, remove, replace, move, copy und test. Pfade und from-Werte sind JSON-Pointer gemäß der Definition in RFC 6901. Ein - am Ende eines Array-Pfads fügt ein Element an.
Was passiert, wenn eine Operation fehlschlägt?
Ein Patch wird ganz oder gar nicht angewendet. Schlägt eine Operation fehl, zum Beispiel weil ein Pfad nicht existiert oder ein Test nicht übereinstimmt, wird kein Ergebnis zurückgegeben und die Meldung nennt die Nummer der fehlgeschlagenen Operation.
Kann ich eine einzelne Operation einfügen?
Ja. Ein einzelnes Operationsobjekt wird als Patch mit einer Operation behandelt. Andernfalls muss der Patch ein JSON-Array mit Operationen sein.
Warum schlägt eine Testoperation fehl?
Eine Testoperation vergleicht den Wert an ihrem Pfad mit dem erwarteten Wert und schlägt fehl, wenn beide voneinander abweichen. Zahlen, Zeichenfolgen, Arrays und Objekte müssen inhaltlich gleich sein; die Reihenfolge der Objektschlüssel spielt keine Rolle.
Warum wird mein __proto__-Pfad abgelehnt?
Pfade, die __proto__, constructor oder prototype ändern würden, werden abgelehnt, da solche Patches eine bekannte Angriffsmethode auf JavaScript-Programme sind. Gewöhnliche Schlüssel sind davon nicht betroffen.
Wird mein ursprüngliches Dokument geändert?
Nein. Der Patch wird auf eine Kopie angewendet, und das Ergebnis wird als formatiertes JSON angezeigt.