feat: add @nullable (#11)

README.md

@@ -38,6 +38,7 @@ Read this in other languages: [中文](./README.zh-CN.md)
     - [@partial](#partial)
     - [@type](#type)
     - [@optional](#optional)
+    - [@nullable](#nullable)
   - [Run](#run)
     - [Skip](#skip)
     - [Delay](#delay)
@@ -808,6 +809,25 @@ Apitest supports nearly 40 mock functions. For a detailed list, see [fake-js](ht
 }
 ```
 
+### @nullable
+
+**Field maybe null**
+> scope: unit res block
+
+```
+{
+  test1: { @client("echo")
+    req: {
+      v1: null,
+      // v1: 3,
+    },
+    res: {
+      v1: 3, @nullable
+    }
+  }
+}
+```
+
 
 ## Run
 

src/compareRes.ts

@@ -18,6 +18,9 @@ async function compareValue(paths: string[], ctx: VmContext, v1: JsonaValue, v2:
     v2 = evalValue(paths, ctx, transAnno.value, "trans");
     _.set(ctx.state, "$", null);
   }
+
+  if (existAnno(paths, v1, "nullable", "any") && v2 == null) return;
+
   if (existAnno(paths, v1, "eval", "string")) {
     ctx.state.$ = v2;
     const value = evalValue(paths, ctx, (v1 as JsonaString).value);

tests/__snapshots__/res.test.js.snap

@@ -54,6 +54,12 @@ exports[`res every 1`] = `
 "
 `;
 
+exports[`res nullable 1`] = `
+"main
+  @nullable ✔
+"
+`;
+
 exports[`res optional 1`] = `
 "not found main jsona file
 "

tests/fixtures/res/nullable.jsona

@@ -0,0 +1,11 @@
+{
+  @client({name:"default",kind:"echo"})
+  test1: { @describe("@nullable") 
+    req: {
+      v1: null,
+    },
+    res: {
+      v1: 3, @nullable
+    }
+  },
+}

tests/res.test.js

@@ -40,4 +40,9 @@ describe("res", () => {
     expect(code).toEqual(1);
     expect(stdout).toMatchSnapshot();
   });
+  test("nullable", async () => {
+    const { stdout, code } = await spwanTest("res/nullable.jsona", ["--ci"]);
+    expect(code).toEqual(0);
+    expect(stdout).toMatchSnapshot();
+  });
 });