Meziantou.Framework.JsonPath
2.0.1
Prefix Reserved
dotnet add package Meziantou.Framework.JsonPath --version 2.0.1
NuGet\Install-Package Meziantou.Framework.JsonPath -Version 2.0.1
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Meziantou.Framework.JsonPath" Version="2.0.1" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Meziantou.Framework.JsonPath" Version="2.0.1" />
<PackageReference Include="Meziantou.Framework.JsonPath" />
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add Meziantou.Framework.JsonPath --version 2.0.1
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
#r "nuget: Meziantou.Framework.JsonPath, 2.0.1"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package Meziantou.Framework.JsonPath@2.0.1
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=Meziantou.Framework.JsonPath&version=2.0.1
#tool nuget:?package=Meziantou.Framework.JsonPath&version=2.0.1
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
Meziantou.Framework.JsonPath
An implementation of JSONPath (RFC 9535) for System.Text.Json.
Usage
using System.Text.Json.Nodes;
using Meziantou.Framework;
var document = JsonNode.Parse("""{"store":{"book":[{"title":"A"},{"title":"B"}]}}""");
// Parse a JSONPath expression (can be reused)
var path = JsonPath.Parse("$.store.book[*].title");
// Evaluate against a document
var result = path.Evaluate(document);
foreach (var match in result)
{
Console.WriteLine($"{match.Path}: {match.Value}");
// $['store']['book'][0]['title']: A
// $['store']['book'][1]['title']: B
}
Evaluation modes
Evaluate supports two modes:
JsonPathEvaluationMode.Lax(default): path evaluation errors produce no match.JsonPathEvaluationMode.Strict: path evaluation errors throwJsonPathEvaluationException.
var doc = JsonNode.Parse("""{"a": 1}""");
var path = JsonPath.Parse("$.name");
var laxValue = path.EvaluateValue(doc, JsonPathEvaluationMode.Lax); // null
var strictValue = path.EvaluateValue(doc, JsonPathEvaluationMode.Strict); // throws JsonPathEvaluationException
Supported Features
Full RFC 9535 compliance:
- Selectors: name (
.name,['name']), wildcard (*), index ([0],[-1]), slice ([0:3:1]), filter ([?@.price < 10]) - Segments: child and descendant (
..) - Filter expressions: comparisons (
==,!=,<,<=,>,>=), logical operators (&&,||,!), existence tests, parenthesized grouping - Built-in functions:
length(),count(),match(),search(),value() - Normalized paths: canonical path output per RFC 9535 §2.7
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. net9.0 is compatible. net9.0-android was computed. net9.0-browser was computed. net9.0-ios was computed. net9.0-maccatalyst was computed. net9.0-macos was computed. net9.0-tvos was computed. net9.0-windows was computed. net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
-
net10.0
- No dependencies.
-
net8.0
- No dependencies.
-
net9.0
- No dependencies.
NuGet packages (2)
Showing the top 2 NuGet packages that depend on Meziantou.Framework.JsonPath:
| Package | Downloads |
|---|---|
|
Meziantou.Framework.InlineSnapshotTesting
Enables verification of objects using inline snapshots |
|
|
Meziantou.Framework.TdsServer
A TDS server library for SQL Server protocol connections with query response serialization and ASP.NET Core hosting integration |
GitHub repositories
This package is not used by any popular GitHub repositories.