Add SelectArray<T> and SelectArrayOrThrow<T> utility methods

JsonHelper.Net.Test/JTokenExtensionsTests.cs

@@ -95,6 +95,25 @@ public async Task SelectListWithStringsTest(string json, string path, params str
         Assert.That(result, Is.EquivalentTo(items));
     }
     /// <summary>
+    ///     Array selection test
+    /// </summary>
+    [TestCase("{\"field\": [\"a\",\"b\",\"c\"]}", "$.field", "a", "b", "c")]
+    public async Task SelectArrayWithStringsTest(string json, string path, params string[] items) {
+        await Console.Out.WriteLineAsync(json);
+        await Console.Out.WriteLineAsync(path);
+        await Console.Out.WriteLineAsync(items.Length.ToString());
+        foreach (var item in items) {
+            await Console.Out.WriteLineAsync(item);
+        }
+        var jtoken = JToken.Parse(json);
+        var result = jtoken.SelectArray<string>(path);
+        Assert.That(result, Is.Not.Null);
+        foreach (var item in result!) {
+            await Console.Out.WriteLineAsync(item);
+        }
+        Assert.That(result, Is.EquivalentTo(items));
+    }
+    /// <summary>
     ///     Date selection test
     /// </summary>
     [TestCase("{\"field\": \"2024-01-05T00:00:00\"}", "$.field", "2024-01-05T00:00:00.0000000")]

JsonHelper.Net.Test/JsonHelperTests.cs

@@ -97,6 +97,25 @@ public async Task SelectListWithStringsTest(string json, string path, params str
         Assert.That(result, Is.EquivalentTo(items));
     }
     /// <summary>
+    ///     Array selection test
+    /// </summary>
+    [TestCase("{\"field\": [\"a\",\"b\",\"c\"]}", "$.field", "a", "b", "c")]
+    public async Task SelectArrayWithStringsTest(string json, string path, params string[] items) {
+        await Console.Out.WriteLineAsync(json);
+        await Console.Out.WriteLineAsync(path);
+        await Console.Out.WriteLineAsync(items.Length.ToString());
+        foreach (var item in items) {
+            await Console.Out.WriteLineAsync(item);
+        }
+        var jtoken = JToken.Parse(json);
+        var result = JsonHelper.SelectArray<string>(jtoken, path);
+        Assert.That(result, Is.Not.Null);
+        foreach (var item in result!) {
+            await Console.Out.WriteLineAsync(item);
+        }
+        Assert.That(result, Is.EquivalentTo(items));
+    }
+    /// <summary>
     ///     Date selection test
     /// </summary>
     [TestCase("{\"field\": \"2024-01-05T00:00:00\"}", "$.field", "2024-01-05T00:00:00.0000000")]

JsonHelper.Net/JTokenExtensions.cs

@@ -142,6 +142,28 @@ public static List<T> SelectListOrThrow<T>(this JToken json, string path) {
         return token;
     }
     /// <summary>
+    ///     Select <see cref="T[]"/>
+    /// </summary>
+    /// <param name="json">Initial json token</param>
+    /// <param name="path">JSON path</param>
+    /// <returns>Resolved <see cref="T[]"/></returns>
+    public static T[]? SelectArray<T>(this JToken json, string path) {
+        return JsonHelper.SelectArray<T>(json, path);
+    }
+    /// <summary>
+    ///     Select <see cref="T[]"/> or throw <see cref="JsonHelperException"/>
+    /// </summary>
+    /// <param name="json">Initial json token</param>
+    /// <param name="path">JSON path</param>
+    /// <returns>Resolved <see cref="T[]"/></returns>
+    public static T[] SelectArrayOrThrow<T>(this JToken json, string path) {
+        var token = SelectArray<T>(json, path);
+        if (token == null) {
+            throw new JsonHelperException("Failed to select JToken: token is null");
+        }
+        return token;
+    }
+    /// <summary>
     ///     Select <see cref="DateTime"/>
     /// </summary>
     /// <param name="json">Initial json token</param>

JsonHelper.Net/JsonHelper.cs

@@ -228,7 +228,33 @@ public static Guid SelectGuidOrThrow(JToken json, string path) {
         return value.Value;
     }
     /// <summary>
-    ///     Select <see cref="DateTime"/> 
+    ///     Select <see cref="T[]"/>
+    /// </summary>
+    /// <param name="json">Initial json token</param>
+    /// <param name="path">JSON path</param>
+    /// <returns>Resolved <see cref="T[]"/></returns>
+    public static T[]? SelectArray<T>(JToken json, string path) {
+        var token = Select(json, path, JTokenType.Array);
+        if (token == null) {
+            return null;
+        }
+        return token.ToObject<T[]>();
+    }
+    /// <summary>
+    ///     Select <see cref="T[]"/> or throw <see cref="JsonHelperException"/>
+    /// </summary>
+    /// <param name="json">Initial json token</param>
+    /// <param name="path">JSON path</param>
+    /// <returns>Resolved <see cref="T[]"/></returns>
+    public static T[] SelectArrayOrThrow<T>(JToken json, string path) {
+        var value = SelectArray<T>(json, path);
+        if (value == null) {
+            throw new JsonHelperException($"Failed to select an array at {path}");
+        }
+        return value;
+    }
+    /// <summary>
+    ///     Select <see cref="DateTime"/>
     /// </summary>
     /// <param name="json">Initial json token</param>
     /// <param name="path">JSON Path</param>