Skip to content

Main content

JSON Merge Patch Null Delete Marker Tool

Classify a merge-patch member value; null means deletion only in an object-member patch context.

Loading tool…

Description

Parse patchJson.

JSON Patch describes operations at pointer locations, and operation context determines whether a location is usable. Array append tokens, root targets, and scalar equality have narrow semantics.

Parse patchJson.

When to use this tool

Use JSON Merge Patch Null Delete Marker when you need one explicit patch-context check.

How to use the tool and how it works

  1. Enter patchJson. Use the units and conventions below.
  2. Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
  3. Read deleteMember, objectPatch. Inspect deleteMember, objectPatch before interpreting the associated values.

Parse patchJson. Mark deleteMember for literal null and objectPatch for a nonnull nonarray object.1

A null member in an object merge patch requests deletion of that member. A nonobject patch instead replaces the target as a whole, so a top-level null and a null object member have different effects.2

Input fieldMeaning and unitsAccepted input
patchJsonPatch JsonRequired. Text; maximum UTF-16 length 8192.
Output fieldInterpretationReturned shape
deleteMemberWhether the patch is literal null; deletion interpretation requires object-member context.Required. Boolean.
objectPatchObject PatchRequired. Boolean.
json
{
  "input": {
    "patchJson": "null"
  },
  "output": {
    "deleteMember": true,
    "objectPatch": false
  }
}

Limitations and assumptions

  • Null deletes a member only in an object merge-patch context; a root null patch replaces the document, and no patch is applied here.
  • Inputs must satisfy both the field types and the cross-field conditions above. Invalid input causes an error; a successful false flag or documented placeholder is a different result.

Alternative or Complementary methods

Validate and apply the full patch transaction against the actual document using a conforming implementation.

References

  1. Calculation and input contract: json/json-merge-patch-null-delete-marker — tool.io

  2. JSON Merge Patch (RFC 7396) — RFC Editor / IETF

Similar or alternative tools