remove
Remove values from a collection.
This method chains a remove operation to the patch, which removes one or more values from a collection.
If the path does not exist or the target values are not present, the operation succeeds without any effect.
Atomicity
If the value at the specified path is not a list, the operation fails and the entire patch is discarded.
Signature
This method has the following signature:
patch.remove(path: string, value: JsonValue): Patch
The return is the Patch instance itself to allow operation chaining.
Example
Here is a basic example of how to use this method:
path.remove('interests', 'data science');
The following table shows how the operation behaves in different scenarios:
Current value | Given value | Result |
---|---|---|
['a', 'b', 'c'] | 'a' | ['b', 'c'] |
['a', 'b', 'c', 'c'] | 'c' | ['a', 'b'] |
['a', 'b', 'c'] | 'd' | ['a', 'b', 'c'] |
['a', {b: 1}, 'c'] | {b: 1} | ['a', 'c'] |
Parameters
The following list describes the supported parameters: