test: validate @see contents (#1231)

1 files changed, 9 insertions, 0 deletions

diff --git a/test/scripts/apidoc/examplesAndDeprecations.spec.ts b/test/scripts/apidoc/examplesAndDeprecations.spec.ts
index 9eb10d39..5709189a 100644
--- a/test/scripts/apidoc/examplesAndDeprecations.spec.ts
+++ b/test/scripts/apidoc/examplesAndDeprecations.spec.ts
@@ -111,6 +111,15 @@ describe('examples and deprecations', () => {
           expect(spy).not.toHaveBeenCalled();
         }
       }
+
+      // Verify @see tag
+      extractTagContent('@see', signature).forEach((link) => {
+        if (link.startsWith('faker')) {
+          // Expected @see faker.xxx.yyy()
+          expect(link, 'Expect method reference to contain ()').toContain('(');
+          expect(link, 'Expect method reference to contain ()').toContain(')');
+        }
+      });
     });
   });
 });